Skip to content
Development
Skill

/x-dev

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

From plugin
x-dev-pipeline
1220 skills
Install
$ npx -y skills add KtKID/x-dev-pipeline --skill x-dev --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-dev

Context preview

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

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

SKILL.md

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

x-dev — task 执行

输入与边界

x-dev 的作用域是**单个 task**:`docs/spec/<spec-name>/tasks/<task-name>/`,入口是它的 `dev-checklist.md`,按头部 `spec:` 指针跟读 v6 spec 的相关 feat 与场景。一个 spec 下可以有多个 task,x-dev 一次只执行指定 task,不扫描或编排同级 task。

checklist 的约定(由 x-req 生成):

  • **行序即实现顺序**,无依赖图;从 T1 开始逐行往下做。
  • **场景回指定验收**:一行做完的判定标准是它回指的每个场景的 GIVEN/WHEN/THEN 全部成立。
  • **风险列为 `高:` 的行**,验证必须包含真实链路(smoke 或以上),不允许只写 unit。
  • 改动落在「涉及文件」范围内,不"顺便"改别的。

执行

高能力模型按批次执行:独立读取放同一批次;文件只在内容变化后重读;过程更新只报告新进展或阻塞。

1. **取证批次**:一次读完整 checklist、spec 中被回指的 feat 场景、涉及的实现与测试文件,建立「场景 → 代码 → 测试」的对应关系;顺带确认涉及文件路径真实存在(x-req 留了 glob 的就在此批次定位)。 2. **逐行 TDD**(先测试后实现,顺序不能反):

  • 把当前行状态改为 `[ ] ▶️`。
  • 为行回指的场景写测试:场景的 THEN 就是断言。先跑一遍,确认失败原因是"功能还没实现"。
  • 写实现,改动保持在涉及文件范围内,让测试变绿。
  • 测试通过后行状态改为 `[x] 🟢`。测试照常真实运行,但输出不写进文档。

3. **行失败时**:读完整输出,按根因一次修完全部关联位置;发现是测试写错就改测试并在 dev-report 未决节记一行原因。同一行失败多次不改目标——回看场景定义,仍不清楚就停下来问用户。失败中的行标 `[!] 🔴`,修复后恢复。 4. **收尾验证**:全部行 🟢 后,跑一次本 task 全量测试 + 一次既有测试回归(确认没有破坏 spec 概述和既有功能里的不变量),把结论(全绿 / N 个 🔴、回归通过与否)记进 dev-report。 5. **交付**:确认 checklist 无 🔴 残留,输出回执,报告下一步(同 spec 的下一个 task,或全部完成)。

dev-report

`docs/spec/<spec-name>/tasks/<task-name>/dev-report.md`,只记结论、不贴测试输出:全绿或 N 个 🔴、回归结果、高风险行验证情况;红色失败一行一条摘要。完整读取 `templates/dev-report.md` 后填充。

自检(交付前)

  • checklist 每个非 `None` 场景回指都有对应测试且行状态 🟢?
  • 高风险行有真实链路验证?
  • 全部改动都在「涉及文件」范围内?
  • 既有测试回归通过?
  • 每个 🔴 行都在 dev-report 未决节有一行摘要?

回执

✅ x-dev 完成 · <task-name> · 行 N/N 🟢 · 场景覆盖 M/M · 高风险行 K(已验证)· 回归通过

有阻塞或失败残留时如实列出:行号、失败摘要、已尝试的动作、需要用户决定的问题。

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-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

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

x-verify
Skill

x-verify

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