SuperAPI AI 工具集

dym-arex-skill-contributor-dong-gop-skill

编程与开发

查看项目

更新于 10-18 01:21

技能介绍

用途:该技能面向技能库的贡献与维护。它解决两类需求:把新仓库作为技能加入库(目标为 1000 个仓库的集合),或把相对上游已过时的已有技能刷新到最新状态。其产物是 skills/repositories/repo-skills/<skill-id>/ 下的技能运行时目录树、重新生成的 router、更新后的 catalog,以及一个完整声明来源的 PR。

技能目录结构:新技能的必需文件包括 SKILL.md、references/repo-provenance.md 和 references/repo-routing-metadata.json(v2)。当上游存在多个大型工作流区域时,可包含 sub-skills/;当有助于提升安全性时,可包含小的 validate/preflight 脚本,放在 scripts/ 下。routing 元数据 v2 只保留最小信息,包括规范 owner/repository 标识、skill ID、taxonomy hash、routing status 和精确 assignment。分类理由与完整证据不放在运行时目录树内,而放在 routing-decision 产物或仓库的 skills/disco/routing_decision/ handoff 目录中。测试用例、review note、generation report 不属于 skill 运行时目录,除非它们确实是运行时 guidance。

生成方式:使用 Creator,不要手写: disco --creator -p "/skill:create-repo-skill Create and verify a repository skill for /absolute/path/to/repo." 然后由 verify-repo-skill 把关。分类是 verify 之后的独立步骤,需对照固定 taxonomy。若无 family 精确匹配,记 unclassified 并询问用户是否导入;若要纳入,应提议扩展 taxonomy 并等待批准后再修改 canonical taxonomy。分类中断或无法访问时记为 blocked/failed,不得随意猜测路由。

重建 router:不要手改生成出来的 Markdown,应修改生成器后运行: node cli/packages/coding-agent/src/disco/skills/verify-repo-skill/scripts/update_repo_skills_router.mjs
--library-root skills/repositories 脚本支持的参数如下(以脚本内 parseArgs 为准):--library-root <dir> 指定包含 repo-skills/ 与 repo-skills-router/ 的目录,用于在 checkout 中构建;--agent-dir <dir> 指定 agent 根目录,会自动拼接 skills/repositories,不可与 --library-root 同用;--template-dir <dir> 指定模板目录;--include-skill <ids> 用于过滤技能集(可重复或用逗号分隔);--output-router-dir <dir> 将 router 写到别处;--routing-entry <path> 追加 routing entry;--router-visibility <v> 设置 router visibility;--timeout <n> 设置锁超时;-h/--help 打印帮助后以 0 退出。成功输出形如 updated <router-dir>: <n> skills, <n> assignments, <n> areas, <n> families。退出码:成功为 0;RouterError(参数错误、同时使用 --agent-dir 与 --library-root、--already-locked 但缺少 DISCO_IMPORT_LOCK_PATH)为 2;其他未预期错误为 1。传 --agent-dir 时脚本会在锁下重新执行自身(除非已设置 DISCO_IMPORT_LOCK_PATH),这是正常行为。当前数量应匹配:1000 repository、2209 assignment、20 area、178 family(可用 wc -l 对 references/index/repositories.jsonl、assignments.jsonl、repository-index.jsonl 计数核对)。

更新 catalog:docs/imported-repo-skills.md 必须与 repo-routing-metadata.json 和 repo-provenance.md 一致。docs/repository-catalog.md 是共用数据页,修改时需保持 count、grouping、path 以及中文 README 本地化摘要同步。

就地快检:对所有 skill 内 Python 脚本执行 python -m py_compile;用 find 列出全部文件以检查目录树;检查 docs 下 Markdown 不含制表符。

刷新已有技能:执行 discod --creator -p "/skill:refresh-repo-skill Refresh the existing repo skill at /path/to/skill against /path/to/upstream-repository..."。完成后须四方面同步:运行时树(更新所有受影响的公开文件,不只 SKILL.md)、provenance(反映当前仓库状态)、license 元数据(对规范上游仓库在正确源 commit 解析 license:gh api "repos/<owner>/<repo>/license?ref=<source-commit>" --jq '.license.spdx_id // empty')、routing 与 catalog(对比新能力范围与旧 routing 基线,review 产物留在运行时树外)。改进规则:基于证据(source、上游 docs、example 或已检查的包行为);保留仍正确的 guidance;源 commit/版本/证据集变化时更新 provenance;覆盖范围或选择指引变化时更新 routing 元数据;脚本须确定且安全,避免 download、training、启动 server 或删除文件,除非有明确拦截门。

PR 必需信息:每个新增/修改 repo skill 的 PR 须声明上游仓库 URL 与 commit 或 tag、生成所用 model 与 provider、reasoning/thinking 级别、技能由 DisCo 生成/复制工作流/手改、已运行的 verify/review、已知缺口与被跳过的检查、缺失凭证、环境限制,以及 routing 变化时已更新 repo-skills-router/ 的确认。多模型多轮时逐个列出模型及角色(generation/review/refinement/verification)。

最终检查清单:README/docs 链接指向真实文件;EN 与 zh 成对文档同步更新;运行时变更附带 provenance 与来源证据;router 与 catalog 与技能变更一致;PR 声明模型、provider、reasoning 级别、verify 步骤;被改脚本已语法检查或以其他方式验证;结尾摘要说明已验证与未验证内容。

常见陷阱:不要手改 router 生成的 Markdown,应改生成器并重跑 update_repo_skills_router.mjs;不要把 repo routing 元数据走通用 importer graph,repo graph 有专用导入路径;不要猜测 route,unclassified/blocked/failed 是合法结果,错误路由比不路由更有害;每个技能的 license 以其自身 license 为准,而非仓库的 Apache-2.0,须正确写入 SKILL.md 元数据。

限制:资料未提供该技能的具体安装命令、依赖版本、平台支持范围、收费信息或效果保证;分类需对照固定 taxonomy,无法确定时按 unclassified 处理。