用途:在当前仓库根目录下管理 yao-open-skills 公开技能集合。它面向收录、治理、同步跟踪与集合维护,不是从零创建新技能的工具。
主要能力:评估本地技能是否适合公开发布;在 skills/<slug>/ 下创建干净的公开副本;在 registry/skills.json 中登记或更新;在 docs/skills/<slug>.md 下补充面向使用者的指南;重新生成 README 目录与 HTML 导航页;记录技能状态为 local-only、staged、published 或 needs-update;用户需要时把集合变更推送到 GitHub。
使用方式:改动集合前先阅读 references/operating-rules.md 与 references/registry-schema.md。给定本地路径后确认路径存在并检查 SKILL.md,识别应保留、移除或重写的内容,同时注意 output/、downloads/、.venv/、node_modules/、缓存、日志、生成报告、本地扫描产物,以及私有 API、令牌、Cookie、内部引用和客户数据。登记时使用 register_skill.py,参数包括 --slug、--title、--summary、--source-local-path、--collection-path、--lifecycle、--sync-status、--github-repo、--github-url、--license、--tags;仅在确实推送后使用 --last-synced-at YYYY-MM-DD。每次改注册表后运行 python3 scripts/render_collection_pages.py,README 与 index.html 是渲染结果,不要手工维护。
适用场景:需要判断某个本地技能能否开源、维护公开集合目录、跟踪同步状态,或在用户要求时把公开仓库更新到一致状态。
限制:无法安全清理的技能应停止发布并说明原因;不得在未实际推送到 GitHub 时将状态标记为 published;若已发布技能的本地源发生变化,应将 sync_status 设为 needs-update;公开副本应自包含,默认排除本地输出产物,除非用户明确要求加入安全样例。