kdletters
96b45e6ffc
## 变更 - 建立文档生命周期与现状索引，统一 `current`、`historical`、`review`、开放事项和活动计划边界。 - 为历史/待复核文档补充状态头，将有源码与测试证据的专题纳入当前入口。 - 新增规范驱动开发 skill 与 `check:doc-index` 门禁，并接入 `lint`。 - 合入 `origin/master` 的 AGC 通用插件宿主与 Cocos Creator 编辑器能力，并补充父子规范关系和验收范围。 ## 合并说明 - 合入基线：`origin/master` `4a46f89c9`。 - 合并提交：`259134b59`。 - 合并过程无冲突。 ## 验证 - `npm run check:doc-index` - `npm run check:encoding` - `git diff --check` - `python -X utf8 C:/Users/kdletters/.codex/skills/.system/skill-creator/scripts/quick_validate.py .codex/skills/spec-driven-development` - 推送前 pre-push master 门禁通过。 ## CI 请以本 PR 的 Gitea CI 检查为准；提交后持续关注，失败时按失败 job 继续修复。 Reviewed-on: #339 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>
62 lines
3.5 KiB
Markdown
62 lines
3.5 KiB
Markdown
# 文档地图与阅读索引
|
||
|
||
更新时间：`2026-08-31`
|
||
|
||
## 阅读顺序
|
||
|
||
通用复杂任务：
|
||
|
||
1. `AGENTS.md`
|
||
2. `docs/【协作规范】Agent工作入口与执行准则-2026-06-22.md`
|
||
3. `docs/【协作规范】规范驱动开发工作流-2026-09-12.md`（跨模块或公开合同任务）
|
||
4. `docs/【协作规范】文档生命周期与现状索引-2026-09-12.md`
|
||
5. `docs/README.md`
|
||
6. `docs/project-memory/shared-memory/`
|
||
7. 与任务匹配的当前专题合同
|
||
|
||
后端 / 数据真相 / SpacetimeDB：
|
||
|
||
1. `docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md`
|
||
2. `docs/【开发运维】本地开发验证与生产运维-2026-05-15.md`
|
||
3. `server-rs/crates/api-server/src/app.rs`、`server-rs/crates/api-server/src/modules.rs` 与对应 crate README / 源码
|
||
4. `docs/openapi/genarrative-external-v1.openapi.json`（涉及 External v1 时）
|
||
|
||
AI 游戏创作 / DirectProject / UI workflow：
|
||
|
||
1. `docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md`
|
||
2. `docs/technical/【技术方案】策划会话RuntimeV2接入与旧链路退役-2026-09-03.md`
|
||
3. `docs/technical/【技术方案】DirectProject客户端Skill与MCP扩展导入方案-2026-08-31.md`
|
||
4. `docs/prd/【AI游戏创作】项目开发工作台PRD-2026-07-20.md`
|
||
5. `docs/technical/【技术方案】立项策划Agent（Fast GDD）-2026-08-10.md`（仅存量旧链路）
|
||
2. `docs/technical/【技术方案】DirectProject Codex原始历史与异常恢复-2026-09-04.md`
|
||
3. `docs/technical/【技术方案】DirectProject客户端Skill与MCP扩展导入方案-2026-08-31.md`
|
||
4. `docs/prd/【AI游戏创作】项目开发工作台PRD-2026-07-20.md`
|
||
5. `docs/technical/【技术方案】立项策划Agent（Fast GDD）-2026-08-10.md`
|
||
6. `docs/technical/【技术方案】DirectProject本轮附件路径映射-2026-08-31.md`
|
||
7. `docs/technical/【技术方案】Direct回合行为审计账本-2026-08-31.md`
|
||
8. `docs/technical/【技术方案】GameAgent资源自由画板与快速编辑-2026-08-20.md`
|
||
9. `docs/【技术方案】UI工作流资源桥接与Runtime执行-2026-08-24.md`
|
||
10. UI 编辑器、宿主壳和当前测试专题文档
|
||
|
||
图片画布 / 媒体生成：
|
||
|
||
1. `docs/technical/【技术方案】客户端素材创作无限画布阶段一合同-2026-08-05.md`
|
||
2. `docs/【编辑器】图片画布结构化持久化与迁移回滚方案-2026-07-19.md`
|
||
3. `docs/technical/【后端架构】编辑器生成结果原子提交与幂等重放方案-2026-08-06.md`
|
||
4. `docs/【编辑器】画板音乐生成入口设计-2026-06-18.md`
|
||
|
||
生产部署 / 服务器 / Jenkins：
|
||
|
||
1. `docs/【开发运维】本地开发验证与生产运维-2026-05-15.md`
|
||
2. `docs/technical/【开发运维】Jenkins容器预览部署控制面技术方案-2026-08-15.md`
|
||
3. `deploy/` 当前脚本、systemd unit、Nginx README 和实际主机状态
|
||
|
||
## 生命周期规则
|
||
|
||
- `docs/README.md` 是人工阅读入口；代码和当前专题冲突时，以代码和最新专题为准。
|
||
- `shared-memory/` 只保留稳定事实、唯一决策、通用流程和已验证坑点。
|
||
- `plans/` 只保留正在执行且有明确下一门禁的计划；完成或作废后删除或融合。
|
||
- `todos/` 只保留真实开放、有人负责且有关闭条件的事项；退役对象不保留未来准入 TODO。
|
||
- 一次性实施记录、阶段测试数字、分支历史和旧方案不进入长期入口，追溯使用 Git 历史。
|
||
- 新增 Markdown 文件名使用 `【标签名】中文标题-YYYY-MM-DD.md`；不为历史文件做无关批量重命名。
|