GenarrativeAI/Genarrative
11
0
Fork 0
Code Issues 18 Pull Requests 3 Actions Packages Projects 3 Releases Wiki Activity
Files
840a62f7d0f350be6ab891d55be7eb489dfa3853
Genarrative/docs/project-memory/shared-memory/document-map.md
T
kdletters 96b45e6ffc
Project CI / Repository checks (push) Successful in 2m55s
Details
Project CI / Frontend tests (push) Successful in 3m25s
Details
Project CI / Backend tests (push) Successful in 6m32s
Details
Project CI / Native shell tests (push) Successful in 17m43s
Details
规范化历史文档并合入 AGC 插件宿主能力 (#339) 
## 变更

- 建立文档生命周期与现状索引，统一 `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>
2026-09-13 16:21:34 +08:00

3.5 KiB
Raw Blame History

文档地图与阅读索引

更新时间：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（仅存量旧链路）
  6. docs/technical/【技术方案】DirectProject Codex原始历史与异常恢复-2026-09-04.md
  7. docs/technical/【技术方案】DirectProject客户端Skill与MCP扩展导入方案-2026-08-31.md
  8. docs/prd/【AI游戏创作】项目开发工作台PRD-2026-07-20.md
  9. docs/technical/【技术方案】立项策划Agent（Fast GDD）-2026-08-10.md
  10. docs/technical/【技术方案】DirectProject本轮附件路径映射-2026-08-31.md
  11. docs/technical/【技术方案】Direct回合行为审计账本-2026-08-31.md
  12. docs/technical/【技术方案】GameAgent资源自由画板与快速编辑-2026-08-20.md
  13. docs/【技术方案】UI工作流资源桥接与Runtime执行-2026-08-24.md
  14. 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；不为历史文件做无关批量重命名。
Reference in New Issue View Git Blame Copy Permalink