63 lines
2.6 KiB
Plaintext
63 lines
2.6 KiB
Plaintext
---
|
||
description: W05b 需求文档统一流程（落盘/归档/每日收口/先文档后开发）· 真源在卡若AI，永平等项目勿重复写规则
|
||
globs: ["**/开发文档/1、需求/**", "**/开发文档/10、项目管理/需求完成/**"]
|
||
alwaysApply: false
|
||
---
|
||
|
||
# W05b 需求文档（强制 · v2.0）
|
||
|
||
> **Skill 真源**：`卡若AI/02_卡人（水）/水泉_规划拆解/需求整理/SKILL.md`（§五b · §五c）
|
||
> **永平项目经验**：`卡若AI/.../需求整理/references/项目经验/Soul创业实验_永平.md`
|
||
> **禁止**：在业务项目 `.cursor/rules/` 重复写 W05b 正文；永平仓库仅保留跳转 stub。
|
||
|
||
## 目录铁律（Soul 永平）
|
||
|
||
| 状态 | 路径 |
|
||
|:---|:---|
|
||
| **唯一进行中** | `开发文档/1、需求/修改/Soul创业实验_永平_{YYYYMMDD}_需求.md` |
|
||
| **已完成** | `开发文档/10、项目管理/需求完成/` |
|
||
| **禁止** | `修改/` 内同时存在两个日期的需求 MD |
|
||
|
||
## 每日收口（§五c · 写死）
|
||
|
||
**新的一天或「整理需求」时 Agent 必须：**
|
||
|
||
1. 对照 **代码** 标记每条：开发 ✅/☐ · 验收 ✅/☐
|
||
2. **已完成且验收通过** → 迁入 `需求完成/`（截图 → `需求完成/images/{日期}/`）
|
||
3. **开发 ✅ 验收 ☐** → 批次索引可选在 `需求完成/`；**验收 To-do 仍留当日 MD**
|
||
4. **开发 ☐ 或验收 ☐** → **全部汇总进当日 MD**
|
||
5. 旧日 MD 迁 `需求完成/archive/` 或 `1、需求/archive/modify历史/`；**`修改/` 只留当日文件**
|
||
6. 当日 MD **文首必须是 `## To-do`**：已完成开发 `[x]` 在最前，再待开发、待验收
|
||
|
||
## 禁止误归档
|
||
|
||
- **卡若未明确说「归档/验收通过」** → 不得把 `modify/` 全文标「全部完成」迁走
|
||
- 代码 ✅ 但验收 ☐ → 留在当日 To-do「待验收」
|
||
|
||
## 当日 MD 结构
|
||
|
||
```
|
||
## To-do（置顶）
|
||
### 已完成 · 开发
|
||
### 待开发
|
||
### 待验收
|
||
## 当日需求索引
|
||
## 需求一 …
|
||
```
|
||
|
||
## 先文档后开发（提审类）
|
||
|
||
审核/双版本 → 先落盘 + 永平 `4、前端/小程序管理/references/审核与认证.md`；卡若说「开始开发」再改代码。
|
||
|
||
## 开发过程中 · 完成一条打勾一条（§五d · 强制）
|
||
|
||
按当日需求 MD 开发时，**每完成一条**（代码合入/功能可用）**立即**：
|
||
|
||
1. 当日 MD `## To-do` 对应项 `- [ ]` → `- [x]`
|
||
2. 从「待开发」移到「已完成 · 开发」；仅缺点验 → 留「待验收」
|
||
3. `## 需求X` 内验收清单同步勾选
|
||
4. 刷新「当日需求索引」开发列
|
||
|
||
**禁止**：开发会话结束仍留已合入项为 ☐。Skill 真源 §五d。
|
||
|