完善AI-NSES文档治理规则

This commit is contained in:
andy
2026-07-24 10:05:28 +07:00
parent 5df2910465
commit 79fb1aef2d
12 changed files with 424 additions and 25 deletions

View File

@@ -17,6 +17,7 @@
- 当前项目状态入口位于 `PROJECT_STATE.md`
- 当前项目专属文档总索引位于 `docs/project/README.md`
- 当前项目 AI-NSES 落地说明位于 `docs/project/ai-native-adoption.md`
- 当前项目 AI-NSES 补充规则位于 `docs/project/ai-nses-project-overlay.md`,用于 V4 需求门禁、核心概念守门、需求追踪和 agent 交接。
- 当前项目专属后端规范位于 `docs/project/backend-development-guidelines.md`
- 当前项目时间设计说明位于 `docs/project/backend-time-design.md`
- 当前项目接口暴露、权限和审计边界位于 `docs/project/security-access-control-boundary.md`
@@ -38,6 +39,7 @@
- 遇到不确定的技术栈、目录、接口契约或数据模型,先确认再继续。
- 新项目初始化或技术栈升级前,必须检查前端、后端、构建工具、测试工具和运行时版本兼容性。
- 输出分层结构、目录树、数据模型、字段映射或接口示例时,必须补充中文说明,不能只依赖英文命名表达业务含义。
- 新增或变更重要 V4 需求时,必须先按 `docs/project/ai-nses-project-overlay.md` 形成或更新模板化 Spec / Change Request再安排后端、前端或测试 agent 开发;简单 bugfix 可不新建完整 Spec但必须说明目标、范围和验证方式。
- 完成 Feature 或 checkpoint 后,必须按 AI-NSES 检查 Domain、Architecture、Workflow、ADR、Spec、Project State 和安全边界文档是否需要更新;如果没有文档变化,明确说明 `No documentation changes required.`
## 3. 分支与提交
@@ -150,8 +152,9 @@ Coding agent 开始任务前应先读取:
3. `PROJECT_STATE.md`
4. `README.md`,如果存在
5. `docs/project/README.md`
6. `docs/` 中与当前任务相关的文档
7. 当前代码结构和最近 Git 状态
6. `docs/project/ai-nses-project-overlay.md`
7. `docs/` 中与当前任务相关的文档
8. 当前代码结构和最近 Git 状态
涉及接口、权限、审计、酒店隔离或敏感数据返回的改动,开始前必须阅读 `docs/project/security-access-control-boundary.md`,完成后同步更新该文档和相关前后端或第三方契约。