implementation-check
Skill4 starsChanged 6 months agoMITView on GitHub
Run a pre-QA implementation self-check against task scope, acceptance criteria, validation evidence, and pending diff.
In this repository7 other files it gives its agents.
- acceptance-checkSkill
- bugfixSkill
- release-checkSkill
- reviewSkill
- task-specSkill
- test-specSkill
- token-reportSkill
The file
Files
implementation-check
在 Engineer 完成实现后、进入 QA 验收前,对任务范围、实现 diff、验证结果和已知风险做自检;它是 QA 前门禁,不替代 QA 的独立验收结论。
用法
/implementation-check <任务定义、PRD 或 pending diff>
目标
- 确认实现是否匹配 task-spec、PRD 或架构约束
- 检查变更文件是否落在声明范围内
- 汇总定向验证证据和未覆盖项
- 检查长任务字段完整性和上下文恢复性
- 给出“建议进入 QA / 不建议进入 QA”的明确结论
适用场景
- 实现已完成,准备提交 QA 前
- 需要核对 pending diff 是否偏离任务范围
- 需要整理验证证据和已知限制
- 多文件改动需要先做实现侧自检
不适用场景
- 替代
/acceptance-check的 QA 验收 - 在实现前生成任务或需求
- 直接修改代码
- 掩盖测试失败或未完成实现
检查清单
每次自检必须逐项记录状态、证据和结论:
- 范围一致性:实现是否只覆盖任务定义、PRD 或架构约束声明的范围;偏离范围时列出文件和原因。
- 文件变更:列出新增、修改、删除文件,说明每个文件与任务输出的关系。
- 测试证据:记录已运行的定向命令、文档检查或人工检查路径,以及关键结果。
- 任务字段完整性:检查任务 ID、
depends_on、read_before_start、execution、evidence、handoff是否存在;缺失时必须说明原因和影响。 - 上下文恢复性:判断新会话是否能只依赖任务文件、依赖产物、pending diff、
evidence和handoff恢复任务状态。 - 已知限制:说明未覆盖场景、外部依赖、无法验证项或需要人工复查的内容。
- 风险项:评估兼容性、数据、权限、性能、安全和发布风险;无风险时写“未发现”。
- QA 进入结论:只能输出
建议进入 QA或不建议进入 QA,并给出一句理由。
执行规则
- 先定位任务定义、验收标准、架构约束和 pending diff 来源。
- 每个检查项必须给出证据:文件路径、命令或 diff 范围。
- 若实现偏离任务范围,结论必须是“不建议进入 QA”。
- 若长任务字段缺失且没有说明原因,不得给出“建议进入 QA”。
- 若关键验证缺失或失败,不得给出“建议进入 QA”。
- 若任务无法在清空聊天上下文后由文件和产物恢复,不得给出“建议进入 QA”。
- 发现问题时输出退回 Engineer 的具体修正项。
示例
/implementation-check tasks-p8.md 中 token-report skill 变更,核对 pending diff 是否只包含 SKILL.md 和任务勾选/implementation-check bugfix 提交涉及 unrelated README 改动,判断是否偏离任务范围
输出骨架
[示例:实现符合任务]
[自检对象] ...
[范围一致性] 通过(证据:...)
[文件变更检查]
- path: 与任务输出的关系 / 是否在范围内
[任务字段完整性]
- 任务 ID / depends_on / read_before_start / execution / evidence / handoff: 完整 / 缺失原因
[验证证据]
- 命令或检查:结果 / 关键证据
[上下文恢复性]
- 可恢复 / 不可恢复(证据:任务文件、依赖产物、evidence、handoff)
[已知限制]
- ...
[风险项]
- 兼容性 / 数据 / 权限 / 性能 / 安全 / 发布
[结论] 建议进入 QA / 不建议进入 QA
[理由] ...
[退回项] (仅当不建议进入 QA 时)
[示例:实现偏离任务]
[范围一致性] 不通过(证据:...)
[文件变更检查]
- path: 与任务无关 / 需要移出本次提交
[验证证据]
- 缺失或失败:...
[任务字段完整性]
- 缺失字段或缺失原因:...
[上下文恢复性]
- 不可恢复(原因:缺少 read_before_start / evidence / handoff / 依赖产物)
[结论] 不建议进入 QA
[退回项]
- 移除无关变更或拆分任务
- 补齐失败/缺失的定向验证验收标准
- 示例覆盖“实现符合任务”和“实现偏离任务”两种结果
- 输出骨架包含范围一致性、文件变更、测试证据、任务字段完整性、上下文恢复性、已知限制和风险项
- 结论只能是
建议进入 QA或不建议进入 QA - 偏离任务、验证失败、关键字段缺失或清空聊天上下文后不可恢复时必须输出退回项
验收
- 明确该 skill 是 QA 前实现自检,不替代 QA 验收
- 输入覆盖 task-spec、PRD、架构约束和 pending diff
- 输出能给出“建议进入 QA / 不建议进入 QA”的明确结论
- 结论必须由检查项、验证证据、任务字段完整性和上下文恢复性支撑
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

