技能指南

技能（skills）把专业 SOP 注入 agent 的系统提示词，例如审查清单、写作模板和翻译纪律。它提供操作规范；实际效果仍需用场景评测验证。

为什么需要技能

只写 systemPrompt 的 agent 往往缺少具体的领域流程。配了技能后，可以给模型明确的工作步骤和输出要求：

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

技能还是可复用资产：一个技能配给多个 agent。修改文件后，重新启动 CLI 或重新创建 Runtime 才会加载新内容；已开始的 Run 不会因此自动改变。

使用：三行配置

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 会告警并提示两种来源。

技能内容会进入系统提示词。加载第三方 README.md 前应审查其中的指令和数据来源；技能文本不会自动获得工具权限，工具调用仍按 agent 的配置与权限策略处理。

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

技能生态

技能是可复用的内容资产：把 skills/<id>/README.md 交给受信任的项目，由对方审查后放进 skills/ 即可使用。当前版本支持内置技能与项目目录技能；尚不提供官方技能市场。