chore(skills): date-scope development docs
This commit is contained in:
@@ -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>`、`待补充`。
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
interface:
|
||||
display_name: "开发文档落地"
|
||||
short_description: "按项目格式生成 CONCEPT 和 TODO 文档"
|
||||
default_prompt: "Use $write-development-docs to create CONCEPT.md and TODO.md under document/development for an X-Financial feature."
|
||||
short_description: "按日期和功能点生成 CONCEPT/TODO"
|
||||
default_prompt: "Use $write-development-docs to create CONCEPT.md and TODO.md under document/development/<date>/feature/<feature-point> for an X-Financial feature."
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
更新时间:<YYYY-MM-DD>
|
||||
|
||||
文档路径:document/development/<YYYY-MM-DD>/feature/<具体功能点目录>/CONCEPT.md
|
||||
|
||||
## 功能一句话
|
||||
|
||||
用一句话说明这个能力解决什么问题、服务谁、交付什么结果。
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
更新时间:<YYYY-MM-DD>
|
||||
|
||||
文档路径:document/development/<YYYY-MM-DD>/feature/<具体功能点目录>/TODO.md
|
||||
|
||||
## 使用规则
|
||||
|
||||
- 每个 TODO 必须对应 `CONCEPT.md` 中的目标、能力、方案或验收点。
|
||||
|
||||
Reference in New Issue
Block a user