用途:把可重复的流程转化为结构良好的 agent skill,也用于重构已超出单个 SKILL.md 的现有技能。技能以纯 markdown 和文件夹组织,可跨任意 agent harness 移植。
主要流程:1)理解流程(steps/understand.md),让用户描述技能对应的流程,并推断任务、输入、产物与原始素材;2)访谈用户(steps/interview.md),与用户共同设计技能,包括描述、名称、输入、自身访谈、真实示例与步骤计划,全程采用“先建议再确认”;3)设计形态(steps/design.md),按约定选择简单或结构化;4)构建(steps/build.md),按约定清单写出文件;5)保存(steps/save.md),询问技能存放位置,如本仓库的 .agents/skills/、全局 ~/.agents/skills/ 或 .claude 备选;6)验证与交接(steps/verify.md),从保存位置运行,并教用户改进循环。
硬性规则:每次调用多步技能时,先给出简短编号流程概览,每项一句话,然后立即开始第一步,不询问许可也不暂停。技能说明为纯 markdown,SKILL.md 及所有说明文件(steps、phases、shared、参考文档)均为 .md,不使用需 harness 解释的格式;捆绑的 scripts/ 与参考资料可为任务所需任意格式(如 Python 脚本、JSON schema、模板文件)。技能核心不得含 harness 专属内容,必须随处可用。从流程允许的最简形态开始,结构(steps/、phases/、shared/)须由真实复杂度赢得,不得预先添加。顺序只存在于编排器中,SKILL.md 或阶段文件承载编号并指向各步骤文件;步骤文件按主题命名、与顺序无关,不说明自身在序列中的位置。删除即彻底移除,删除或反转技能内容时,须删除该项及其所有引用,如同从未存在,不得保留“不要做 X”的替代、变更说明、旧版回退或残留示例;技能只描述当前流程。完整约定见 reference/conventions.md,设计前阅读,交接前对照检查。
限制:资料未提供收费、价格、平台支持范围或效果保证等信息。