Spec-Plan Workflow (Spec-driven)

输出物（强制）

• 仅一个文件：docs/specs/spec{n}_<slug>.md
• 仅一次提交：只提交该 spec（不生成 design、不额外 commit）
• Spec 必须先落盘，再进行 review；review 后如有修改，更新同一个文件，直到用户确认后再提交

0) 建立仓库上下文（必须做）

在提问前先快速扫一遍（减少无效问题）：

• 目录：README*, docs/, src/, packages/, configs/
• 是否已有 docs/specs/ 与命名规则/模板
• git log -n 20 --oneline 了解近期方向与约束
• 基本约定：API 风格/配置方式/CI 门槛（知道“怎么跑”即可）

若无法访问仓库：明确说明“缺少仓库上下文”，请用户粘贴目录树/相关模块/现有接口示例；同时继续推进，使用 TBD 标注不确定项。