to-checklist

Files (2)

• SKILL.md
• openai.yaml · agents/

SKILL.md (first lines)

把已确认的需求或方案写成分批、带 checkbox 的本地执行文档。完成标准是：新会话读取清单及其明确引用的材料后，能继续查源码并实施，无需重新决定已经确认的关键问题。

## 写作前

读取已确认的需求、方案和宿主仓库规则，核对受影响的入口、调用关系、职责与状态归属、相关测试和验证命令。事实自己查；仍影响范围或验收的用户决策交回 `/grilling`，不要把未决方案写成可直接执行的任务。暂时无法核实的技术前提写明核验方式及其影响，让依赖它的批次在核验通过后再执行。

遵循宿主仓库已有的计划文档约定；否则保存到 `.plans/YYYY-MM-DD-<主题>.md`，不进 git。Git 仓库首次采用默认目录时检查 `.gitignore`，缺少 `.plans/` 时追加并说明。同一目标的修订更新原文并保留有效进度；不同目标使用独立文件，不覆盖其他未完成计划。

默认一份文档。已有规格或设计文档时，引用具体路径和章节，保留执行所需的结论；进度只在一处维护。

## 文档结构

按下面的结构组织，小任务可合并章节；篇幅随决策、依赖和风险增加，不限制行数或批次数，也不为填模板写无关内容。

```md
# <主题>

## 背景与范围

<为什么做、目标范围、已声明的假设、排除项和必须保持的现有行为>

## 实现依据

<已确认的关键决策及理由；涉及的职责或状态归属；相关源码、测试和方案的阅读入口，并说明各自用途>

## 验收判据

<目标完成时必须满足的可观察结果，覆盖已确认需求及相关边界情况>

## 执行清单

- [ ] 批次 1：<一个可验证的行为或交付结果>
  - 改动：<做什么、复用哪个入口、涉及哪些文件的大致范围>
  - 验收：<本批完成后必须成立的具体行为或条件>
  - 验证：<仓库中可执行的命令或人工检查步骤，以及预期结果>
  - 依赖：<前置批次或核验结果；无依赖时省略>
- [ ] 批次 2：……

## 整体验证

<跨批次的集成检查、需保护行为的回归检查及其预期结果；通用完成标准引用宿主规则>
```

跨模块、并发、迁移或高风险改动，按实际影响补充接口契约、失败与竞态边界、兼容或回退方式。写在相关决策或批次附近；只有多批共用时才单列一节。

## 分批标准

- 每批完成一个可独立验证的行为改动，或一组小而同质的修改；优先沿完整行为路径做纵向切片。必要的契约定义、基础准备或技术核验可独立成批，但要有明确产物和验收。
- 按依赖排序；在依赖允许时，先验证最不确定或影响最大的前提。需要并行时标明职责和文件边界，共享契约先确定，共享状态改动按依赖顺序执行。
- 每批完成后系统应保持可用；在跨模块接通或主要阶段结束时安排集成检查。检查深度遵循项目要求和本次风险，不按固定批次数设置人工审批。
- 写清影响实现的决定和约束，具体代码留给执行阶段。一份清单对应一个目标；目标内可分阶段，仅在包含可独立验收的不同目标时拆成多份文档并注明依赖。

## 交付与接力

交付前逐项核对：已确认需求都有验收和对应批次，依赖顺序可执行，阅读入口真实可定位，验证方式匹配目标行为，未核实前提已标明。直接修掉占位符、矛盾和会导致不同实现结果的歧义；未解决的实质决策不能标成可执行。

给出文档路径和需要过目的关键决策。仅请求清单时到此结束；已有明确实施授权时继续，否则确认后再由 `/implement` 或当前可用的执行能力按批次推进。

执行者在本批验收满足且验证通过后勾选，记录实际验证结果或证据位置；部分完成时保留未勾选状态，就地写明已完成部分、阻塞和下一步。恢复时核对这些记录与当前源码；发现前提或范围变化，先更新受影响的计划，涉及用户决策或超出现有授权时暂停相关批次。

From iZiTTMarvin/agent-skills-zh, MIT.

More from iZiTTMarvin/agent-skills-zh