fire-safety-ymd/docs/project/ai-native-adoption.md

AI-NSES 采用说明

项	内容
项目	fire-safety-ymd
采用日期	2026-09-04
通用标准版本	AI-NSES 0.2
当前采用阶段	Active development

1. 目标

本项目采用 AI-NSES，将长期项目知识保存在仓库中，使人类开发者和新的 Agent 不依赖历史会话也能理解当前目标、代码边界、风险和下一步。

通用标准保持原样，项目差异放在根入口和 docs/project/ai-nses-project-overlay.md，避免 fire-safety-ymd 的规则反向污染可复用模板。

2. 本次接入的通用文件

模板来源快照：/Users/andy/IdeaProjects/th-hotel-simple/docs/import/reusable。

仅接入以下白名单内容：

• docs/import/reusable/ai-native-software-engineering-standard.md
• docs/import/reusable/general-development-guidelines.md
• docs/import/reusable/ai-native-templates/ 全目录

它们作为通用参考和新文档模板保存，不直接承担本项目当前状态说明。

3. 明确排除的来源内容

没有复制以下内容：

• TH Hotel 的 docs/project/。
• TH Hotel 的根 AGENTS.md、CONTEXT.md、PROJECT_STATE.md。
• reusable 目录中的 Java、Spring、MyBatis、前端、分页基础结构和特定集成指南。
• reusable 根 README.md，因为本 checkpoint 的复制白名单未包含它。

本仓库的项目级文档均按森林防火、Go、SuperAgent、MCP 和 PostGIS 的实际已知边界重新编写。

4. AI-NSES 目录映射

AI-NSES 职责	fire-safety-ymd 位置	采用状态
Agent 工作入口	AGENTS.md	已采用
长期项目背景	CONTEXT.md	已采用
动态项目状态	PROJECT_STATE.md	已采用
项目文档索引	docs/project/README.md	已采用
项目覆盖规则	docs/project/ai-nses-project-overlay.md	已采用
长期工程规范	docs/project/backend-development-guidelines.md	已采用
安全与权限边界	docs/project/security-access-control-boundary.md	已采用；Chat 静态联调门禁与 MCP 服务账号边界已实现，最终用户机制待设计
Domain 文档	docs/domain/	按需创建
Architecture 文档	docs/architecture/	已采用；已有原生/兼容用户对话入口和空间只读 MCP v1
Workflow 文档	docs/workflows/	已采用；已有用户对话和演练方案证据查询流程
ADR	docs/adr/	首个架构决策时创建
Spec	docs/specs/	已采用；已有原生/兼容用户对话 API、SuperAgent Open API 与空间只读 MCP Spec

Go 源码使用 cmd/、internal/ 和 pkg/，这是通用标准中 src/ 的项目级映射。

5. 项目 Definition of Ready

跨模块、数据、权限、安全或外部平台的 Feature 进入实现前必须明确：

• 目标、非目标、调用方和可测试验收标准。
• SuperAgent 或 MCP 的真实契约来源，不依据记忆猜测字段。
• 身份、区域或租户范围如何进入可信服务端上下文。
• PostgreSQL 表、字段、几何类型、SRID、数据时效和权限是否已经核验。
• 错误、超时、重试、幂等、审计和敏感信息处理方式。
• 所需测试层级和可用测试环境。

6. 项目 Definition of Done

Feature 完成时至少满足：

• 代码已 gofmt，相关测试和 go test ./... 已运行，或明确记录阻塞原因。
• 接口只返回被授权、可追踪且不泄露敏感信息的数据。
• 数据和空间计算结论有实际验证依据，没有把待确认项写成事实。
• 相关 Spec、ADR、Workflow、安全文档和 PROJECT_STATE.md 已同步。
• 没有引入 Secret、真实敏感样本、构建产物或无关用户改动。
• 交付说明包含变更清单、验证结果、剩余风险和下一 checkpoint。

7. 维护方式

• 通用 AI-NSES 升级时先比较上游快照，再单独做文档升级 checkpoint。
• 项目规则只修改项目入口或 Overlay，不直接编辑通用快照。
• PROJECT_STATE.md 每个 checkpoint 更新；稳定背景变化时才更新 CONTEXT.md。
• 采用状态或目录映射变化时更新本文。