Skills

什么是 Skills？

Skills 是给 AI 编码代理的可复用能力包。通常包含一个 SKILL.md，可选包含脚本、参考资料、模板资源。

核心作用：

把高频任务沉淀成稳定流程
让 Agent 在触发时加载更准确的上下文
降低“每次都从头写 Prompt”的成本

官方文档（优先）

本项目文档以官方机制为准，不再把“自定义固定模板”作为默认入口。

最小 SKILL.md 示例

---
name: example-skill
description: 一句话描述技能做什么，以及在什么场景触发
---

执行目标与步骤：

## 1. 执行

\`\`\`bash
# 在这里放最关键的命令
\`\`\`

## 2. 验证

说明“什么输出算成功”。

## 失败处理

给出排查顺序和重试动作。

安装位置（项目优先）

Claude Code（项目级）：<project>/.claude/skills/<name>/SKILL.md
Codex（项目级）：<project>/.codex/skills/<name>/SKILL.md
用户级路径（如 ~/...）仅用于跨项目共享，不作为本项目默认方式

创建方式建议

不再推荐“复制固定 Prompt 模板”作为第一步，改为：

直接告诉 Agent：目标、触发场景、关键命令、成功标准
让 Agent 生成最小版本 Skill
在真实任务中验证后，再决定是否扩展结构

Multi-agents 总结（推荐用于 PR 审查）

在本项目中，multi-agents + skills 是优先路径。相较于传统 worktree 并行（人工切分任务、跨工作区切换、手工合并上下文），该组合的优势是：

无需人工跨线程管理多个工作区与上下文漂移
每个 agent 按 skill 约束执行，输出格式更稳定
汇总阶段天然结构化，更容易做风险门禁（P0/P1）

当任务可拆分为多个独立审查点时，优先使用 multi-agents 并行执行：

先定义审查点（如 Security、Quality、Bugs、Race、Maintainability）
每个审查点分配一个 agent
等待全部 agent 完成后统一汇总

推荐角色分工：

explorer：静态代码审查与证据定位
worker：需要执行命令或复现实验的检查
monitor：长耗时等待与轮询（若环境不支持则降级为 worker/default）

建议统一输出结构（每个审查点）：

[审查点] <名称>
结论: <通过|关注|失败>
证据: <文件/命令/日志/复现摘要>
风险等级: <P0|P1|P2|P3>
建议: <立即修复项 + 可延后项>

风险告警建议：

任一 P0/P1：标记高风险，建议暂缓合并并优先修复
无 P0/P1：可继续推进 PR 流程