腾讯云 CloudBase Spec 流程

要解决的具体问题

在开发新功能或进行架构变更时，团队常面临需求模糊、缺乏结构化规划的问题。这导致直接编码后出现实现与预期不符、返工频繁，以及跨模块协调不足。常见场景包括：新页面或系统设计、多步骤产品变更、数据库或 UI 密集型工作，这些都需要明确的验收标准和阶段性确认，否则容易偏离用户目标。

技能如何工作：规范流程

该技能提供了一套结构化的工作流程，通过四个核心阶段确保开发有序进行：

• 需求阶段：创建 specs//requirements.md，使用 EARS（Easy Approach to Requirements Syntax）格式编写用户故事和验收标准。关键步骤包括：

- 重述问题和范围，明确业务规则、约束和非目标。
- 例如，验收标准格式为 THE <system> SHALL <functional requirement> WHEN <trigger> IF <condition>，确保具体可测试。

• 设计阶段：创建 specs//design.md，描述架构、模块边界和技术选择。内容涉及：

- 解释技术权衡，定义数据模型、API、安全策略和测试方法。
- 仅在必要时使用 Mermaid 图表增强清晰度，避免过度复杂化。

• 任务阶段：创建 specs//tasks.md，将设计拆分为可执行任务。要求：

- 任务具体、可审查，并链接回相关需求，格式如 - [ ] Task description。
- 随着工作进展更新任务状态，保持可追溯性。

• 执行阶段：仅在用户确认任务计划后开始实现。执行中：

- 一次完成一个有意义单元，保持任务状态最新。
- 维护从变更到任务再到需求的追踪链，确保一致性。

技能还强调工作规则：当请求不足时主动提问，不猜测核心行为；在需求、设计和任务拆解之间必须获得用户确认；涉及页面或视觉决策时，尽早引入 ../ui-design/SKILL.md；文档保持简洁但可测试，优先关注用户可见成果。

适用边界与注意点

• 何时使用：适用于中型到大型任务、跨模块变更、验收标准模糊的情况，例如新功能定义、架构设计或数据库/UI 密集型工作。
• 何时跳过：对于小错误修复、单文件文档更新、简单配置更改或用户已提供精确指令的微小重构，可直接执行，无需强制生成规范文档。
• 常见陷阱：

- 未明确验收标准就跳入编码，导致需求漂移。
- 阶段间缺乏用户确认，如从需求直接到设计而未获得反馈。
- 任务描述模糊，未映射回用户可见成果，仅关注技术细节。
- 将 UI 工作视为纯技术实现，忽略设计意图澄清，可能导致用户体验脱节。

遵循此流程能帮助团队减少返工，提高开发质量，但需根据任务规模灵活应用。