feat: add design principles and compatibility rollout assessment

README.md

@@ -32,6 +32,8 @@ Agent 先调查再提问，纠正有证据的错误判断，每轮维护精简
 
 计划列出修改文件、目标、原因和验收要求，不预写详细实现代码。核心算法可附少量代码或伪代码帮助审查；具体实现由执行 agent 在已批准的行为和架构边界内自主决定。
 
+方案与实施遵循最小改动、单一职责和开闭原则，按需采用设计模式；保持功能模块边界，通用架构能力不绑定具体业务，避免为套模式增加抽象，以降低扩展和审查复杂度。
+
 审阅确认后自行开启新会话，指定已批准的计划：
 
 ```text
@@ -42,6 +44,8 @@ Agent 先调查再提问，纠正有证据的错误判断，每轮维护精简
 
 执行时允许增加必要测试或配置文件并说明理由；涉及业务、接口、架构或其他范围扩展时，需更新计划并确认。验证和 review 通过后创建本地提交，不 push。
 
+计划预先评估兼容性，执行结果根据实际改动复核接口、数据、配置及新旧版本影响。结果明确是否需要特殊上线步骤和顺序；需要时提供前置条件、顺序、验证点及必要回退限制，无需时明确说明，未知项如实标注。上线评估不等于实际部署授权。
+
 ## 资产约定
 
 首次未指定资产目录时会询问；之后从项目 `.agent/MEMORY.md` 复用。这个文件只保存必要定位信息，通过 Git 本地 exclude 排除，不修改项目共享 `.gitignore`。已被跟踪时会先报告冲突，不自行取消跟踪。

skills/align-plan/SKILL.md

@@ -40,6 +40,7 @@ description: 通过调查和多轮问答对齐工程目标，生成待审阅计
 - 每轮共 1–3 个影响目标、验收或取舍的问题，不能用子问题变相扩充。可查事实不问用户，依赖未决答案的问题后置；有提问工具则使用，否则直接问。
 - 简述证据与推荐理由，不用装饰性 emoji。纠正错误事实，区分假设与偏好；用户提出想法不等于确认方案。
 - 优先复用现有能力，选择满足目标的最小方案。出现独立子目标或明显扩大的改造时，说明扩大点、建议分阶段，由用户选择；未确认前保持原范围。
+- 设计遵循最小改动、单一职责和开闭原则，按实际变化点采用合适设计模式；隔离功能模块，通用架构能力不耦合具体业务规则。以降低扩展和审查复杂度为准，不为套模式新增无必要抽象或扩大重构。
 - 目标、边界、关键取舍和验收明确后停止提问。
 
 ## 写入、审阅与交接
@@ -50,6 +51,7 @@ description: 通过调查和多轮问答对齐工程目标，生成待审阅计
 2. **目标与决策**：原始目标、当前/目标行为、保留行为、不做事项；决策理由、业务/接口/架构变化或不变；相关系统约束快照及状态、已确认假设。
 3. **修改范围**：新增/修改/删除的文件、各自目标和原因、必要依赖顺序及对应验收。允许必要测试/配置配套文件并记录，其他范围变化重新确认。
 4. **验证**：验收条件、对应测试、运行目录/命令/预期结果与必要环境。
+5. **兼容与上线**：评估受影响的接口、数据、配置及新旧版本兼容性；明确是否需要迁移、特殊上线步骤或先后顺序，必要时说明回退限制。无特殊要求则注明，未知项列为待核实。
 
 不预写详细实现代码；仅核心算法可附少量审查片段，执行 agent 可自主选择满足已批准约束的实现。
 

skills/execute-plan/SKILL.md

@@ -33,11 +33,12 @@ description: 执行用户指定的已批准工程计划，验证目标与范围
 
 - CONTEXT 只记录已确认且当前有效的业务约束、技术约束，可注明适用模块及必要原因；不放待实施方案、废弃决策、历史计划路径、任务、代码或日志。目标为“保存系统当前业务与技术约束”，时间为最近确认决策日期。局部编码选择不提升为系统约束。
 - 对照 CONTEXT 与计划：无关更新继续，其他实质冲突先澄清。实施、验证及 review 完成后，重读 CONTEXT，用本次落实的约束替换失效规则，保留无关的有效约束；失败或部分完成不提前更新，不记录状态变迁或旧规则。
-- 执行记录仅保留任务状态、配套文件及理由、关键验证命令/结果、阻塞与偏差，不粘贴完整工具日志。恢复会话或压缩后重读 CONTEXT、计划和执行状态；无变化时复用已读内容。
+- 执行记录仅保留任务状态、配套文件及理由、关键验证命令/结果、兼容性与上线要求、阻塞与偏差，不粘贴完整工具日志。恢复会话或压缩后重读 CONTEXT、计划和执行状态；无变化时复用已读内容。
 
 ## 实施边界
 
 - 每项改动对应批准任务或验收；优先复用现有能力，自主决定具体代码及内部组织，不要求计划提供详细代码或逐字照抄算法示例。
+- 在最小改动范围内遵循单一职责、开闭原则，按需应用设计模式；避免功能模块耦合及通用架构能力依赖业务规则，降低扩展与审查复杂度，不为模式引入无必要抽象。
 - 可补必要测试/配置文件并说明对应验收；其他文件扩展、业务/接口/架构变化或依赖升级须先确认，不能包装为配套改动。无关发现只记录，不顺手修复或重构。
 - 需变更范围时直接更新同一 plan.md，仅保留最新方案；清除旧批准依据并标待确认，对话只给摘要、原因及链接。用户重新批准后继续，不生成版本副本或历史方案，也不事后改计划掩盖越界。完成前重读文件，若内容已变而未重新批准，先澄清。
 
@@ -45,7 +46,8 @@ description: 执行用户指定的已批准工程计划，验证目标与范围
 
 1. 完成后重新完整读取原目标与批准计划，对照任务 diff：验收是否满足、保留行为是否成立、是否越界、是否影响调用方与错误路径。
 2. 运行计划要求及改动必要的检查，覆盖验收与回归风险。复用已有测试，补真实缺口，不堆重复用例或强制覆盖率；文档变更用适当结构检查。记录实际证据，无变化且无新疑点时不重复运行。
-3. Review 范围与正确性，修复本任务问题后重跑受影响检查。越界内容仅撤销能可靠隔离的自身改动。未解决失败或环境阻碍如实报告，不宣称通过、不绕过检查提交；用户调整验证要求时记录差异。
+3. Review 范围、正确性和模块职责/依赖边界，修复本任务问题后重跑受影响检查。越界内容仅撤销能可靠隔离的自身改动。未解决失败或环境阻碍如实报告，不宣称通过、不绕过检查提交；用户调整验证要求时记录差异。
+   根据实际 diff 与证据复核接口、数据、配置及新旧版本兼容性。需要特殊上线操作时列出前置条件、步骤顺序、验证点及必要回退限制；否则明确“无需特殊上线步骤或顺序”。未知或未验证部分如实标注，不把本地测试通过等同于上线兼容。涉及计划外迁移或行为变化时先更新计划并确认；评估不授权实际部署。
 4. 仅暂存本任务文件/片段，检查完整暂存 diff，确保不含用户原有改动、MEMORY 或讨论资产。无法隔离或 MEMORY 已被跟踪时先解决，不擅自取消跟踪。
 5. 按项目规范创建本地 commit；不 push、amend、跳过 hooks 或改 Git 身份。Hook 改动须重新检查验证。无差异不空提交，非 Git 项目不自行初始化；提交失败报告原因。
-6. 核实 commit hash、提交文件及工作区残余，更新外部记录；简报交付、验证、配套变化/批准偏差、限制及 hash（或未提交原因）。
+6. 核实 commit hash、提交文件及工作区残余，更新外部记录；简报交付、验证、兼容性结论、特殊上线步骤及顺序（或无需）、配套变化/批准偏差、限制及 hash（或未提交原因）。详细上线说明留在记录中并给链接。