技能解决什么
说明书始终在。技能只在任务匹配或你点名时出现，用来放下检查清单、命令和示例。
同一件事你已经手把手带过两轮，就该收成技能，而不是再把二十行提示贴进对话框。
技能写不好会比没有更糟：过期命令会让 Agent 很自信地失败。
技能放哪、怎么被发现
项目级和用户级都可以。具体目录以官方技能文档和 inspect 为准。
用户可调用的技能常常以斜杠命令出现。重名时用带前缀的限定名。
市场和插件也能带入技能。来源越多，越要靠 inspect 看清加载了谁。
- 先写项目级一个技能。
- 用 inspect 确认被发现。
- 重名时用限定名。
一份技能至少包含什么
名字、何时用、步骤、验收命令、不要做什么。短比全好。
步骤写成命令和路径，不要写成“注意质量”。
把只在本仓库成立的假设写出来，例如包管理器和测试入口。
- 写触发条件。
- 写验收命令。
- 写禁区。
- 在小事上点名调用一次。
/skillify 适合什么
当你刚带 Agent 做完一轮满意的任务，可以用 /skillify 把过程收成技能草稿。它是加速器，不是免审。
生成后立刻删掉过期路径、补上验收命令，再在下一轮点名调用。不要把草稿当政策。
- 只从你满意的一轮抽取。
- 审阅后再提交到仓库。
- 下一轮故意点名，确认会被用到。
插件和市场怎么配合技能
插件可带技能、钩子或工具。市场是发现面。第一周仍然一次只加一样。
来源不可审查就不要装。装完 inspect，再决定是否留给团队。
- 先本地技能，再市场。
- 每个来源能说出来源路径。
怎么调用
点名、斜杠命令，或写一段能匹配描述的任务。不要假设它会自己跳出来。
TUI 里通常有技能面板或斜杠列表。无头则把技能名写进提示，或按文档参数传递。
调用失败先看 inspect，再看名字是否碰撞。
- 第一周用点名，少靠隐式匹配。
- 重名用限定形式。
- 失败时先 inspect。
技能和说明书怎么分工
说明书写永远成立的禁区和测试入口。技能写某类任务的步骤。
两边重复时，删技能里的那份，避免漂移。
- 永远成立的放说明书。
- 重复流程放技能。
- 只出现一次的步骤不要技能化。
技能章想挡住的错
把整本风格指南塞进一个技能，然后奇怪它从不触发。
从不点名，只指望自动匹配。
- 未审阅的 /skillify 草稿直接提交。
- 技能里写过期测试命令。
- 一次从市场装十个。
技能章完成标准
仓库里有一个你会点名的短技能，inspect 能看见它。
- 写好触发条件和验收。
- inspect 能列出。
- 点名调用过一次。
- 说明书没有被技能复制到膨胀。
下一步：只接一条 MCP
MCP 章只加仓库里没有的能力，而且先只读。
技能还不稳定时不要接线。