chore(skills): date-scope development docs

hermes/skills/domain/write-development-docs/SKILL.md

@@ -1,33 +1,60 @@
 ---
 name: write-development-docs
-description: 为 X-Financial 落地开发文档。Use when a task asks to write, create, update, or standardize planning/development documentation under document/development, especially when the expected output is a CONCEPT.md capability document plus a TODO.md implementation checklist following this repository's existing development-doc format.
+description: Use when working in X-Financial and the user asks to 落文档, 写开发文档, 沉淀方案, 补 concept/todo, or create/update planning documentation under document/development for a feature, refactor, page, algorithm, rule, or business capability.
 ---
 
 # Write Development Docs
 
 ## 目标
 
-使用本技能为一个功能、重构、算法、页面或业务能力创建标准开发文档。
-默认输出位置：
+把一个功能、重构、算法、页面或业务能力沉淀为项目标准开发文档。
+默认落点固定为：
 
 ```text
-document/development/<feature-slug>/
+document/development/<YYYY-MM-DD>/feature/<具体功能点目录>/
 ├── CONCEPT.md
 └── TODO.md
 ```
 
+如果用户说 `concept.md` / `todo.md`，也按仓库现有规范使用大写文件名
+`CONCEPT.md` 和 `TODO.md`。
+
 ## 工作流
 
-1. 先阅读相邻或同类文档，优先参考 `document/development/*/CONCEPT.md` 和 `document/development/*/TODO.md`。
-2. 读取与本次能力相关的代码、接口、页面、测试或历史文档，不凭空写实现细节。
-3. 创建或更新 `CONCEPT.md`，先写清能力边界，再写方案和验收。
-4. 创建或更新 `TODO.md`，每个任务必须能回链到 `CONCEPT.md` 的章节。
-5. 如果已有实现，TODO 可以勾选 `[x]`，但必须写证据；没有验证的任务保持 `[ ]`。
-6. 完成后检查两份文档是否互相一致，避免 TODO 承诺了 CONCEPT 没定义的能力。
+1. 先读取当前日期，默认使用本地日期 `YYYY-MM-DD` 作为第一层目录。
+2. 先阅读 `document/development` 中 2-3 组相邻或同类样例。
+3. 再读取本次能力相关的代码、接口、页面、测试或历史文档，不凭空写实现细节。
+4. 创建或更新 `CONCEPT.md`，先写清能力边界，再写方案和验收。
+5. 创建或更新 `TODO.md`，每个任务必须能回链到 `CONCEPT.md` 的章节。
+6. 如果已有实现，TODO 可以勾选 `[x]`，但必须写证据；没有验证的任务保持 `[ ]`。
+7. 完成后检查两份文档是否互相一致，避免 TODO 承诺了 CONCEPT 没定义的能力。
+
+## 路径规则
+
+- 第一层必须是日期目录，例如 `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
+```
+
+- 如果用户明确指定日期，使用用户指定日期；否则使用当前本地日期。
+- 如果是更新历史文档，先查找已有目录并原地更新，不自动迁移旧路径。
 
 ## 命名规则
 
-- 目录名使用小写 kebab-case，例如 `receipt-folder`、`agent-trace-center`。
+- 优先复用用户指定目录名或已有目录名。
+- 新增英文目录用小写 kebab-case，例如 `receipt-folder`、`agent-trace-center`。
+- 新增中文目录可直接用清晰中文能力名，例如“费用审批动态路由”。
 - 能力名在正文中使用清晰中文，例如“票据夹功能”“Agent 链路追踪中心”。
 - 两个文件名固定为 `CONCEPT.md` 和 `TODO.md`。
 - 不额外创建 README、CHANGELOG、SUMMARY 等文件，除非用户明确要求。
@@ -102,8 +129,8 @@ TODO 条目规则：
 
 交付前检查：
 
+- 新建文档路径符合 `document/development/<YYYY-MM-DD>/feature/<具体功能点目录>/`。
 - `CONCEPT.md` 和 `TODO.md` 都存在。
 - TODO 的 `[CONCEPT: ...]` 都能在 `CONCEPT.md` 找到对应章节或语义段落。
 - 已勾选项都有证据。
 - 文档没有遗留模板占位符，例如 `<功能名>`、`TODO`、`待补充`。
-- 文档路径位于 `document/development/<feature-slug>/`。