用途:tech-spec 是只做投影的派生视图生成器,从代码(命令/查询处理器、事件消费者、后台任务、生产者、saga、outbox)与测试注解(TestSpec、TechnicalSpec)中生成 {TechRoot}/{Service}/{Component}.md,让工程师无需维护第二份手工技术文档即可了解组件技术面。它不撰写业务内容,业务规格仍由 Feature Spec 负责。
主要能力:三种模式——generate(默认,重新生成派生视图)、audit(对比代码/测试与视图新旧,输出过期清单,不修改文件)、sync(报告规范 §8 测试用例与执行测试代码的漂移,并做 CoveredBy:/orphan 路由级对账)。生成内容包含用例清单、TC↔测试映射、跨服务拓扑。
使用方式:先解析模式(显式 [mode=x] 优先,否则按措辞推断,含糊时直接询问用户,绝不自动启动变更模式)。技术根路径必须从 docs/project-config.json 的 specRoots.technical.path 读取,禁止硬编码;缺失则停止。执行前需通过 Scope Gate 确认服务/组件与模式。生成命令:npm run tech-spec:generate,或直接运行 node .claude/skills/tech-spec/scripts/generate-tech-specs.mjs。每个产物生成后立即写入,不累积在上下文中。
限制:每个生成文件必须带 DERIVED 横幅与再生成日期,不得声称是事实来源;禁止生成 A-E 工程树、M## 目录、00-module-registry.md、01-domain-erd.md、06-reimplementation-guide.md;禁止写入业务内容(用户故事、验收标准、业务规则、§1–§8 文本)。再生成须幂等(源未变则 diff 为空)。生成器不做判断(RIT 等由人工或外部 AI 在编写时完成),harvest 检测只报告、不作为构建门禁。若目标组件无可派生源则停止,不得虚构。