Community编程与开发github.com

aitormf/agent-skills

引导用户逐一审视规格或计划评审的结论,仅应用那些明确批准的更改。适用于存在 review-spec.md 或 review-plan.md 且需要应用或舍弃其结论的场景。

agent-skills 是什么?

这个技巧(Skill)通过引导用户逐步处理评审结论,确保只有明确批准的更改才会被应用。它严格遵循“不假设、不推断”的原则,每个评审发现都单独决策,并提供了完整的流程:从列出发现、提供选项(应用、修改、舍弃、推迟),到确认决策、实际应用更改,再到检查其他受影响草案。该技巧支持在 docs/specs/ 目录下组织工作项,并通过 frontmatter 中的状态字段(draft、approved、obsolete)管理版本,适用于 Cursor、Claude Code 等支持自定义技能的 AI 代理平台。其核心价值在于将模糊的评审过程转化为结构化的、受控的更改流程,特别适合需要严格合规或在多文档依赖场景下工作的开发团队。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aitormf/agent-skills/tree/HEAD/skills/apply-review

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

应用评审

帮助用户对每条结论做出决定,并仅应用他们批准的更改。

核心规则: 绝不假设、推断或在没有明确决策的情况下应用更改。如果某条结论含糊不清,先请用户澄清,再提供选项。每条结论单独决策,绝不批量处理。

制品和状态

  • 每个工作项位于 docs/specs/<YYYYMMDD>-<type>-<name>/ 中。
  • spec.md 和 plan.md 在其 frontmatter 中包含 status: draft | approved | obsolete。只有用户才能将其设为 approved。
  • 如果你更改了一个状态为 approved 的制品,请将其改回 draft 并告知用户。

步骤 1:呈现结论

  1. 确定工作项和评审(review-spec.md 或 review-plan.md)。如果不明确,请询问用户。
  2. 列出所有结论,编号排列,阻塞性结论优先。对每条结论显示:
    • 结论 [N]: 评审指出的问题。
    • 建议的修复方案(如果有)。
    • 选项:
      • A) 按原样应用修复。
      • B) 应用修改后的修复(由用户描述)。
      • C) 舍弃,并说明原因。
      • D) 推迟。

等待用户全部答复后再继续。

步骤 2:确认

决策摘要
────────────────
[N] <标题> → 应用 / 修改 / 舍弃 / 推迟

询问:“在应用之前,您确认这些决策吗?” 未经确认不得继续。

步骤 3:应用

  1. 仅应用已确认的更改(A 和 B),且仅修改被评审的制品。不接触其他任何内容。
  2. 在评审文件中,每条结论下方记录所做的决策:
    • 对于舍弃的结论,注明原因;
    • 对于推迟的结论,注明尚未解决的内容。
  3. 告知用户当前状态:
    • 如果没有待处理的阻塞性结论,该制品已准备好让用户将其标记为 approved,或者进行下一轮 review-spec 评审。
    • 如果仍有延迟的阻塞性结论,或舍弃的结论存在风险,请指出。

步骤 4:其他受影响的规格

检查步骤 2 中的任何决策是否影响其他正在进行的规格:

  1. 查看 docs/specs/*/spec.md 中 status: draft 的规格。
  2. 对每个规格,判断决策是否引入了冲突、改变了依赖关系或使某个假设失效。
  3. 对每个可能受影响的规格:
    • 指出该规格、涉及的小节以及需要修改的内容;
    • 询问:“此决策会影响它吗?我是否应该提议更改?”等待用户回答“是”或“否”。
  4. 如果回答“是”,仅起草最小更改(确切的小节和行数),显示差异并在获得批准后应用。

不要对这些规格中的其他内容进行改进、扩展或重格式化。如果在任何时候不清楚该做什么,请停下来询问用户。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能