用途：为 Quick Flow（小型、范围明确、约 1-15 个故事的工作）生成聚焦的 tech-spec.md。它把产品理由、技术方案和故事待办合并为一份轻量文档，替代较大工作流所需的 PRD + 架构两份产物。轨道指引：1-15 个故事、单团队、需求明确用本技能；10-50+ 故事、多关注点或范围不确定用 bmad-prd 再 bmad-architecture；30+ 故事、跨组织、涉及安全合规/DevOps 用 Enterprise 轨道。
工作流：1）识别意图——Create（尚无 tech-spec.md）、Update（修订已有规格）或 Validate（检查草稿完整性）；2）收集上下文——问题与解决方案、范围含明确排除项、带 MoSCoW（MUST/SHOULD/COULD）编号的功能需求、相关非功能需求、技术方案（技术栈、关键组件、数据模型草稿、API 面）、高层故事清单、依赖与风险、决策日志条目；若存在 bmad-output/project-context.md 须加载且不得违背。
3）起草或修订——渲染 ${CLAUDE_PLUGIN_ROOT}/skills/bmad-tech-spec/templates/tech-spec.template.md，填满各节，确实不适用可省略并注明，不得留下未替换的 {{placeholders}}；测试策略仅作规划描述，不写测试代码、不设强制覆盖率目标。4）写入 bmad-output/tech-spec.md（遵循 outputFolder 配置）；决策日志追加到 bmad-output/decision-log.md，格式为 ## [YYYY-MM-DD] <title>、Decision:、Rationale:，文件不存在则创建。5）确认后续——提醒下一步用 bmad-epics-and-stories 从故事清单生成故事；若范围超过约 15 个故事，建议改用 bmad-prd + bmad-architecture。
Validate 意图需逐项报告通过/失败，包括问题陈述清晰、方案不含实现代码、功能需求编号且有 MoSCoW 标签、适用时有性能或安全非功能项、技术方案指明技术栈和关键组件、故事清单存在且标题一行且面向行动、故事数为 1-15、无未替换占位符、测试节仅描述策略、依赖表列出版本或版本约束、风险表至少一项含缓解、重要选择已入决策日志、无内容指示开发代理运行测试/ lint /构建或部署。
限制：本技能基本单线程（一次对话一份文档），并行仅限信息收集，可并行启动两个 WebSearch/WebFetch 代理比对技术选项后再综合；不得并行写作文档以免合并冲突。属 BMAD Planning & Orchestrator 插件，实现 bmad-tech-spec 精神，方法论归 BMAD Code Organization。