agent-project-maplisted

<!-- [变更日志] 修改时间：2026-09-17 AI模型：GLM (CodeBuddy) 修改内容：[v1.0：设计契约 6 条扩为 8 条（#5 分层可再生、#6 待确认双机制、#7 产物区标注约定、#8 歧义标准）；Phase 1 新增准则文件探测默认值；Phase 4 常量区清单更新；Phase 5 三类裁决扩为四类（新增饿死风险）；Phase 6 规则 3 补产物区豁免代价说明；新增 Phase R 逃生舱；自检体系从四层升级为六层；技能更名 scan-project-map → agent-project-map（GitHub 查重零撞车，守护卖点前置至 description 首句）；aiservice 项目实测反馈修复：Phase 3 清单禁登工具数据目录（.codebuddy/.claude 等 skills 安装位置），防工具重装后的声明失效误报；v1.1：自检脚本双运行时——新增 Node 兼容版模板（Python 主版/JS 镜像，六层断言功能等价），Phase 0 检测运行时并优雅降级，Phase 4/5 按运行时适配] --> # Scan Project Map — 项目地图生成器 你的任务：为目标项目生成 `project-map.md`（项目地图）+ `scripts/test_project_map.py`（六层自检脚本），并把地图接入该项目的 AI 行为准则文件。**地图是�� AI 用的外部记忆：只回答"在哪、什么任务去哪"，绝不回答"怎么实现、进展如何"。** ## 设计契约（八条红线，写图前必读，写图后写进地图头部防未来模型好心改坏） 1. **卖语义不卖结构**：AI 随时能列目录，结构是免费信息。地图唯一的商品是列目录拿不到的隐性知识——职责、读取时机、陷阱。**严禁贴完整文件树。** 2. **粒度锁目录级**：只写目录职责 + 5~8 个入口文件。日常文件级变更打不穿地图，只有结构性手术（目录增删移）才触发更新义务。维护成本是设计出来的，不靠自觉。 3. **只路由不复制**：凡有机器事实源的信息（网关/构建配置、package.json、建表 SQL、启动脚本），地图只写"真相在那里"，绝不复制内容。**尤其不写精确行数、文件数、占比等机器可秒算的数据。** 复制 = 制造第二事实源 = 制造未来冲突。 4. **权威分层**：地图的【结构声明】以文件系统为准（脚本校验）；【职责语义】在被用户推翻前有效（人守护）。这让过时地图只是降效，不会成为幻觉源。 5. **分层可再生**：【结构声明】可从文件系统重新推导，最坏情况是重写而非数据损失；【语义层】（职责、时机、陷阱）唯一事实源是人——整体重写前必须导出旧语义层由用户逐条裁决，严禁静默丢弃。 6. **禁止猜测 + 待确认双机制**：未查明的目录一律标【待确认】，编造语义比留盲区更毒。机器发现的（自检红灯建议追加的）用清单块内联 `# 【待确认】` 标记（补语义时删掉，超 5 条红灯）；人主动登记的走地图第 6 节。两处勿混用。 7. **产物区标注约定**：运行产物/资源目录在清单块内用 `# 产物区` 或 `# 资源区` **开头**的注释标注，自检脚本据此豁免存在性检查（fresh clone 无产物目录不算失效）。目录性质唯一事实源是地图清单，脚本常量 `IGNORE` 只放纯机械缓存。 8. **歧义标准**：机器只做无歧义的记账（已存在的事实可登记）；凡涉删除、豁免、保留历史的裁决一律红灯上浮给人。这是断言层与 Ph