用途：把 PRD 中的需求转化为技术指导与架构决策，产出简洁、以架构为中心、严格遵循内置模板的技术规格，并将其保存到 vault（默认 $HOME/Documents/obsidian/obsidian）。这是 spec 驱动工作流的第二步，供后续 ai-review-techspec、ai-create-tasks、ai-execute-task 读取。
主要能力与流程：先分析 PRD，再做深度项目分析，随后提出澄清问题，映射仓库标准，最后按模板生成技术规格并保存。生成内容包含架构概览、组件设计、接口、模型、端点、集成点、测试策略与可观测性，聚焦“如何实现”而非重复 PRD 功能需求。
必要输入：vault 中的 engineering/<project>/workplans/<feature>/prd.md；若缺失需先运行 ai-create-prd。模板为 references/techspec-template.md，必须严格遵循，不得偏离。
使用方式：先运行 git rev-parse --show-toplevel 解析项目名，路径为 engineering/<project>/workplans/<feature>；用 Read 读取 PRD，用 Write 写入 tech-spec.md。写完后更新 feature 索引、项目索引与根索引（append-if-missing，不重复链接），并提交到 vault 仓库：git -C "$V" add -A && git -C "$V" commit -m "<message>" && git -C "$V" push。提交失败（无 origin、离线）仅简要报告，不中止。
限制与约束：先探索项目再问澄清问题；未提问不得生成规格；库/框架问题用 context7 MCP，业务规则需至少 3 次网页搜索；优先使用现有库而非自研。wikilink 使用 vault 根相对路径，不写绝对路径。完成时回显 Feature ID 与下一步（ai-create-tasks / ai-review-techspec）。本次资料未提供收费、价格、平台支持等信息。