用途:这是一套用于 Argus 仓库的元技能,教人如何设计和组织结构化的 AI 智能体技能,使其可在 GitHub Copilot、Claude Code 与 OpenCode 中工作。
主要能力与原则:1)先捕获意图再动笔——就任务领域访谈,收集 5-10 个示例提示、期望输出与失败模式;2)description 即触发器——Claude Code/OpenCode 主要依据 frontmatter 的 description 决定是否加载技能,正文的 When to Use/When NOT to Use 在激活后才读取,故触发关键词、用例和排除项应写进 description;GitHub Copilot 则通过 AGENTS.md 的显式引用发现技能。description 限制:不超过 1024 字符、不含尖括号、用第三人称、列出触发条件而非工作流步骤;3)编写触发测试查询,5-10 个应触发与应不触发用例,并单独读 description 验证激活是否正确;4)每条指令须解释 WHY;5)阶段必须编号并含进入/退出标准;6)渐进披露:SKILL.md 不超过 500 行,详细模式放 references/,分步流程放 workflows/,且所有文件与 SKILL.md 仅一跳之隔,不得形成引用链;7)精简指令,删去不影响结果的条目。
使用方式:技能目录为 skills/<kebab-case 名称>/,含 SKILL.md(带 YAML frontmatter)、references/、workflows/。SKILL.md 模板包含标题、一句话目的、Essential Principles(3-5 条非协商规则)、When to Use(4-6 个场景)、When NOT to Use(3-5 个场景)、领域章节、Reference Index、Success Criteria。新技能需在 AGENTS.md 的 Skills 表格中登记条目。高层流程见 create-a-skill.md(捕获意图、起草 description、写 SKILL.md、拆分内容、登记、校验),测试迭代见 test-and-iterate.md。
适用场景:在 skills/ 下新建技能、评审重构现有技能、决定 SKILL.md 与 references/、workflows/ 的内容划分、为特定 Argus 任务域(测试、规划、编码、评审)组织结构、配置平台发现、测试 description 触发是否准确。
限制:本技能只教结构,不教领域内容;一次性文档更新或在不新建技能时更新 AGENTS.md 不适用;技能正文应保持平台无关,不得含平台特定指令;文档另附反模式清单(如模糊 description、超大 SKILL.md、引用链、无编号阶段、缺退出标准、无验证步骤、路径失效、description 超限、无意图捕获、无测试查询等)。