技能指南

技能（skills）让智能体按专业 SOP 干活：给 agent 配一个技能，它的系统提示词里就多了一份该领域的操作规范（审查清单、写作模板、翻译纪律……），输出质量更稳定。

为什么需要技能

只写 systemPrompt 的 agent 是"通用助手"——模型自由发挥，输出格式每次都不一样。配了技能的 agent 有固定的工作流程和输出规范：

• 代码审查 → 必须按检查清单逐项核对，输出 [高]/[中]/[低] 分级结论
• 周报 → 固定三节结构（本周工作/风险与阻塞/下周计划）
• 翻译 → 术语全文一致、格式不破坏、自检清单

技能还是可复用资产：一个技能配给多个 agent，改技能内容全部同步升级。

使用：三行配置

agents:
  reviewer:
    systemPrompt: 你是资深代码审查专家。
    skills:
      - code-review          # 注入代码审查技能

内置技能

技能 id	名称	作用
code-review	代码审查	按 SOP 审查：正确性/安全/性能/可维护性，输出分级结论
weekly-report	周报撰写	按 SOP 生成周报：收集维度/结构模板/价值导向写作
translation	翻译	术语一致/格式保持/自检清单

写错技能 id 不报错——会告警提示并忽略（可用列表会显示在告警里）。

技能与模板的区别

	模板	技能
是什么	完整可跑的配置（agent + workflow）	可复用的专业能力（SOP 文本）
怎么用	coremind create --template <id>	skills: [<id>] 注入任意 agent
粒度	整个项目	单个 agent 的能力增强

部分模板已预配技能（如 code-reviewer 自带 code-review 技能），开箱即用。

自定义技能

内置技能之外，可以在配置文件所在目录的 skills/ 下放自己的技能——每个含 README.md 的子目录就是一个技能，目录名即技能 id：

my-agent/
├── coremind.yaml
└── skills/
    └── legal-review/          # 技能 id：legal-review
        └── README.md          # 技能内容（SOP 文本）

# coremind.yaml
agents:
  reviewer:
    skills:
      - legal-review           # 引用自定义技能

自定义技能与内置技能使用方式完全一致（配置引用 + 运行时注入），同 id 时内置优先。写错 id 会告警并提示两种来源。

（"配置文件所在目录"的含义见 CLI 使用指南。）

技能生态

技能是可复用的内容资产：把 skills/<id>/README.md 分享给任何人，对方放进自己项目的 skills/ 即可使用——这是技能生态（可发布、可贡献）的基础约定。发布为 npm 技能包、技能市场等形态在后续规划中。