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>
3.6 KiB
3.6 KiB
团队协作约定
协作模式
- 3 名开发人员在各自环境使用本地 Agent，通过同一 Git 仓库同步代码和项目知识。
- 每个任务保持分支、工作树和修改范围清晰；多人或多 Agent 并行修改前先划分不重叠的文件边界。
- 项目知识进入
docs/与docs/project-memory/；个人~/.codex、Agent 会话和本地配置不共享。
开发前
- 同步目标分支并确认工作树状态，不覆盖他人的未提交修改。
- 阅读
AGENTS.md；复杂任务继续读取 Agent 执行准则、项目概览、本文、开发工作流和当前专题文档。 - 以源码、
package.json、Cargo manifest、app.rs、OpenAPI 和生成契约核对易漂移事实；RAG 与历史记录只提供候选上下文。 - 文档不足以确定字段、状态、迁移或验收时，先补当前权威文档再编码。
- 跨模块功能、公开契约、SpacetimeDB schema、AGC/Runtime 和复杂 UI 状态链路先建立主规范、里程碑规范和单里程碑实现计划，并在评审通过后实现。
开发中
- 修改范围保持聚焦；优先扩展现有系统、页面、组件、DTO 和脚本，不新建平行入口或业务真相。
- UI 开发优先复用现有公共组件；跨页面或跨端重复的视觉/交互模式应沉淀到
packages/shared，由现有页面迁移使用，禁止在业务页复制同类 UI。共享组件只承载通用表现与交互，不下沉领域规则、后端副作用或正式业务状态。 - 后端遵循
module-*、spacetime-module、spacetime-client、api-server、platform-*、shared-contracts的现役边界。 - 前端只负责表现、交互和临时 UI 状态；正式状态来自后端投影、API 或持久化契约。
- 对已明确退役且无现役调用方、公开契约、持久化迁移或活跃实例的对象，不写兼容实现、维持旧行为的测试、墓碑注释或墓碑文档。
- 修改
/api/external/v1时，同批更新docs/openapi/genarrative-external-v1.openapi.json与契约测试。 - 修改 SpacetimeDB schema 时遵守字段追加/default 约束，同步 migration、表目录、生成绑定，并运行 schema 检查；删除、改名、重排或改类型前先确认迁移计划。
- 日志不递归输出完整配置、应用状态或 provider client；新增字段默认不进入安全摘要。
- 中文文案、注释和文档保持 UTF-8，优先局部补丁，不擅自翻译成英文。
文档生命周期
docs/README.md只索引当前实现依据和仍维护专题。shared-memory/只保留当前稳定概览、决策、流程和坑点；同一事实不复制多份版本。plans/只放正在执行且有明确剩余门禁的短期计划；todos/只放真实开放且有关闭条件的事项。- 计划完成、事项关闭或对象退役后，稳定结论融合进权威专题或共享记忆，过程文档直接删除；历史由 Git 提供。
- 新增 Markdown 使用
【标签名】中文标题-YYYY-MM-DD.md命名。
开发后
- 运行范围匹配的测试、类型检查、
npm run check:encoding和git diff --check。 - 更新对应当前专题；产生长期有效变化时再更新共享记忆。
- 检查 staged diff，确保没有无关文件、密钥、本地路径或他人改动。
- 提交标题使用中文；标题后逐行写明修改项，每项单独一行。
禁止提交
.env、API Key、Token、Cookie、认证文件和个人配置。- 个人绝对路径、会话记录、隐私信息。
- 构建产物、日志、缓存和数据库 dump。
- 已完成计划、阶段测试数字、分支合并流水账和已失效实现口径。