feat: persist system constraints in root CONTEXT.md

2026-09-10 10:45:20 +08:00
parent c0ec550309
commit 4171713a9c
3 changed files with 39 additions and 6 deletions
@@ -10,7 +10,7 @@ description: 在新会话中读取用户指定的已确认工程计划，按范
 ## 开始前

 1. 完整读取计划，提取原始目标、已批准行为、保留行为、文件范围、步骤和验收条件。未给路径且无法从本次明确引用确定时询问路径，不猜“最新计划”。
-2. 读取目标项目约束、相关代码和测试，核对项目定位、Git 基线与工作区。路径变化时通过仓库身份和内容确认，不仅凭同名目录执行。基线提交变化不必自动阻塞：调查是否影响计划成立的前提；存在实质冲突再澄清。
+2. 从计划定位信息或项目 `.agent/MEMORY.md` 确定系统资产根目录，先读取该目录的 `CONTEXT.md`，再读取目标项目约束、相关代码和测试。只给计划目录且根目录未知时询问，不推断父目录、不扫描历史计划。定位信息互相冲突或 CONTEXT 属于其他系统时先澄清。文件不存在时依靠自包含计划与代码核实，不凭空补系统约束。核对项目定位、Git 基线与工作区；路径变化时通过仓库身份和内容确认，不仅凭同名目录执行。基线提交变化不必自动阻塞：调查是否影响计划成立的前提；存在实质冲突再澄清。
 3. 检查计划的确认状态及依据；缺少批准、存在关键遗漏或当前代码使计划失效时，展示具体缺口并取得澄清。不得把“执行这个未完成的草稿”当作所有隐含决策都已确定，也不对已有有效批准重复索要确认。
 4. 记录实施前分支、HEAD（或尚无提交）、暂存、未暂存和未跟踪文件，保留足够的基线信息区分用户已有改动。不能覆盖、回退或替用户提交无关内容。若与任务重叠且无法可靠隔离，先解决冲突。
 5. 实施记录默认写在指定计划旁的独立 `execution-日期时间.md`，包含计划版本、基线、进度和证据，不覆盖已有记录。严格遵循用户指定位置：资产根目录下最多增加一层 `<日期-计划主题>/`，不插入项目名或系统名目录；用户已指定计划目录时直接使用。该位置必须符合用户的外部资产约定；位置不明时读取 `.agent/MEMORY.md` 或询问。目录不可用时报告问题，不回退到代码目录，不把资产混入 Git 提交。
@@ -29,6 +29,13 @@ description: 在新会话中读取用户指定的已确认工程计划，按范

 若当前会话还保留规划讨论，提醒用户新会话约定；不能假称已经清空上下文。无论宿主是否能识别会话边界，都以计划和重新读取的代码为依据。宿主处于只读或计划模式时遵从限制，不执行变更。

+## 系统约束核对与维护
+
+- 对比 CONTEXT 当前约束、待生效约束和计划中的约束快照。无关更新不阻塞执行；计划已明确批准从当前规则迁移到待生效规则时按计划实施。其他实质冲突先展示影响并澄清，不能机械认定文档或计划中某一份总是优先。
+- 只记录用户已确认、跨计划适用的业务与设计约束，确认后即可写入根目录 CONTEXT，依赖实施的规则标为“已确认待生效”。agent 自主决定的局部编码细节只属实现，不写成系统约束。
+- CONTEXT 按业务约束、设计约束组织，每条只保留约束、适用范围、简短原因和生效状态；不写任务清单、代码、执行日志或完整历史。沿用资产 YAML 格式，目标为“保存系统长期有效的业务与设计约束”，时间为最近一次确认系统决策的日期。
+- 本次实施、验证及 review 完成后，才将已落实的待生效约束标为“当前有效”，移除被其替代的失效规则。失败或部分完成时不提前标为有效。更新前重读 CONTEXT，保留其他计划的内容；仅更新生效状态不改决策日期，不改原批准计划。
+
 ## 实施边界

 - 按计划依赖顺序推进；每项改动必须能解释为完成一个批准任务或验收条件。优先复用代码库、标准库和平台现有能力。
@@ -37,7 +44,7 @@ description: 在新会话中读取用户指定的已确认工程计划，按范
 - 可补充达成已批准目标所必需的测试或配置文件，在实施记录中说明文件、原因及对应验收条件。文件扩展不能成为更改业务行为、公共接口、架构、升级依赖或扩大验收范围的借口。
 - 其他未计划的文件改动或实质范围变化，先展示所需变化与原因，取得确认后保存补充计划或新版本，再继续受影响工作。保留原批准版本，不为解释已发生的越界改动而重写计划。
 - 发现无关问题时只在记录中注明“本次未处理”；不要顺手重构、清理、格式化整个仓库或修复旁支问题。
- 记录任务进度、必要配套文件、验证命令和结果。恢复会话或上下文压缩后重新读取原计划与实施记录，不从聊天印象续做。
+- 记录任务进度、必要配套文件、验证命令和结果。恢复会话或上下文压缩后重新读取 CONTEXT、原计划与实施记录，不从聊天印象续做。

 ## 验证与 Review