一、功能结论

• 当前可用Skill Hub 已具备从账号登录、skill 提交、导入预览、风险扫描、审核发布、仓库维护、包下载、安装脚本、版本回滚到审计导出的完整闭环。
• 测试口径已实现模块以 `tests/mvp_gate.py` 覆盖为准；该脚本验证账号、权限、提交、审核、发布、私有可见性、安装、回滚、软删除、公告、指标和审计。
• 适用阶段当前适合内网灰度和团队试运行。它不是只读目录页，已经是带治理、权限和审计的 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 导出。

十、功能缺口

十一、后续优先级

1. 先把生产安全补齐：真实域名 TLS、Cookie secure、外层 CSP/HSTS、访问日志、备份恢复演练。
2. 再接真实 SSO：确认 issuer、client、redirect URI、允许邮箱域、默认角色和离职禁用策略。
3. 补通知闭环：审核通过、审核拒绝、发布、回滚、维护者邀请和高风险扫描结果需要主动通知。
4. 增强安全审核：在现有静态扫描外增加沙箱验证、依赖清单、风险评分和人工复核策略。
5. 增强运营看板：按时间维度展示安装、审核、提交、风险、热门 skill 和维护者活跃度。
6. 文档平台化：把当前静态文档拆成可维护的数据源，支持搜索、版本、权限和多页面归档。