Skip to content
Development
Skill

/x-verify

Gate ① 交付对账 skill。task 开发完成后使用:以 spec 场景为事实源,对账 dev-checklist 的场景回指、行状态与 dev-report 结论,全部一致给回执,不一致按来源分诊。触发:x-dev 交付、用户要求 verify 或复核某个 task。

From plugin
x-dev-pipeline
1220 skills
Install
$ npx -y skills add KtKID/x-dev-pipeline --skill x-verify --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/x-verify

Context preview

The summary Claude sees to decide when to auto-load this skill.

Gate ① 交付对账 skill。task 开发完成后使用:以 spec 场景为事实源,对账 dev-checklist 的场景回指、行状态与 dev-report 结论,全部一致给回执,不一致按来源分诊。触发:x-dev 交付、用户要求 verify 或复核某个 task。

SKILL.md

x-verify.SKILL.md
name: x-verify
description: |
  Gate ① 交付对账 skill。task 开发完成后使用:以 spec 场景为事实源,对账 dev-checklist 的场景回指、行状态与 dev-report 结论,全部一致给回执,不一致按来源分诊。触发:x-dev 交付、用户要求 verify 或复核某个 task。

x-verify · Gate ①

定位与边界

验证对象是**单个 task 的交付证据链**:`dev-checklist.md`(req 产物)与 `dev-report.md`(dev 产物)两份文档的对账,spec 场景只作为回指的事实源,不重新评审 spec 本身——spec 质量归 x-spec 与 x-req 就绪检查。不重跑测试:x-dev 已真实运行测试,verify 只核对结论与证据是否一致、覆盖是否闭合。代码质量由 x-qa-gate 处理。

对账项

按顺序检查,先结构后内容:

1. **结构**:task 目录 `docs/spec/<spec-name>/tasks/<task-name>/` 下 dev-checklist.md 与 dev-report.md 齐全;spec.md 存在且 v6 结构完整(标题 + 概述 + feat 列表)。 2. **回指有效**:checklist 每行"场景回指"列的 `featNN 场景M`(含逗号分隔与 `场景1-3` 区间写法)都真实存在于 spec;`None` 行保持最少。悬空回指是拆解问题。 3. **影响树一致**:checklist 影响文件树与「涉及文件」列一一对应——树上没有表外文件,表内文件(glob 计目录节点)都在树上,标记只用 U/M/D。 4. **行状态闭合**:全部任务行为 `[x] 🟢`,无 ⏳ / ▶️ / 🔴 残留。 5. **高风险行**:风险列为 `高:` 的行,dev-report 结果节必须声明其真实链路验证(smoke 或以上)。 6. **结论一致**:dev-report 结果节与 checklist 对得上——声称全绿则 checklist 确实无 🔴;存在 🔴 或回归失败时,未决节逐行对应(行号 + 摘要 + 已尝试动作),不得漏记或多记。

分诊

发现问题按来源退回,不递增 fix-counter:

  • spec.md 缺失或 v6 结构不完整 → 退回 x-spec。
  • checklist 表头不可解析、回指悬空、`None` 行过多、影响文件树缺失或与「涉及文件」列不一致 → 退回 x-req。
  • dev-report 缺失、格式不符模板、结论与 checklist 状态矛盾、高风险行缺真实链路声明 → 退回 x-dev。
  • checklist 有 🔴 残留或回归失败且已在未决节如实记录 → 这是已知失败而非文档问题;交 x-fix 处理,或如实报告阻塞等用户决定。

约束

  • 只报告事实与一致性结论,不评判实现质量、不改任何文档。
  • 一次跑完全部对账项后交付完整问题清单,不逐项挤牙膏。
  • 全部通过时不写报告文件,只输出回执;有问题时把完整清单交对应 skill 或 x-fix。

回执

🛡️ Gate① verify ✅ · <task-name> · 行 N/N 🟢 · 回指场景 M/M 有效 · 影响树一致 · 高风险行 K(已声明)· 结论一致
🛡️ Gate① verify ❌ · <task-name> · 问题 N 项 → 退回 <x-spec / x-req / x-dev / x-fix>
Read more
Ships withx-dev-pipeline

An auditable development workflow for AI coding agents: requirement contracts, implementation evidence, deterministic checks, and risk-matched review.

Get the whole plugin
Stats
12
Stars
0
Forks
Active
Maintenance
Python
Language
MIT
License
8d ago
Last commit
5mo ago
Created

Repo: KtKID/x-dev-pipeline

Other skills on x-dev-pipeline.

x-cr
Skill

x-cr

软件正确性调查 skill。用于用户说“XX 不太对”“这个功能有 bug”“结果和预期不一致”“帮我查原因”,也用于 review 模块、文件、diff 或 PR 的正确性。遇到已知异常、模块不变量、信任边界、授权范围扩张、服务端校验、租户/会话隔离或持久化一致性问题时优先使用本 skill。 本 skill…

x-dev
Skill

x-dev

开发任务执行 skill。读取单个 task 的 dev-checklist.md,按行序以"先测试后实现"的方式逐行执行,dev-report 只记验证结论(全绿或 N 个 🔴),全部行验证通过后交付。触发:`x-dev {task-dir}`、用户要求执行/开发某个 task。

x-fix
Skill

x-fix

Bug 修复执行 skill。分三种入口: 1. 用户直接报告 Bug → 定位根因 → 修复 → 产出 fix-report-*.md 或 fix-note-*.md(无需 CR 报告) 2. 有 x-cr 的 CR 报告 → 按稳定 Bn/INV-ID 逐条修复 → 回写同一份 task 内或仓库级…

x-qa-gate
Skill

x-qa-gate

verify 通过后的质量审查。Q2/Q3 各由一个 reviewer 在单轮内按 q1-intent、q2-correctness、q3-evidence 三个独立 lens 穷尽检查;Q3 使用完整高风险输入和逐 lens 回执。发现 P0/P1 后登记 issue 并交 x-fix 批量修复,主 agent…

x-req3
Skill

x-req3

x-spec3 的任务拆解 skill。读取 `docs/spec/{spec-name}/spec.md` 的目标、边界与不变量、判断依据、验收清单和直接 GWT Scenarios,生成 `docs/spec/{spec-name}/tasks/{task-name}/dev-checklist.md`,并以…

x-spec3
Skill

x-spec3

在开发方案已经讨论清楚、需要固化保存时使用。也适用于用户明确要求保存方案、编写规格文档,或希望在开发前明确目标、边界、约束和验收标准的场景。将已确认的方案整理成可供后续任务拆解、开发和验证共同使用的规格文档。