chore(skills): date-scope development docs

This commit is contained in:
caoxiaozhu
2026-06-25 09:25:28 +08:00
parent 23f7de6cbf
commit 4d8a606cd6
9 changed files with 110 additions and 46 deletions

View File

@@ -11,7 +11,7 @@ description: Use when working in X-Financial and the user asks to 落文档, 写
默认落点固定为:
```text
document/development/<功能目录>/
document/development/<YYYY-MM-DD>/feature/<具体功能目录>/
├── CONCEPT.md
└── TODO.md
```
@@ -21,12 +21,34 @@ document/development/<功能目录>/
## 工作流
1.阅读 `document/development` 中 2-3 组相邻或同类样例
2. 再读取本次能力相关的代码、接口、页面、测试或历史文档
3. 创建或更新 `CONCEPT.md`,先写清业务边界,再写方案和验收
4. 创建或更新 `TODO.md`,每个任务都要回链到 `CONCEPT.md` 的章节
5. 已实现或已验证的 TODO 可以勾选 `[x]`,但必须写证据
6. 交付前检查两份文档互相一致,不额外创建 README、CHANGELOG、SUMMARY
1.读取当前日期,默认使用本地日期 `YYYY-MM-DD` 作为第一层目录
2. 先阅读 `document/development` 中 2-3 组相邻或同类样例
3. 再读取本次能力相关的代码、接口、页面、测试或历史文档
4. 创建或更新 `CONCEPT.md`,先写清业务边界,再写方案和验收
5. 创建或更新 `TODO.md`,每个任务都要回链到 `CONCEPT.md` 的章节
6. 已实现或已验证的 TODO 可以勾选 `[x]`,但必须写证据
7. 交付前检查两份文档互相一致,不额外创建 README、CHANGELOG、SUMMARY。
## 路径规则
- 第一层必须是日期目录,例如 `document/development/2026-06-25/`
- 第二层固定是 `feature/`,表示当天沉淀的功能点集合。
- 第三层是具体功能点目录,每个独立功能点一个目录。
- 每个具体功能点目录内只放 `CONCEPT.md``TODO.md` 两个核心文件。
- 如果一次请求包含多个互不依赖的功能点,拆成多个兄弟目录:
```text
document/development/2026-06-25/feature/
├── receipt-folder-ocr/
│ ├── CONCEPT.md
│ └── TODO.md
└── risk-review-nudge/
├── CONCEPT.md
└── TODO.md
```
- 如果用户明确指定日期,使用用户指定日期;否则使用当前本地日期。
- 如果是更新历史文档,先查找已有目录并原地更新,不自动迁移旧路径。
## 目录命名
@@ -96,8 +118,8 @@ TODO 条目规则:
## 验收检查
- 两个文件都位于 `document/development/<功能目录>/`
- `CONCEPT.md``TODO.md` 都存在。
- 新建文档路径符合 `document/development/<YYYY-MM-DD>/feature/<具体功能目录>/`
- `CONCEPT.md``TODO.md` 都存在于同一个具体功能点目录
- TODO 的 `[CONCEPT: ...]` 都能在 CONCEPT 中找到对应章节或语义段落。
- 已勾选项都有证据。
- 文档没有遗留模板占位符,例如 `<功能名>``<YYYY-MM-DD>``待补充`