用途:这是一个需求工程技能,专注规格驱动开发。当用户提出“规划一个功能”“写一份规格”“新模块:[name]”等请求时启用,在编码之前产出结构化的功能规格。触发时以“Spec Architect skill activated. I will follow the SOP to generate a structured spec for this repository.”开头。
主要能力:按标准作业流程(SOP)分析现有工作区,判断新功能应放置的位置;询问 3–5 个澄清问题(涉及业务域、边界情况与失败模式、数据模型与表字段尤其是 franchise_id、UI 流程与用户操作、合规/报表/审批要求);使用模板 spec-architect/templates/feature-spec.md.template 生成最终的 spec.md。规格要求使用 YAML frontmatter 标注 status、priority、tenants、stack;包含多租户防护(处处使用 franchise_id);引用服务、API、UI、补丁的真实文件路径;包含测试策略与发布/回退步骤;文件名用 kebab-case。
输出规则:规格需简洁且可直接实施,执行计划中引用确切文件路径,验收标准或执行计划中包含验证与回退步骤,并附文档影响说明(Descriptional Impact),描述该功能将如何写入手册。规格与澄清问题中不得包含外部 URL。
适用场景:需要快速、聚焦的功能规格而不需要完整实施计划时。若需“做什么+怎么做”的完整规格与实施计划及 TDD,应改用 feature-planning;项目级需求访谈用 project-requirements;SDLC 标准 SRS 用 sdlc-planning 等关联技能。
限制:不要用于与 spec-architect 无关的任务;请求只需简单答案且该技能的约束或参考无实质帮助时也不适用。避免把示例当作可直接复制的事实、避免默认加载所有参考文件、应使用渐进式披露。缺失信息需明确列为假设、风险或未解决缺口。