用途:当 feat/ 或 fix/ 会新增或改变外部可见行为(公共 API、CLI、schema、用户可见流程)时,把模糊诉求转成 docs/specs/<topic>/ 下的 spec.md(Why、Findings、What、Out of scope、Open questions、References)与 validation-contract.md(VAL-XXX-NNN 断言,每条含 Behavior、Tool、Evidence);规模闸门触发时另生成 umbrella.md。明确不做纯实现策略调整(重构、换库)、已有复现步骤的 bug 修复、无行为表面的纯文档或配置任务。
主要能力:支持五种输入模式——文字描述、静态 HTML 原型、PRD、Figma 链接(需用户附截图或 PNG,不直接抓取)、用户自带 spec(须按审计清单核对)。流程分 Phase A 调研、B 定方向与切分、C 落到文件、D 闸门与交接;澄清用 Q+GUESS 循环,每轮一个问题并附假设与置信度,约 95% 处停下,最多约 10 轮。
必要用法与约束:AGENTS.md、CLAUDE.md 优先于 README;A1 预研收集 docs/rules/spec/ 规则,未命中时记录“无项目专属 spec 规则”。模板取自 references/spec-template.md、validation-contract-template.md、umbrella-template.md;章节标题的英文锚点与 VAL 结构关键字须逐字保留,正文用对话语言。VAL 的 Tool 只填类别(unit-test、integration-test、e2e-browser、e2e-mobile、e2e-cli、http-probe、repo-check、git-state、gh-state、lint、build、manual),具体工具记在 ## Toolchain 表。D1.5 选项顺序为 skip → playground → static HTML;静态 HTML 生成 docs/specs/<topic>/review.html 后用 open <file>.html 打开。实现已开始后不得再调用本技能,不得把 How(模块名、类名、签名、库选择)写入 spec.md,不得编造 VAL;D2 需用户明确批准,D3 按规模判定是否跳过 plan。与 test-designer、incremental-impl、plan 阶段工具及 deep-review 的 spec-conformance 衔接。