AGENTS.md

@@ -67,10 +67,14 @@
 
 ## 文档与交接
 
-- 文档按任务、行为变化或项目约定维护；注释解释意图与约束，项目指引只记录已确认的事实，不额外生成无关文档或备份。
+- 文档按任务、行为变化或项目约定按需维护；注释解释意图与约束，项目指引只记录已确认的事实，不额外生成无关文档或备份。
-- 仅在已授权执行且交接信息无法从代码、Git 历史或已有文档恢复时，创建或更新 `CONTEXT.md`；简单修改无需记录。
+- `CONTEXT.md` 是跨会话交接快照，而非变更日志；仅在已授权执行且关键信息无法从代码、Git 历史或已有文档恢复时创建或更新，简单修改无需记录。
-- 交接内容原位更新，保留有效目标、决策及理由、未完成事项和风险，标注未验证信息，删除过时状态；当前状态不超过 100 行，全文不超过 500 行。
+- 新会话接续任务时，按需读取 `CONTEXT.md` 及其引用的关键文件，并结合代码和 Git 状态核实，不将历史记录直接视为当前事实。
-- 保留 `CONTEXT.md` 原有跟踪策略：本地专用文件继续忽略，不擅自停止跟踪已纳入版本控制的文件。
+- 交接内容保留当前目标与进度、关键决策及理由、已否决方案及原因、用户约束、环境注意事项、未解决风险和下一步；已完成里程碑仅保留必要摘要，不重复记录实现细节和变更历史。
+- 内容应准确、自包含；必要的路径、命令、报错和配置值保留原文，无法核实的信息标注 `[未核实]`，不得记录密码、密钥或 Token。
+- 目标、进度、决策或风险发生重要变化时，按需原位更新；及时清理过时状态、已完成事项和已解决风险，避免内容重复或相互矛盾。
+- 当前状态不超过 100 行，全文不超过 500 行；超限时优先压缩历史记录，长期有效的项目规则归入 `AGENTS.md`，详细设计归入现有文档。
+- 保留 `CONTEXT.md` 原有 Git 跟踪策略：本地专用文件继续忽略，不擅自停止跟踪已纳入版本控制的文件。
 
 ## 项目定位与工具链