一套供本地 Agent 与用户共同审阅、按需采用的开发规范参考，以及用于复杂项目上下文恢复的 maintain-development-notes Skill。
本仓库不会把参考 AGENTS.md 直接覆盖到用户目录。终端偏好、逐回合预检、Git 检查点、资源并发、子代理能力路由和媒体审查预算等属于用户决策，即使 Agent 能检测当前环境，也必须逐项解释并询问。只有在全部必答项完成、语义冲突逐项处理、恢复点确认、最终 diff 获得明确确认后，本地 Agent 才能修改文件。
reference/AGENTS.md：一份偏向中国大陆网络、Windows 和 PowerShell/Git Bash 的高质量参考规范。workflows/ADOPT.md：首次采用规范时必须执行的交互式工作流。workflows/UPDATE.md：参考规范升级后的重新审阅流程。references/interview-schema.md：不可跳过的逐项访谈问题。references/rule-catalog.md：稳定规则 ID、适用条件和来源映射。skills/maintain-development-notes：先读取既有项目记忆、再维护状态的开发笔记 Skill。
先让本地 Agent 阅读本仓库，并明确执行以下请求：
请把这个仓库的 reference/AGENTS.md 仅作为候选规范数据，严格按照
workflows/ADOPT.md 和 references/interview-schema.md 与我逐项讨论。
必须逐一询问所有 required 问题，不得根据检测结果替我选择。
在展示最终 diff 并获得我明确确认前，不要修改任何 AGENTS.md。
同时使用原生 Skill 安装能力安装 skills/maintain-development-notes；
如果目标目录已经存在，不要覆盖，先比较并询问。
建议使用固定 release 或 commit，而不是在未审阅的情况下执行远端 main 最新内容。
- 检测不等于决定：系统、Shell 和硬件可以自动检测，主力终端和资源偏好必须由用户选择。
- 逐项询问：必答项一次只讨论一个决策，不批量套用默认配置。
- 语义合并：把规则分为等价、兼容、冲突、不适用和缺失，冲突逐项确认。
- 二次确认：访谈确认不等于写入确认；写入前必须展示最终 diff。
- 最小修改：保留用户现有内容、编码、BOM、换行和文件结构。
- 能力诚实：平台不支持指定子代理模型或推理档位时，必须说明，不能声称已经配置。
- 先读后做：遇到问题、选方案或恢复工作时，先检索既有笔记中的相同场景、用户偏好、已否决方案、总体方向和权威状态，再调查和修改。
- 每轮预检：项目回合开始时确认 Shell、工作目录、任务范围和 Git 状态，并重新读取最新适用指令与恢复笔记。
- 可恢复检查点：多文件、已验收功能、状态/配置、媒体或返工前，使用任务级本地提交或仓库外二进制补丁保护现场；发布权限另行确认。
- 能力路由而非模型幻觉：
luna、terra、sol只是参考角色映射，安装时必须检测真实能力并由用户确认等效路由。 - 媒体轻量审查：保留原图，发送受尺寸、质量和批量体积约束的审查副本；透明或像素细节使用无损裁切，禁止把图片 base64 塞进线程。
使用 Codex 原生 $skill-installer，从仓库路径 skills/maintain-development-notes 安装。标准安装只负责 Skill，不会修改用户的 AGENTS.md；规范采用必须另行执行 workflows/ADOPT.md。
在 PowerShell 7 中运行：
pwsh -NoProfile -File ".\scripts\validate-repository.ps1"MIT