一、功能结论

• 当前可用Skill Hub 已具备从账号登录、skill 提交、导入预览、增强风险扫描、审核发布、仓库维护、包下载、安装脚本、版本回滚、通知协作到审计导出的完整闭环。
• 测试口径已实现模块以 `tests/mvp_gate.py` 和 `tests/production_gate.py` 覆盖为准；当前验证账号、权限、提交、审核、发布、私有可见性、安装、回滚、软删除、公告、指标、通知、安全头、备份恢复 dry-run 和审计。
• 适用阶段当前适合内网灰度、团队试运行和生产上线前预检。它不是只读目录页，已经是带治理、权限、通知和审计的 skill 发布平台。
• 明确缺口除真实组织 SSO 外，外部通知、深度安全审核、生产运维、运营分析和文档系统化已打通到可验证闭环；后续重点是接入真实身份源与生产环境配置。

二、已实现并测试的模块

三、主流程能力

1. 发现：用户可进入技能库和仓库视图，查看公开 skill、详情、维护者、风险等级、权限声明、安装命令和下载入口。
2. 提交：登录用户可提交自己的 skill，填写 owner、名称、版本、分类、维护者、权限声明、用途和来源地址。
3. 导入预览：系统可解析 URL 或可信本地目录，提取多个 `SKILL.md`，返回摘要、sha256、冲突状态和风险提示。
4. 审核：reviewer/admin 可在审核队列处理提交，记录 checklist 和备注，决定通过、拒绝或标记验证。
5. 发布：通过审核后写入正式 skill，公开 skill 对访客可见，私有 skill 只对有权限用户可见。
6. 维护：管理员和授权维护者可更新仓库文件、调整 skill 状态、管理维护者和追溯版本。
7. 分发：用户可下载 package 或执行 install.sh，安装脚本会校验 checksum 后落盘 `SKILL.md`。
8. 治理：管理员可查看用户、公告、指标、审计事件，支持筛选和 CSV 导出。

四、账号权限

• 已测注册、登录、登出、`/api/auth/me`、profile 更新、头像上传、错误密码失败、CSRF 拦截、角色接口和 reviewer/admin 权限边界。
• 已预留OIDC SSO 配置接口和 start/callback 路径已存在，但真实组织身份源还未完成生产接入。
• 页面显隐管理入口应只对 admin 显示；访客、普通用户和 reviewer 不应看到管理入口。

五、仓库维护

1. 仓库列表聚合 owner、简介、头像、skill 数量、公开状态、README、文件树和当前公开 skill。
2. 用户注册后会出现自己的 owner 仓库，即使还没有公开 skill，也能在授权场景下被识别。
3. 仓库文件 API 支持读取 `README.md` 和 skill 文件；维护者可更新被授权仓库内的 `SKILL.md`。
4. 管理员可给仓库添加维护者，维护者随后可执行文件更新，更新内容会重新扫描并记录审计事件。
5. 私有 skill 不进入公开仓库列表；有权限用户可查看私有详情，访客不可见。

六、管理审计

七、安装分发

• 详情页分发skill 详情返回 downloadUrl、installUrl 和安装命令；测试确认命令不带 localhost/127.0.0.1 硬编码。
• Package下载接口返回包含 `SKILL.md` 的 package payload，并带 fullName、version、files 和 checksum。
• install.sh安装脚本会下载 package、校验 checksum，把文件写入目标 skills 目录；MVP gate 已执行真实安装并验证文件内容。
• 计数下载会增加 installs，收藏接口会增加 stars，仓库列表能反映最新统计。
• 状态治理review、published、archived、soft delete 的可见性和恢复路径已测试，回滚会基于历史版本恢复 payload。

八、数据与 API

九、测试证据

1. `tests/mvp_gate.py` 是当前功能完成度的主验收脚本，覆盖完整业务闭环。
2. 账号侧覆盖 signup、login、logout、me、profile、avatar、错误密码和角色边界。
3. 提交侧覆盖普通提交、越权提交拒绝、危险内容拒绝、本地导入预览、冲突识别和 CSRF 拦截。
4. 审核侧覆盖审核队列、approve、reject、verify、checklist、发布、私有可见性和审核记录。
5. 仓库侧覆盖仓库列表、README/文件读取、维护者授权、维护者编辑和扫描更新。
6. 分发侧覆盖 package 下载、install.sh 生成、checksum 校验、真实安装、安装计数和收藏计数。
7. 治理侧覆盖状态调整、归档、恢复、回滚、软删除、公告、指标、审计筛选和 CSV 导出。
8. `tests/production_gate.py` 覆盖生产安全头、Secure Cookie/HSTS、生产门禁指标、外部通知出口、增强扫描、SBOM、签名包、运营指标、文档 API 和备份恢复 dry-run。
9. 备份侧覆盖 `scripts/backup.sh --dry-run` 和 `scripts/restore.sh --dry-run`，用于上线前恢复演练预检。

十、功能缺口

十一、后续优先级

1. 先接真实 SSO：确认 issuer、client、redirect URI、允许邮箱域、默认角色和离职禁用策略。
2. 落地生产入口：接真实域名 TLS、反向代理、日志后端和密钥管理服务。
3. 替换通知适配器：把 webhook 文件出口换成邮件或企业 IM 发送器，并配置生产失败重试。
4. 增强沙箱运行时：在现有深度扫描和签名包门禁外，增加隔离执行环境。
5. 扩展运营看板：在现有指标 API 上增加时间维度趋势图。
6. 文档平台化：把当前结构化文档 API 接入 Markdown 存储、搜索、权限和多页面归档。