用途
该技能用于创建、验证、刷新和扩展仓库技能(repo skill)。适用场景为:所需仓库尚未收录在 1000 个技能库中,或已有技能与上游代码出现偏差。
产出物是一个自包含的技能图(SKILL.md + sub-skills/ + references/ + scripts/),已通过验证,并附带位于运行时目录之外的审查产物。
模式边界
- Researcher(默认):可见 operating + shared 技能,包括未声明 metadata.disco-role 的用户技能,任务是用操作知识做研究工作。
- Creator:可见 metadata.disco-role: meta + shared,任务是制造和维护技能。
Creator 拥有 15 个 meta 技能(cli/packages/coding-agent/src/disco/skills/ 下声明 disco-role: meta 的 15 个目录)。另外两个目录中,repo-skills-router 属于 operating,workflow-authoring 属于 shared。
打开 Creator:
disco --creator # 交互
disco --creator -p "<要求>" # 一次执行后退出
标准入口
在不确定选择哪条路径时使用:
disco --creator -p "/skill:distill-ml-knowledge identify <source or task anchor>; scope, ground, construct, and verify the operating skill graph."
distill-ml-knowledge 先确定 anchor,再驱动四个阶段:scope → ground → construct → verify。来源是仓库时通常复用 create-repo-skill;来源是论文时走论文路径。只有在有证据表明存在重复出现的能力缺口时,才转向 design-meta-skill。
创建仓库技能
disco --creator -p "/skill:create-repo-skill Create and verify a repository skill for /absolute/path/to/repo."
简化形式(Creator 自行选择入口):
disco --creator -p "Create a repo skill for /path/to/repo."
disco --creator -p "Create a skill for /path/to/repo using Python /path/to/env/bin/python"
连同提取范围选择和验证通过后导入技能库一并授权(仅在你确实想跳过这两道审批时添加):
disco --creator -p "Create a repo skill for /path/to/repo with auto decide and auto import."
工作流执行内容:分析仓库结构 → 准备/检查 Python inspection 环境(通过 prepare-repo-skill-env)→ 编写运行时 guidance → 记录 provenance → 交给 verify-repo-skill。
verify-repo-skill 的把关内容
- 生成带 assertion 的 usability case;
- 在内容层面自我精炼(self-refinement);
- 若仓库有原生 example/test,则安全运行;
- 静态质量门;
- 记录 artifact coverage + review。
全部通过后才视为 "ready"。审查产物不在技能运行时目录树内。
刷新(Refresh)——上游已变更时
disco --creator -p "/skill:refresh-repo-skill Refresh /absolute/path/to/existing-skill against the current repository at /absolute/path/to/repo."
简写形式:
disco --creator -p "Refresh the skill at /path/to/repo/skills/example-skill against the current /path/to/repo code."
Refresh 保留仍然正确的 guidance,只将已过时的部分与当前来源基线进行比对。
扩展(Extend)——技能仍正确但覆盖不足时
disco --creator -p "/skill:extend-repo-skill Add streaming inference coverage to /absolute/path/to/existing-skill using /absolute/path/to/repo as evidence."
区分:refresh = 内容已偏离上游;extend = 内容正确但尚未覆盖新工作流。
验证后部署位置
Creator 先建议一个 scope,经你批准后再导入:
- 绑定到具体 task/project/dataset/evaluator/机器,或复用性不确定 →
<project-dir>/.agents/skills/(仅在项目被 trust 时加载)。 - 自包含、有 provenance、已跨项目验证 → 才建议
~/.disco/agent/skills/。
一个技能图不拆分到两个 scope。
仓库技能走专用导入路径 ~/.disco/agent/skills/repositories/repo-skills/,并重建兄弟 router——不通过通用图 importer 推送 routing metadata。
最后 Creator 为新的 Researcher 会话写一份 handoff。
15 个 meta 技能目录
手动调用(入口点):distill-ml-knowledge、create-repo-skill、refresh-repo-skill、extend-repo-skill、import-repo-skills-to-agent、create-paper-skills、design-meta-skill。
由工作流自动加载——不要按清单手动调用:prepare-repo-skill-env、verify-repo-skill、paper-skills-distiller、plan-paper-skill-modules、create-paper-module-skill、prepare-paper-recovery-env、recover-paper-result、analyze-paper-recovery。
限制
资料未提供该技能的收费、价格、平台支持范围、效果指标等具体信息。