Initialize the public SDD Agen…

# diancan-sys 仓库 SDD Agentic Flow 初始化方案

一、目录结构

在仓库根目录创建以下结构（以 main 分支为基准）：

```

diancan-sys/

├── .spec/ # SDD 规范核心目录

│ ├── constitution.md # 项目宪法：不可违背的架构/技术原则

│ ├── specs/ # 规格文档（按能力域划分）

│ │ ├── 001-order-management/

│ │ │ ├── spec.md # 需求规格（WHAT & WHY）

│ │ │ ├── plan.md # 技术方案（HOW）

│ │ │ └── tasks.md # 任务拆解（可勾选清单）

│ │ └── 002-payment/...

│ └── templates/ # spec/plan/tasks 模板

├── .github/ # 或改为 Gitee 的 CI 目录

├── docs/ # 中文文档目录

│ ├── 架构说明.md

│ └── 开发指南.md

└── AGENTS.md # AI 代理行为约定

```

二、核心文件内容要点

constitution.md（项目宪法）

• 技术栈约束（如 Java/Spring Boot 或 Node.js，按现状填写）
• 数据库规范、接口风格（RESTful）、错误处理约定
• 测试要求：每个 spec 必须有对应验收测试

spec.md 模板要素

• 背景与目标、用户故事、功能需求列表
• 非功能需求（性能区间、安全要求）
• 明确的验收标准（Given-When-Then 格式）

tasks.md 要素

• 按 phase 拆分：数据库 → 服务层 → 接口层 → 测试
• 每个任务标注依赖关系与完成状态复选框

三、初始化操作步骤

1. 克隆并建分支：git clone 后确认/创建 main 分支并设为默认分支

2. 提交目录骨架：创建 .spec/ 目录及模板文件，commit 信息建议：chore: 初始化 SDD Agentic Flow 结构

3. 编写 AGENTS.md：约定 AI 代理必须先读 .spec/constitution.md，修改代码前先核对对应 spec

4. 首个规格初始化：以“订单管理”为第一个能力域，填写 001-order-management/ 三件套

5. 建立标签体系：建议 spec:、impl:、test: 三类前缀命名 issue/PR

四、电商订单场景建议的能力域拆分

• 订单创建与购物车
• 订单状态机（待支付/已支付/已发货/已完成/已取消）
• 支付回调处理
• 退款与售后
• 订单查询与统计报表

五、注意事项

• 文档全部使用中文，代码标识符保持英文
• spec 变更需通过 PR 评审，与代码变更分离提交
• 建议开启 Gitee 的分支保护：main 禁止直接 push，强制 PR + 至少一人审核

如需，我可以直接生成 spec.md、plan.md、tasks.md 的完整中文模板内容。