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

@@ -10,9 +10,18 @@
- 验证:`frontmatter ok``required files ok``.codex/skills/write-development-docs``[TODO:]` 初始化占位符,`git diff --check -- .codex/skills/write-development-docs .gitignore` 通过。
- 影响:以后用户说“落文档 / 写开发文档 / 补 concept 和 todo”时可以优先触发仓库级技能按项目格式生成两份开发文档。
- 09:23我按新的目录约定升级了 `write-development-docs` 技能。
- Git 提交检查:`git fetch --all --prune` 后未发现 upstream 新提交;本地 ahead 1 个提交,为本会话前一步生成的 `23f7de6c chore(skills): add development docs writer`
- 修改:`.codex/skills/write-development-docs``hermes/skills/domain/write-development-docs` 同步新增路径规则,默认落点调整为 `document/development/<YYYY-MM-DD>/feature/<具体功能点目录>/CONCEPT.md + TODO.md`
- 修改:两个技能副本的 `agents/openai.yaml``assets/CONCEPT.md``assets/TODO.md` 同步补充日期、`feature` 聚合层和具体功能点目录提示。
- 操作:保留历史文档原地更新规则,避免把 `document/development` 既有旧路径自动搬迁。
- 验证:两个 `SKILL.md` frontmatter 分别校验通过,路径规则检索命中,两个技能副本的模板和 UI 元数据 diff 一致,`git diff --check -- .codex/skills/write-development-docs hermes/skills/domain/write-development-docs` 通过。
- 影响:后续新功能落文档会先按日期建目录,再进入 `feature`,最后按具体功能点独立建目录,便于按天回溯和按功能点拆分。
## 遗留问题
- 09:18官方 `quick_validate.py` 仍因当前 Python 环境缺少 `PyYAML` 无法运行,已用 frontmatter、必需文件、占位符和 diff check 做人工兜底。建议后续统一为 skill 校验脚本补齐依赖或增加无 PyYAML 的轻量校验路径。
- 09:23当前环境没有找到 Skill Creator 的 `quick_validate.py` 脚本文件本体,因此本次继续采用人工兜底校验。建议后续恢复系统 Skill Creator 脚本路径,或把轻量校验脚本纳入仓库级工具。
## TODO