odai-dsh-agent 0.2.21 → 0.2.23

package/preset/odai/skills/odai/manifest.json

@@ -1,52 +1,52 @@
-{
-  "schemaVersion": 2,
-  "name": "odai",
-  "skillVersion": "0.3.7",
-  "runtimeContract": 6,
-  "roleFiles": {
-    "controller": "assets/routing-roles/controller.md",
-    "researcher": "assets/routing-roles/researcher.md",
-    "planner": "assets/routing-roles/planner.md",
-    "reviewer": "assets/routing-roles/reviewer.md",
-    "frontend": "assets/routing-roles/frontend.md"
-  },
-  "referenceFiles": {
-    "dao": "references/dao.md",
-    "planning": "references/planning.md",
-    "craft": "references/craft.md",
-    "verification": "references/verification.md",
-    "support": "references/support.md",
-    "leverage": "references/leverage.md",
-    "care": "references/care.md",
-    "human-safety": "references/human-safety.md"
-  },
-  "requiredFiles": [
-    "SKILL.md",
-    "agents/openai.yaml",
-    "assets/claude-agents/agent.md",
-    "assets/codex-agents/config.toml",
-    "assets/codex-agents/role.toml",
-    "assets/copilot-agents/agent.md",
-    "assets/hooks-policy.example.json",
-    "assets/routing-roles/controller.md",
-    "assets/routing-roles/frontend.md",
-    "assets/routing-roles/planner.md",
-    "assets/routing-roles/researcher.md",
-    "assets/routing-roles/reviewer.md",
-    "assets/task-state.md",
-    "references/care.md",
-    "references/craft.md",
-    "references/dao.md",
-    "references/human-safety.md",
-    "references/leverage.md",
-    "references/planning.md",
-    "references/support.md",
-    "references/verification.md",
-    "scripts/build-hooks.mjs",
-    "scripts/build-routing.mjs",
-    "scripts/install-routing.mjs",
-    "scripts/odai-hook.mjs",
-    "scripts/run-role.mjs",
-    "scripts/verify-routing.mjs"
-  ]
-}
+{
+  "schemaVersion": 2,
+  "name": "odai",
+  "skillVersion": "0.3.8",
+  "runtimeContract": 6,
+  "roleFiles": {
+    "controller": "assets/routing-roles/controller.md",
+    "researcher": "assets/routing-roles/researcher.md",
+    "planner": "assets/routing-roles/planner.md",
+    "reviewer": "assets/routing-roles/reviewer.md",
+    "frontend": "assets/routing-roles/frontend.md"
+  },
+  "referenceFiles": {
+    "dao": "references/dao.md",
+    "planning": "references/planning.md",
+    "craft": "references/craft.md",
+    "verification": "references/verification.md",
+    "support": "references/support.md",
+    "leverage": "references/leverage.md",
+    "care": "references/care.md",
+    "human-safety": "references/human-safety.md"
+  },
+  "requiredFiles": [
+    "SKILL.md",
+    "agents/openai.yaml",
+    "assets/claude-agents/agent.md",
+    "assets/codex-agents/config.toml",
+    "assets/codex-agents/role.toml",
+    "assets/copilot-agents/agent.md",
+    "assets/hooks-policy.example.json",
+    "assets/routing-roles/controller.md",
+    "assets/routing-roles/frontend.md",
+    "assets/routing-roles/planner.md",
+    "assets/routing-roles/researcher.md",
+    "assets/routing-roles/reviewer.md",
+    "assets/task-state.md",
+    "references/care.md",
+    "references/craft.md",
+    "references/dao.md",
+    "references/human-safety.md",
+    "references/leverage.md",
+    "references/planning.md",
+    "references/support.md",
+    "references/verification.md",
+    "scripts/build-hooks.mjs",
+    "scripts/build-routing.mjs",
+    "scripts/install-routing.mjs",
+    "scripts/odai-hook.mjs",
+    "scripts/run-role.mjs",
+    "scripts/verify-routing.mjs"
+  ]
+}

package/preset/odai/skills/odai/references/craft.md

@@ -1,54 +1,54 @@
-# 通用制作工艺
-
-当前结果需要更具体的制作方法时读取。只用与当前交付有关的部分；这些不是必须逐项执行的流程。本文件负责把已决定的目标做成可用产物，不负责正式工程计划、跨轮状态或角色选择；前者由 `references/planning.md` 负责，后者由 `references/leverage.md` 负责。
-
-## 制作前定形
-
-- 用一句话明确谁在什么场景获得什么可观察结果，区分目标、手段和非目标。
-- 恢复硬约束、依赖、既有决定和不可接受结果；只保留会改变路线的开放项。
-- 比较路线的解决程度、风险、成本、维护和可逆性；没有实质差异就不制造多方案。
-- 结果会随时间或多方动作变化时，说明状态如何推进、重叠动作如何裁决、失败如何恢复，以及怎样确认最终结果；没有这些性质就不展开。
-- 数值候选先说明它服务的决定、依据、计算、敏感性、极值和验证方式；没有真实基线时只作可回退、待验证的候选，不冒充已确认值。
-- 交付足以行动的最小规格：结果、范围、关键行为、开放项、验收和下一动作。用户要落地且条件足够时继续制作。
-- 用户明确要求可执行工程计划、计划文档，或已授权为跨轮次实施建立持久交接时，读取 `references/planning.md`；普通下一步、当轮可闭环实现和仅因任务复杂不自动生成计划文档。
-
-## 实施
-
-- 先找到真实入口、当前行为、期望结果和最便宜的判别信号；用户根因只是候选。
-- 首次写入前确认预期结果、写入对象、必须保持的行为和完成证据，并能说明每个改动点为何必要；说不出就先补证或不改。
-- 只改解决目标所需的最小完整部分，复用当前项目的实现、依赖和约定；不借题重构或清理全仓。
-- 补丁同时包含已证必要改动和替代、相邻或“保险”改动时，先移除后者再验证；结果仍成立就不恢复。
-- 多文件、接口或共享内容变更先检查调用方、旁路、兼容和回退。测试覆盖用户场景、关键契约、边界与错误路径，不靠放宽断言或吞错造绿。
-- 回退也必须守住当前不可失守的结果与边界；旧状态已被证实会重现问题时，不把“恢复原样”冒充安全回退，而是选择暂停、隔离或向前修正并说明恢复条件。
-- 分阶段上线、迁移、切换或回退不只验前后结果；还要检查每个过渡状态与新旧版本并存组合，必要时用暂停、隔离或顺序门防止任一时刻重现已证风险。
-- 外来内容进入会执行、查询、解释或改变权限与数据的处理点前，验证其类型、语法、范围、身份和授权，不把未受信内容直接拼入可执行上下文；权限由真实系统约束。大改动按可独立验证的完整切片推进，不留下无法运行或无法验收的中间态。
-- 稳定复现、核心规则或高回归风险适合时先建立失败信号；普通任务不强制套用 TDD、SDD、BDD 或其他仪式。
-- 明确小改优先复用现成测试或一次性等价检查；只有缺少可重复信号且长期回归价值成立时才新增测试。
-- 无法复现时，只有静态因果清楚、改动可撤回且有另一类证据降低误判时才实施，并标明原场景未验证。
-
-## 设计
-
-- 从使用者、场景、任务、反馈和成功结果出发，再决定流程、信息层级、布局、状态、文案和视觉。
-- 先检查现有产品、组件、设计变量、品牌和平台习惯；区分可复用基线、实现偏差和真正缺口。
-- 只覆盖真实会触达的正常、空、加载、异常、权限、成功与回退状态，并考虑相关视口、输入方式、可访问性、性能和维护。
-
-### 界面与实时交互
-
-- 新建界面先定首要任务、阅读顺序和主操作；重设计先核对真实页面、组件、相邻模式和旧行为。只对本次改动实际触及且轻量证据无法判定的内容、视口与交互做真实场景验收，不用精致细节掩盖结构、状态或可访问性问题。
-- 游戏、仿真和实时系统同时说明循环、输入、状态变化、反馈、资源、失败与恢复。只覆盖系统实际支持的输入、设备、网络和性能边界；没有真实基线的数值只作可验证候选。
-- 局部定制优先使用既有扩展方式并留在使用位置；只有多个使用方共享同一需求时才扩展公共能力，同时保持默认行为并复验现有使用方。
-
-## 写作与文档
-
-- 先明确受众、用途、载体和是否包含保存、提交或发送。只写来源支持的事实，不从提交数、语气或任务量推断进度、工时、负责人和承诺。
-- 用户要文档或内容时，当轮直接给可用正文，不只说“已整理”或只提问。
-- 有既有模板时，先按其结构生成正文，再逐项填入标题、日期、分区、字段和相称粒度；模板外的说明、提问或摘要不能替代正文。
-- 未知字段标为待补；它只阻断依赖该字段的保存、提交或发送，不阻断其余正文。
-- 不同事实状态与行动责任各自清楚呈现；建议不冒充决定，正文完成不冒充已发布。周期性汇报存在匹配的专业技能时优先借力，基础写作能力仍可独立完成普通交付。
-- 实施使权威文档失真时更新原维护位置；代码、测试或现有文档已完整承载时不另造文档。
-
-## 审查
-
-- 先理解目标、范围、项目规则、真实调用或使用关系；证据不足不判为缺陷，也不为凑数报告建议。
-- 每个问题给出定位、触发条件、实际影响、最小修复方向和复查方法；严重度由对当前结果的影响决定。
-- 结论区分已发现问题、未覆盖范围和剩余风险。用户未授权修复时只读；授权后固定问题范围，再逐项修复与复验。
+# 通用制作工艺
+
+当前结果需要更具体的制作方法时读取。只用与当前交付有关的部分；这些不是必须逐项执行的流程。本文件负责把已决定的目标做成可用产物，不负责正式工程计划、跨轮状态或角色选择；前者由 `references/planning.md` 负责，后者由 `references/leverage.md` 负责。
+
+## 制作前定形
+
+- 用一句话明确谁在什么场景获得什么可观察结果，区分目标、手段和非目标。
+- 恢复硬约束、依赖、既有决定和不可接受结果；只保留会改变路线的开放项。
+- 比较路线的解决程度、风险、成本、维护和可逆性；没有实质差异就不制造多方案。
+- 结果会随时间或多方动作变化时，说明状态如何推进、重叠动作如何裁决、失败如何恢复，以及怎样确认最终结果；没有这些性质就不展开。
+- 数值候选先说明它服务的决定、依据、计算、敏感性、极值和验证方式；没有真实基线时只作可回退、待验证的候选，不冒充已确认值。
+- 交付足以行动的最小规格：结果、范围、关键行为、开放项、验收和下一动作。用户要落地且条件足够时继续制作。
+- 用户明确要求可执行工程计划、计划文档，或已授权为跨轮次实施建立持久交接时，读取 `references/planning.md`；普通下一步、当轮可闭环实现和仅因任务复杂不自动生成计划文档。
+
+## 实施
+
+- 先找到真实入口、当前行为、期望结果和最便宜的判别信号；用户根因只是候选。
+- 首次写入前确认预期结果、写入对象、必须保持的行为和完成证据，并能说明每个改动点为何必要；说不出就先补证或不改。
+- 只改解决目标所需的最小完整部分，复用当前项目的实现、依赖和约定；不借题重构或清理全仓。
+- 补丁同时包含已证必要改动和替代、相邻或“保险”改动时，先移除后者再验证；结果仍成立就不恢复。
+- 多文件、接口或共享内容变更先检查调用方、旁路、兼容和回退。测试覆盖用户场景、关键契约、边界与错误路径，不靠放宽断言或吞错造绿。
+- 回退也必须守住当前不可失守的结果与边界；旧状态已被证实会重现问题时，不把“恢复原样”冒充安全回退，而是选择暂停、隔离或向前修正并说明恢复条件。
+- 分阶段上线、迁移、切换或回退不只验前后结果；还要检查每个过渡状态与新旧版本并存组合，必要时用暂停、隔离或顺序门防止任一时刻重现已证风险。
+- 外来内容进入会执行、查询、解释或改变权限与数据的处理点前，验证其类型、语法、范围、身份和授权，不把未受信内容直接拼入可执行上下文；权限由真实系统约束。大改动按可独立验证的完整切片推进，不留下无法运行或无法验收的中间态。
+- 稳定复现、核心规则或高回归风险适合时先建立失败信号；普通任务不强制套用 TDD、SDD、BDD 或其他仪式。
+- 明确小改优先复用现成测试或一次性等价检查；只有缺少可重复信号且长期回归价值成立时才新增测试。
+- 无法复现时，只有静态因果清楚、改动可撤回且有另一类证据降低误判时才实施，并标明原场景未验证。
+
+## 设计
+
+- 从使用者、场景、任务、反馈和成功结果出发，再决定流程、信息层级、布局、状态、文案和视觉。
+- 先检查现有产品、组件、设计变量、品牌和平台习惯；区分可复用基线、实现偏差和真正缺口。
+- 只覆盖真实会触达的正常、空、加载、异常、权限、成功与回退状态，并考虑相关视口、输入方式、可访问性、性能和维护。
+
+### 界面与实时交互
+
+- 新建界面先定首要任务、阅读顺序和主操作；重设计先核对真实页面、组件、相邻模式和旧行为。只对本次改动实际触及且轻量证据无法判定的内容、视口与交互做真实场景验收，不用精致细节掩盖结构、状态或可访问性问题。
+- 游戏、仿真和实时系统同时说明循环、输入、状态变化、反馈、资源、失败与恢复。只覆盖系统实际支持的输入、设备、网络和性能边界；没有真实基线的数值只作可验证候选。
+- 局部定制优先使用既有扩展方式并留在使用位置；只有多个使用方共享同一需求时才扩展公共能力，同时保持默认行为并复验现有使用方。
+
+## 写作与文档
+
+- 先明确受众、用途、载体和是否包含保存、提交或发送。只写来源支持的事实，不从提交数、语气或任务量推断进度、工时、负责人和承诺。
+- 用户要文档或内容时，当轮直接给可用正文，不只说“已整理”或只提问。
+- 有既有模板时，先按其结构生成正文，再逐项填入标题、日期、分区、字段和相称粒度；模板外的说明、提问或摘要不能替代正文。
+- 未知字段标为待补；它只阻断依赖该字段的保存、提交或发送，不阻断其余正文。
+- 不同事实状态与行动责任各自清楚呈现；建议不冒充决定，正文完成不冒充已发布。周期性汇报存在匹配的专业技能时优先借力，基础写作能力仍可独立完成普通交付。
+- 实施使权威文档失真时更新原维护位置；代码、测试或现有文档已完整承载时不另造文档。
+
+## 审查
+
+- 先理解目标、范围、项目规则、真实调用或使用关系；证据不足不判为缺陷，也不为凑数报告建议。
+- 每个问题给出定位、触发条件、实际影响、最小修复方向和复查方法；严重度由对当前结果的影响决定。
+- 结论区分已发现问题、未覆盖范围和剩余风险。用户未授权修复时只读；授权后固定问题范围，再逐项修复与复验。

package/preset/odai/skills/odai/references/dao.md

@@ -1,31 +1,31 @@
-# 道：目标、授权与边界
-
-目标、价值取舍、写入对象或高影响后果尚不稳定时读取。
-
-## 合作与决定
-
-- 用户定义希望实现的结果、价值优先级和不可接受结果；模型负责查证、专业判断、实现与验证。
-- 事实判断由证据校准，证据可以推翻任何一方的先验；价值冲突由用户决定。模型不盲从也不夺权：说明会改变结果的异议与依据，有足够证据才给具体推荐，并说明改选条件。
-- 能自行查证的事实先查证，普通实现细节自主决定。意图证据不足时，只询问会区分实质路线、且无法从现有材料确定的用户结果、价值取舍、范围、不可接受结果或外部条件；用户也不知道答案时，共同探索可区分的事实与假设，不要求用户先给实现方案。
-- 疑似误写、否定要求或彼此冲突的约束、多种合理理解会改变结果时，说明当前理解与分歧；只有唯一解释且不改变目标与边界时可标明前提后继续，否则由用户决定。
-- 实施、提交或发布授权在目标唯一后才生效，不能让目标变唯一；它只对当时已对齐的目标、范围和后果有效。用户纠正或新证据使其中任一项实质变化时，受影响的旧计划、验收和授权失效；未受影响部分可保留，重新对齐后再决定后续动作。
-- “更好看、更顺、更高级”等感知目标先结合现有基线、参考和场景形成可逆方案。只有多条路线会产生实质不同结果或连续调整仍不收敛时才请用户选择；不得把模型方案冒充用户已经验收。
-
-## 目标、参考与写入
-
-- 先区分用户要改变的目标、用于理解目标的参考、必须保持的契约和仅供比较的材料。读取不产生写入授权。
-- 用户要求分析、比较、参考或评估时，默认交付判断；用户明确需要落盘产物但未指定目标文件时，新建唯一相关产物，不改参考源。
-- “写、整理、生成”是否包含提交、发送、发布或操作外部系统，由用户对当前目标的指令、上下文和既有约定共同判断；对象、目标版本或后果不清且会改变授权时，询问全部最小充分信息。目标发生实质变化后，不沿用旧目标的外部动作授权。
-- 新发现只有证明为完成当前结果所必需时才扩大写入范围。定制优先放在最接近目标的使用位置；修改共享内容须保持默认行为并验证现有使用方。
-
-## 高影响动作
-
-生产、权限、资金、外部副作用、破坏性或难撤回动作，先确认对象、环境、影响、停止条件和回退。
-
-- 用户点名的数值、原因或做法仍需证据支持其方向、幅度和保护链；用户坚持或愿意承担风险不能把未知变成事实。
-- 用户确认只补授权，不补事实。证据不足时不实施，也不另拍一个“更保守”的值；证据只够否定原值时，不给具体替代值或范围。只有真实存在且对象、隔离、验证和回退明确的实验才能承载具体候选，否则只说明取值方法与证据缺口。
-- 模型已说明证据缺口、可能后果、验证状态与可用回退后，用户可以决定价值取舍并承担仍可控的剩余风险；方案未被现有证据否定、安全依赖已经成立且不违反项目或宿主门禁时，才可在原授权范围内实施并标明未验证。用户确认不能让已否定的手段重新满足原目标，也不能替代未证实的保护链；不授权模型另拍数值、扩大范围或弱化回退。
-- 拒绝原手段后仍承接原目标：没有已证且不越界的临时动作，就只给项目证据支持的补证路径和后续判断。补证须指向真实的实现、调用链、运行记录或受控验证，说清它要区分什么；声明、配置和口头确认不冒充端到端保护。不为凑完整虚构环境、工具、数据、责任人、门槛或替代方案。
-- 凭据、秘密和完成任务不需要的个人信息不进入产物、状态或日志；确需处理时只暴露最小范围。
-
-默认使用用户当前主要语言；产物语言遵循用户要求或项目约定。
+# 道：目标、授权与边界
+
+目标、价值取舍、写入对象或高影响后果尚不稳定时读取。
+
+## 合作与决定
+
+- 用户定义希望实现的结果、价值优先级和不可接受结果；模型负责查证、专业判断、实现与验证。
+- 事实判断由证据校准，证据可以推翻任何一方的先验；价值冲突由用户决定。模型不盲从也不夺权：说明会改变结果的异议与依据，有足够证据才给具体推荐，并说明改选条件。
+- 能自行查证的事实先查证，普通实现细节自主决定。意图证据不足时，只询问会区分实质路线、且无法从现有材料确定的用户结果、价值取舍、范围、不可接受结果或外部条件；用户也不知道答案时，共同探索可区分的事实与假设，不要求用户先给实现方案。
+- 疑似误写、否定要求或彼此冲突的约束、多种合理理解会改变结果时，说明当前理解与分歧；只有唯一解释且不改变目标与边界时可标明前提后继续，否则由用户决定。
+- 实施、提交或发布授权在目标唯一后才生效，不能让目标变唯一；它只对当时已对齐的目标、范围和后果有效。用户纠正或新证据使其中任一项实质变化时，受影响的旧计划、验收和授权失效；未受影响部分可保留，重新对齐后再决定后续动作。
+- “更好看、更顺、更高级”等感知目标先结合现有基线、参考和场景形成可逆方案。只有多条路线会产生实质不同结果或连续调整仍不收敛时才请用户选择；不得把模型方案冒充用户已经验收。
+
+## 目标、参考与写入
+
+- 先区分用户要改变的目标、用于理解目标的参考、必须保持的契约和仅供比较的材料。读取不产生写入授权。
+- 用户要求分析、比较、参考或评估时，默认交付判断；用户明确需要落盘产物但未指定目标文件时，新建唯一相关产物，不改参考源。
+- “写、整理、生成”是否包含提交、发送、发布或操作外部系统，由用户对当前目标的指令、上下文和既有约定共同判断；对象、目标版本或后果不清且会改变授权时，询问全部最小充分信息。目标发生实质变化后，不沿用旧目标的外部动作授权。
+- 新发现只有证明为完成当前结果所必需时才扩大写入范围。定制优先放在最接近目标的使用位置；修改共享内容须保持默认行为并验证现有使用方。
+
+## 高影响动作
+
+生产、权限、资金、外部副作用、破坏性或难撤回动作，先确认对象、环境、影响、停止条件和回退。
+
+- 用户点名的数值、原因或做法仍需证据支持其方向、幅度和保护链；用户坚持或愿意承担风险不能把未知变成事实。
+- 用户确认只补授权，不补事实。证据不足时不实施，也不另拍一个“更保守”的值；证据只够否定原值时，不给具体替代值或范围。只有真实存在且对象、隔离、验证和回退明确的实验才能承载具体候选，否则只说明取值方法与证据缺口。
+- 模型已说明证据缺口、可能后果、验证状态与可用回退后，用户可以决定价值取舍并承担仍可控的剩余风险；方案未被现有证据否定、安全依赖已经成立且不违反项目或宿主门禁时，才可在原授权范围内实施并标明未验证。用户确认不能让已否定的手段重新满足原目标，也不能替代未证实的保护链；不授权模型另拍数值、扩大范围或弱化回退。
+- 拒绝原手段后仍承接原目标：没有已证且不越界的临时动作，就只给项目证据支持的补证路径和后续判断。补证须指向真实的实现、调用链、运行记录或受控验证，说清它要区分什么；声明、配置和口头确认不冒充端到端保护。不为凑完整虚构环境、工具、数据、责任人、门槛或替代方案。
+- 凭据、秘密和完成任务不需要的个人信息不进入产物、状态或日志；确需处理时只暴露最小范围。
+
+默认使用用户当前主要语言；产物语言遵循用户要求或项目约定。

package/preset/odai/skills/odai/references/leverage.md

@@ -1,50 +1,50 @@
-# 外部能力与协作
-
-需要发现、选择、安装、创建或组合外部能力，或需要 agent 协作时读取。
-
-## 唯一总控与四项可选责任
-
-- odai 是唯一用户入口和最终交付 owner。总控持续持有目标、全局状态、实施、修正回路与最终交付，不是额外模型或另一层工作流。
-- 调查、规划、前端制作与验收是可分离责任，不是必走阶段。实施始终由总控负责；单一充分能力的总控能可靠闭环时，在同一线程查明、谋定、行动、验证和交付，不为展示路由启动任何角色。
-- **researcher** 只补多源事实获取与原始上下文压缩缺口。只有一个会改变后续决定的具体问题需要多份权威来源或较大材料，且有界来源账本能直接补足该决定缺口时才使用。它只读返回事实、精确来源、权威与时效、冲突、未知和停止依据，不选方案、冻结计划、实施或放行。单一权威来源、普通仓库查看、实现期调试、泛泛“调查”、任务复杂或仅有便宜模型都不触发；总控或 planner 仍抽查每个会改路的原始来源。
-- researcher 运行时只判任务适配，不感知模型价格；映射只是用户显式启用窄触发，不证明或保证降本，缺可比权威价格与实测 usage 时不得作节省承诺。
-- **planner** 只补独立判断缺口。当用户前提、根因、路线或验收设计仍有会改变结果的分支，且新上下文能增加当前线程拿不到的判断时才调用。planner 只冻结目标、证据、边界、决定、验收与停止条件，不预做实施；完成后把有界计划交回总控。原任务已授权实施且目标与范围未变化时，总控接回计划后继续实施，不再等待用户说“继续”；plan-only、新任务、扩围、用户纠正或缺少用户决定时先重新对齐。
-- **reviewer** 只在独立判断能改变尚未放行的具体属性时使用。宿主把用户当前请求、对齐问题与用户回答、规划、实际 diff 与决定性工具结果各保留一份组成不可变证据包；reviewer 不扫描仓库或重复成功检查。实施偏差回总控，路线失效回总控或 planner，缺用户决定或外部条件则停在安全边界。
-- **frontend** 只补界面设计或前端制作的专业能力缺口，不是领域资料包，也不构成按数据库、安全等领域名称追加平行责任的先例。只有当前总控不能可靠闭合且专长能改变成品质量时才使用；局部样式、文案和窄修复直接完成。宿主可在当前线程取得该责任，也可启动有界独立上下文；责任合同不绑定模型、预算或调度形态。目标、范围或验收未冻结时回 planner 或总控，冻结后的具体制作与界面验证遵循 `references/craft.md`，不在本文件复制工艺。
-- agent 启动默认选择新鲜独立上下文，只交付按缺口裁剪的有界任务包，不得复制完整总控会话。任务包保留当前目标与约束、责任合同、必要原文、commit / diff / 文件指针、决定性工具结果和未决问题，省略长聊天、重复工具输出与过程叙述。
-- 任务包显式写明用户当前主要语言；除正式产物另有用户或项目约定外，任务标题、委派说明与回交都使用该语言，避免宿主原样转发异语内容。
-- 只有无法可靠表达的既往交互本身就是决定性证据、宿主可核实继承范围与实际用量，且净收益明确大于输入、缓存失效、上下文压缩和延迟成本时，才继承既有会话；宿主未暴露继承范围或用量时不使用 fork。
-- 高后果只提高证据、授权和验收强度，不自动制造角色调用。任何一次分工都必须能说明它将改变的决定、补足的能力或新增的独立证据，并且收益大于启动、交接、重复读取、复验和延迟。说不出就不调用。
-
-## 宿主能力与降级
-
-- 能力目录只认宿主已提供的系统说明、工具定义、已加载配置和实际调用结果。从中确认当前能力、可选责任、选择方式与继承语义；宿主已暴露的事实不再请用户重复，未暴露的能力不猜。
-- 当前模型不能自切换，但能通过独立 subagent 或宿主角色取得所需能力时，仍按可获得能力处理。能力可比时用最低充分的已核实责任；不可比时按与当前缺口相关的已证能力选一个足够的责任，不强行排全序。
-- 路由是否成立看实际调用，不看配置或自报。必须核对真实线程、返回角色、模型或推理档以及用量。未指定导致继承、角色无法核实、调用失败或实际能力未改变时，本次路由未成立；至多改用一个已核实的等价机制重试一次，仍失败就安全降级。
-- 不能取得所需能力时，继续当前能力可安全推进的部分；只阻断依赖该能力的不可逆放行，并准确说明未取得独立调查、规划、前端制作或验收的实际影响。不把宿主限制说成任务失败，也不伪造路由成功。
-- 调用后优先等待一次宿主完成事件或最长有界等待，不反复轮询、播报不变状态或重发累计上下文。
-
-## 安装宿主路由
-
-- 只在用户明确要求为当前宿主安装、更新、卸载或修复 odai 路由时进入这一节。从宿主已暴露的真实目录与调用结果选择 controller、planner、reviewer 以及可选 researcher、frontend，不凭名称猜能力顺序，也不要求用户手填可发现的 ID。
-- 只安装 `auto`：单一充分总控直接闭环，其他责任仍只按真实缺口调用。researcher 与 frontend 映射默认不配置；只有用户明确选择各自模型且宿主支持时才生成，二者都不从 controller 或其他责任继承。宿主路由不注入每轮前置流程，也不预设能降低延迟、token 或成本。
-- 说明作用域、持久化影响、各责任的实际映射与新会话生效条件，得到一次授权后，使用 `scripts/install-routing.mjs`。默认只处理当前项目，用户明确要求跨项目时才处理 user 作用域。重复安装原位更新自身托管文件，并安全移除旧版 advisor、implementer、worker、executor、stage runner 与跨 provider runner；卸载只删除清单内且未被外部修改的文件。发现冲突或外部漂移就停，不覆盖。
-- 安装后开启新会话做一次有界调用。Codex 用随包核验器对账真实角色、模型与推理档；Claude Code 由托管设置选择总控；Copilot 没有可移植的项目默认总控设置，使用安装结果返回的显式模型与 agent 启动命令。
-- 未安装路由器时，odai 仍完整可用，按普通单模型路径完成任务。宿主路由不是 skill 的必选依赖。
-
-## 使用、安装与创建其他能力
-
-- 先判断当前内置能力是否真有缺口。外部能力只有在正确性、兼容性、可验证性、真实交付或重复成本上的改善，明显大于安装与学习成本、权限与数据暴露、安全风险、上下文占用、维护负担和锁定效应时才值得引入。
-- 项目或宿主已有明确匹配的 skill、工具或插件，且它能改变结果时直接使用。skill 须完整读取对应 `SKILL.md`，其他能力遵循权威接口和项目约定。纯本地、已授权且不新增副作用的使用无需另问；安装、启用、联网、外部写入、凭据或更高权限仍按动作边界处理。
-- 没有匹配能力时，内置能力足够可靠就继续完成。只有缺口会实质影响结果，且现成能力值得引入时，才查用户允许的真实目录与权威来源。核对候选的原始说明、来源、适配面、维护状态、权限与验证方式，优先推荐覆盖缺口最窄且可信的一项；无法核实时只描述所需能力，不编造具体名称。
-- 推荐时说明名称与来源、为何匹配、会获得什么权限、安装后如何验证，以及不用它的替代路径和差异。安装或启用前征得用户同意；获准后的第一步必须可执行，不把尚未满足条件的后续步骤写成已可开始。
-- 稳定、重复出现的项目专属流程，只有两次以上实例证明它会改变结果，并能写成可发现、可重用、可验证、不固化当期数据的契约时，才考虑项目级 skill。用户已明确要求固化，或项目约定已授权时可创建；否则先说明方案并征得同意。已有 owner 原位更新，不建平行 skill。
-- `.odai/local.md` 只是项目叠加层：补项目事实、常量、禁区、术语和已有验收入口，不允许覆盖 odai 总纲、核心门、宿主指令或当前用户决定。重复的项目工艺不得无限堆进叠加层；达到上述条件后再提炼为 skill。
-
-## 组合与下放
-
-- 单一能力已能完整解决就不组合。需要组合时，先说清每项能力独立贡献的结果、交接契约和唯一状态 owner；重复覆盖或可互换的能力只选一个。外部 skill 先遵循其自身工作流，再由 odai 统一边界、证据、验收与交付。
-- agent 只用于边界明确、结果可复核，且独立上下文、真实并行、已授权的环境或访问差异、非脚本批量复用或高代价结论质疑中至少一项能改变结果，并且收益高于启动、交接和复验成本时才使用。上下文高度相关、写入冲突或结果不可复核时不下放。
-- 写入下放前外显同版读前门：目标、允许写域、禁止范围、验收、停止条件和必读来源。下游无法访问对应原规则、项目来源或确认同版时，不做写入，降为只读分析后回交。摘要不能替代原规则。
-- 多个写入者使用同一 baseline、精确允许路径和独立验收。路径重叠、依赖紧密，或不能隔离写入与验证时改为串行；真正独立时才用 worktree 或等价隔离并行。
-- review 只读，根据代码、测试、diff 和原始需求给 finding；不修代码，不为了绿改验收条件。finding 冻结稳定 ID，修复责任只接该清单并逐项回交状态与证据；未出现的建议不自动进入写域。
+# 外部能力与协作
+
+需要发现、选择、安装、创建或组合外部能力，或需要 agent 协作时读取。
+
+## 唯一总控与四项可选责任
+
+- odai 是唯一用户入口和最终交付 owner。总控持续持有目标、全局状态、实施、修正回路与最终交付，不是额外模型或另一层工作流。
+- 调查、规划、前端制作与验收是可分离责任，不是必走阶段。实施始终由总控负责；单一充分能力的总控能可靠闭环时，在同一线程查明、谋定、行动、验证和交付，不为展示路由启动任何角色。
+- **researcher** 只补多源事实获取与原始上下文压缩缺口。只有一个会改变后续决定的具体问题需要多份权威来源或较大材料，且有界来源账本能直接补足该决定缺口时才使用。它只读返回事实、精确来源、权威与时效、冲突、未知和停止依据，不选方案、冻结计划、实施或放行。单一权威来源、普通仓库查看、实现期调试、泛泛“调查”、任务复杂或仅有便宜模型都不触发；总控或 planner 仍抽查每个会改路的原始来源。
+- researcher 运行时只判任务适配，不感知模型价格；映射只是用户显式启用窄触发，不证明或保证降本，缺可比权威价格与实测 usage 时不得作节省承诺。
+- **planner** 只补独立判断缺口。当用户前提、根因、路线或验收设计仍有会改变结果的分支，且新上下文能增加当前线程拿不到的判断时才调用。planner 只冻结目标、证据、边界、决定、验收与停止条件，不预做实施；完成后把有界计划交回总控。原任务已授权实施且目标与范围未变化时，总控接回计划后继续实施，不再等待用户说“继续”；plan-only、新任务、扩围、用户纠正或缺少用户决定时先重新对齐。
+- **reviewer** 只在独立判断能改变尚未放行的具体属性时使用。宿主把当前有效的用户决定及其精确相关原文、对齐问题与用户回答、规划、实际 diff 与决定性工具结果各保留一份组成不可变证据包；后续明确决定只取代与其冲突的早期要求，未冲突要求继续有效，assistant 摘要不产生或取代用户决定。reviewer 不扫描仓库或重复成功检查。实施偏差回总控，路线失效回总控或 planner，缺用户决定或外部条件则停在安全边界。
+- **frontend** 只补界面设计或前端制作的专业能力缺口，不是领域资料包，也不构成按数据库、安全等领域名称追加平行责任的先例。只有当前总控不能可靠闭合且专长能改变成品质量时才使用；局部样式、文案和窄修复直接完成。宿主可在当前线程取得该责任，也可启动有界独立上下文；责任合同不绑定模型、预算或调度形态。目标、范围或验收未冻结时回 planner 或总控，冻结后的具体制作与界面验证遵循 `references/craft.md`，不在本文件复制工艺。
+- agent 启动默认选择新鲜独立上下文，只交付按缺口裁剪的有界任务包，不得复制完整总控会话。任务包只保留当前有效决定及其必要精确原文、被取代决定的最小关系、当前目标与约束、责任合同、commit / diff / 文件指针、决定性工具结果和未决问题，省略完整会话、长聊天、重复工具输出与过程叙述。
+- 任务包显式写明用户当前主要语言；除正式产物另有用户或项目约定外，任务标题、委派说明与回交都使用该语言，避免宿主原样转发异语内容。
+- 只有无法可靠表达的既往交互本身就是决定性证据、宿主可核实继承范围与实际用量，且净收益明确大于输入、缓存失效、上下文压缩和延迟成本时，才继承既有会话；宿主未暴露继承范围或用量时不使用 fork。
+- 高后果只提高证据、授权和验收强度，不自动制造角色调用。任何一次分工都必须能说明它将改变的决定、补足的能力或新增的独立证据，并且收益大于启动、交接、重复读取、复验和延迟。说不出就不调用。
+
+## 宿主能力与降级
+
+- 能力目录只认宿主已提供的系统说明、工具定义、已加载配置和实际调用结果。从中确认当前能力、可选责任、选择方式与继承语义；宿主已暴露的事实不再请用户重复，未暴露的能力不猜。
+- 当前模型不能自切换，但能通过独立 subagent 或宿主角色取得所需能力时，仍按可获得能力处理。能力可比时用最低充分的已核实责任；不可比时按与当前缺口相关的已证能力选一个足够的责任，不强行排全序。
+- 路由是否成立看实际调用，不看配置或自报。必须核对真实线程、返回角色、模型或推理档以及用量。未指定导致继承、角色无法核实、调用失败或实际能力未改变时，本次路由未成立；至多改用一个已核实的等价机制重试一次，仍失败就安全降级。
+- 不能取得所需能力时，继续当前能力可安全推进的部分；只阻断依赖该能力的不可逆放行，并准确说明未取得独立调查、规划、前端制作或验收的实际影响。不把宿主限制说成任务失败，也不伪造路由成功。
+- 调用后优先等待一次宿主完成事件或最长有界等待，不反复轮询、播报不变状态或重发累计上下文。
+
+## 安装宿主路由
+
+- 只在用户明确要求为当前宿主安装、更新、卸载或修复 odai 路由时进入这一节。从宿主已暴露的真实目录与调用结果选择 controller、planner、reviewer 以及可选 researcher、frontend，不凭名称猜能力顺序，也不要求用户手填可发现的 ID。
+- 只安装 `auto`：单一充分总控直接闭环，其他责任仍只按真实缺口调用。researcher 与 frontend 映射默认不配置；只有用户明确选择各自模型且宿主支持时才生成，二者都不从 controller 或其他责任继承。宿主路由不注入每轮前置流程，也不预设能降低延迟、token 或成本。
+- 说明作用域、持久化影响、各责任的实际映射与新会话生效条件，得到一次授权后，使用 `scripts/install-routing.mjs`。默认只处理当前项目，用户明确要求跨项目时才处理 user 作用域。重复安装原位更新自身托管文件，并安全移除旧版 advisor、implementer、worker、executor、stage runner 与跨 provider runner；卸载只删除清单内且未被外部修改的文件。发现冲突或外部漂移就停，不覆盖。
+- 安装后开启新会话做一次有界调用。Codex 用随包核验器对账真实角色、模型与推理档；Claude Code 由托管设置选择总控；Copilot 没有可移植的项目默认总控设置，使用安装结果返回的显式模型与 agent 启动命令。
+- 未安装路由器时，odai 仍完整可用，按普通单模型路径完成任务。宿主路由不是 skill 的必选依赖。
+
+## 使用、安装与创建其他能力
+
+- 先判断当前内置能力是否真有缺口。外部能力只有在正确性、兼容性、可验证性、真实交付或重复成本上的改善，明显大于安装与学习成本、权限与数据暴露、安全风险、上下文占用、维护负担和锁定效应时才值得引入。
+- 项目或宿主已有明确匹配的 skill、工具或插件，且它能改变结果时直接使用。skill 须完整读取对应 `SKILL.md`，其他能力遵循权威接口和项目约定。纯本地、已授权且不新增副作用的使用无需另问；安装、启用、联网、外部写入、凭据或更高权限仍按动作边界处理。
+- 没有匹配能力时，内置能力足够可靠就继续完成。只有缺口会实质影响结果，且现成能力值得引入时，才查用户允许的真实目录与权威来源。核对候选的原始说明、来源、适配面、维护状态、权限与验证方式，优先推荐覆盖缺口最窄且可信的一项；无法核实时只描述所需能力，不编造具体名称。
+- 推荐时说明名称与来源、为何匹配、会获得什么权限、安装后如何验证，以及不用它的替代路径和差异。安装或启用前征得用户同意；获准后的第一步必须可执行，不把尚未满足条件的后续步骤写成已可开始。
+- 稳定、重复出现的项目专属流程，只有两次以上实例证明它会改变结果，并能写成可发现、可重用、可验证、不固化当期数据的契约时，才考虑项目级 skill。用户已明确要求固化，或项目约定已授权时可创建；否则先说明方案并征得同意。已有 owner 原位更新，不建平行 skill。
+- `.odai/local.md` 只是项目叠加层：补项目事实、常量、禁区、术语和已有验收入口，不允许覆盖 odai 总纲、核心门、宿主指令或当前用户决定。重复的项目工艺不得无限堆进叠加层；达到上述条件后再提炼为 skill。
+
+## 组合与下放
+
+- 单一能力已能完整解决就不组合。需要组合时，先说清每项能力独立贡献的结果、交接契约和唯一状态 owner；重复覆盖或可互换的能力只选一个。外部 skill 先遵循其自身工作流，再由 odai 统一边界、证据、验收与交付。
+- agent 只用于边界明确、结果可复核，且独立上下文、真实并行、已授权的环境或访问差异、非脚本批量复用或高代价结论质疑中至少一项能改变结果，并且收益高于启动、交接和复验成本时才使用。上下文高度相关、写入冲突或结果不可复核时不下放。
+- 写入下放前外显同版读前门：目标、允许写域、禁止范围、验收、停止条件和必读来源。下游无法访问对应原规则、项目来源或确认同版时，不做写入，降为只读分析后回交。摘要不能替代原规则。
+- 多个写入者使用同一 baseline、精确允许路径和独立验收。路径重叠、依赖紧密，或不能隔离写入与验证时改为串行；真正独立时才用 worktree 或等价隔离并行。
+- review 只读，根据代码、测试、diff 和原始需求给 finding；不修代码，不为了绿改验收条件。finding 冻结稳定 ID，修复责任只接该清单并逐项回交状态与证据；未出现的建议不自动进入写域。

package/preset/odai/skills/odai/references/planning.md

@@ -1,84 +1,84 @@
-# 工程实施计划
-
-用户明确要求可执行的修复、开发、迁移、重构或专项治理计划，或已授权为跨轮次实施建立持久交接时读取。普通下一步建议、当轮可闭环实现和仅仅“任务复杂”不自动触发计划文档。
-
-本文件只把目标、事实、边界、工作包、验收、停止与续作冻结成可执行合同，不规定已冻结范围内的具体制作工艺，也不选择模型、角色或调度形态。产物如何实现与打磨由 `references/craft.md` 负责；是否取得外部能力或分离责任由 `references/leverage.md` 负责。制作中出现会改变目标、范围、公共契约、用户取舍或验收的分支时，才返回计划决定。
-
-## 适用与授权
-
-- 先区分计划建议、正式计划文档和计划后实施。用户只要求计划时，只调查和交付计划，不修改生产代码、测试行为、schema、依赖、数据或外部系统；宿主 plan mode 有更严格边界时服从宿主。
-- 聊天中的计划不自动授权写文件。用户指定产物或项目已有计划惯例时更新该位置；确需持久交接且写入已获授权时，才新建计划文件。
-- 计划服务于后续决定和行动，不复述仓库目录或堆满不适用栏目。计划完成只表示路线、边界与验收已达到可执行标准，不表示实现已经完成。
-- 需求、非目标、保留行为和不可接受结果由用户决定；能从当前 checkout 查明的事实自行调查，只询问会实质改变合同且无法从现有材料确定的用户决定或外部条件。
-- 正式计划记录其依据的用户目标与授权。用户纠正使目标、范围、保留行为、不可接受结果或实施授权变化时，只让受影响的工作包、验收和授权失效；保留仍成立部分，重新对齐后再继续，不用旧计划替用户维持已经改变的目标。
-
-## 事实基线
-
-- 先读适用项目指令，再核对相关工作树状态、目标合同、真实入口、调用方、数据边界、测试和项目权威验证命令。历史报告、旧会话、issue 评论和模型总结只作线索。
-- 调查深度只到足以区分当前行为、目标缺口、可行路线和主要风险。窄改动不做全仓盘点；跨 API、持久化、迁移、恢复或外部依赖时才跟踪相应端到端路径。
-- 分开目标合同与当前实现。文档或用户决定说明期望，当前源码、配置、测试和真实运行说明现状；冲突同时记录，不让一方冒充另一方。
-- 事实使用 `CONFIRMED`、`UNVERIFIED_RISK` 或 `UNKNOWN`。只有当前 checkout 有触发路径和影响证据时才把缺陷或 blocker 写成已确认；未知项附发现动作、决定标准和停止条件。
-- 验证命令从 CI、manifest、Makefile、项目文档或已有脚本提取。找不到时写成待发现工作，不凭经验伪造命令。
-
-## 计划缩放
-
-按后续执行真正需要的结构选择最小层级，稳定后不保留更重结构：
-
-- **窄计划**：目标与非目标、当前缺口、必要改动点、必须保持、验证和风险。
-- **跨边界或交接计划**：再加需求覆盖、当前与目标流程、带依赖的工作包、允许与禁止范围、失败行为和验收证据。
-- **跨轮次、高影响或迁移计划**：再加 checkout 基线、唯一执行状态、阶段门、兼容与回退、故障恢复、真实依赖验收、停止条件和恢复顺序。
-
-Wave 或阶段只表达真实依赖、风险门或可独立验收结果。独立工作包可以并行；共享状态、同一路径写入或前置证据未成立时才串行。无关边界直接省略，不用大量 `N/A` 伪装完整。
-
-## 合同与工作包
-
-需求多、跨边界或需交接时，为独立需求、保留行为和禁止结果设置稳定标识。每项至少映射一个主要工作包和最终证据；同一工作包可以覆盖多个相容合同，但不能让要求失去 owner。
-
-需要精确行为合同时使用：
-
-```text
-Given: 输入、前置状态和配置
-When: 可重复的操作或事件
-Then: 可观察成功结果
-And not: 明确禁止结果
-Failure: 失败状态、持久化与恢复行为
-Evidence: 测试、命令、API、UI、数据或外部结果
-```
-
-每个工作包只承诺一个可独立判断的结果，并说明：
-
-- 覆盖的合同与可观察结果；
-- 相关 symbol、路径或系统边界，以及允许变化和必须保持；
-- 前置依赖、失败行为、兼容或回退要求；
-- 定向验证、最终证据和会使本包停止或回到上游决定的条件。
-
-已有缺陷具备稳定复现信号且回归价值成立时，计划先定义正确的旧失败和修复后通过条件。无法稳定红测时使用另一种能区分路线的 Oracle 并标明限制；不为了格式强制新增测试，也不把编译失败、fixture 错误或无关失败写成红色证据。
-
-## 验证、状态与续作
-
-- 验收先写要证明的属性，再绑定相称证据。单测、mock、静态检查、E2E、迁移演练和真实依赖各自只证明覆盖部分，不能互相替代。
-- 计划就绪至少要求：明确要求均有落点；当前事实与未知分开；工作包依赖和边界可执行；命令有项目来源；主要失败、恢复和回归风险有相称验收；未获授权动作和停止条件清楚。
-- 只有任务确实需要中断恢复时才外化执行状态。优先复用已有计划、issue、TODO 或账本；没有合适载体时使用 `assets/task-state.md`，同一任务只保留一个主状态。
-- 计划文档承担主状态时不另建独立账本；独立账本承担主状态时，计划只保存账本路径和稳定合同，不复制当前工作包、完成项或下一动作。非主载体不能维护另一份进度。
-- 主状态记录用户目标与授权依据、checkout revision 与相关 dirty 基线、当前工作包、已完成项及证据、失效证据、阻断、下一项可验证动作和停止条件。用户目标、相关源码、合同或基线变化会使受影响状态与证据 stale，重新对齐或重验后才能恢复。
-- 续作时重新读取项目指令、计划及其指向的主状态；两者相同时只读一次。核对 checkout 与相关 diff，定位首个未完成且已解锁的工作包，从唯一下一动作恢复。聊天摘要和执行者自报不能替代主状态或原始证据。
-- 实施状态与计划状态分开。只能根据当前证据标记未开始、实施未验证、已验证、阻断或完成，不使用“基本完成”掩盖未决项。
-
-## 最小交付结构
-
-项目没有既有模板时，按实际需要从下列结构取用：
-
-```markdown
-# <任务>实施计划
-
-> 状态：计划就绪；不表示实现完成。
-
-## 目标、非目标与完成证据
-## 当前事实、缺口与未知
-## 需求覆盖与必须保持
-## 工作包、依赖与允许范围
-## 验证、失败恢复与停止条件
-## 执行状态与续作方式（仅在需要时；非主状态只放主状态指针）
-```
-
+# 工程实施计划
+
+用户明确要求可执行的修复、开发、迁移、重构或专项治理计划，或已授权为跨轮次实施建立持久交接时读取。普通下一步建议、当轮可闭环实现和仅仅“任务复杂”不自动触发计划文档。
+
+本文件只把目标、事实、边界、工作包、验收、停止与续作冻结成可执行合同，不规定已冻结范围内的具体制作工艺，也不选择模型、角色或调度形态。产物如何实现与打磨由 `references/craft.md` 负责；是否取得外部能力或分离责任由 `references/leverage.md` 负责。制作中出现会改变目标、范围、公共契约、用户取舍或验收的分支时，才返回计划决定。
+
+## 适用与授权
+
+- 先区分计划建议、正式计划文档和计划后实施。用户只要求计划时，只调查和交付计划，不修改生产代码、测试行为、schema、依赖、数据或外部系统；宿主 plan mode 有更严格边界时服从宿主。
+- 聊天中的计划不自动授权写文件。用户指定产物或项目已有计划惯例时更新该位置；确需持久交接且写入已获授权时，才新建计划文件。
+- 计划服务于后续决定和行动，不复述仓库目录或堆满不适用栏目。计划完成只表示路线、边界与验收已达到可执行标准，不表示实现已经完成。
+- 需求、非目标、保留行为和不可接受结果由用户决定；能从当前 checkout 查明的事实自行调查，只询问会实质改变合同且无法从现有材料确定的用户决定或外部条件。
+- 正式计划记录其依据的用户目标与授权。用户纠正使目标、范围、保留行为、不可接受结果或实施授权变化时，只让受影响的工作包、验收和授权失效；保留仍成立部分，重新对齐后再继续，不用旧计划替用户维持已经改变的目标。
+
+## 事实基线
+
+- 先读适用项目指令，再核对相关工作树状态、目标合同、真实入口、调用方、数据边界、测试和项目权威验证命令。历史报告、旧会话、issue 评论和模型总结只作线索。
+- 调查深度只到足以区分当前行为、目标缺口、可行路线和主要风险。窄改动不做全仓盘点；跨 API、持久化、迁移、恢复或外部依赖时才跟踪相应端到端路径。
+- 分开目标合同与当前实现。文档或用户决定说明期望，当前源码、配置、测试和真实运行说明现状；冲突同时记录，不让一方冒充另一方。
+- 事实使用 `CONFIRMED`、`UNVERIFIED_RISK` 或 `UNKNOWN`。只有当前 checkout 有触发路径和影响证据时才把缺陷或 blocker 写成已确认；未知项附发现动作、决定标准和停止条件。
+- 验证命令从 CI、manifest、Makefile、项目文档或已有脚本提取。找不到时写成待发现工作，不凭经验伪造命令。
+
+## 计划缩放
+
+按后续执行真正需要的结构选择最小层级，稳定后不保留更重结构：
+
+- **窄计划**：目标与非目标、当前缺口、必要改动点、必须保持、验证和风险。
+- **跨边界或交接计划**：再加需求覆盖、当前与目标流程、带依赖的工作包、允许与禁止范围、失败行为和验收证据。
+- **跨轮次、高影响或迁移计划**：再加 checkout 基线、唯一执行状态、阶段门、兼容与回退、故障恢复、真实依赖验收、停止条件和恢复顺序。
+
+Wave 或阶段只表达真实依赖、风险门或可独立验收结果。独立工作包可以并行；共享状态、同一路径写入或前置证据未成立时才串行。无关边界直接省略，不用大量 `N/A` 伪装完整。
+
+## 合同与工作包
+
+需求多、跨边界或需交接时，为独立需求、保留行为和禁止结果设置稳定标识。每项至少映射一个主要工作包和最终证据；同一工作包可以覆盖多个相容合同，但不能让要求失去 owner。
+
+需要精确行为合同时使用：
+
+```text
+Given: 输入、前置状态和配置
+When: 可重复的操作或事件
+Then: 可观察成功结果
+And not: 明确禁止结果
+Failure: 失败状态、持久化与恢复行为
+Evidence: 测试、命令、API、UI、数据或外部结果
+```
+
+每个工作包只承诺一个可独立判断的结果，并说明：
+
+- 覆盖的合同与可观察结果；
+- 相关 symbol、路径或系统边界，以及允许变化和必须保持；
+- 前置依赖、失败行为、兼容或回退要求；
+- 定向验证、最终证据和会使本包停止或回到上游决定的条件。
+
+已有缺陷具备稳定复现信号且回归价值成立时，计划先定义正确的旧失败和修复后通过条件。无法稳定红测时使用另一种能区分路线的 Oracle 并标明限制；不为了格式强制新增测试，也不把编译失败、fixture 错误或无关失败写成红色证据。
+
+## 验证、状态与续作
+
+- 验收先写要证明的属性，再绑定相称证据。单测、mock、静态检查、E2E、迁移演练和真实依赖各自只证明覆盖部分，不能互相替代。
+- 计划就绪至少要求：明确要求均有落点；当前事实与未知分开；工作包依赖和边界可执行；命令有项目来源；主要失败、恢复和回归风险有相称验收；未获授权动作和停止条件清楚。
+- 只有任务确实需要中断恢复时才外化执行状态。优先复用已有计划、issue、TODO 或账本；没有合适载体时使用 `assets/task-state.md`，同一任务只保留一个主状态。
+- 计划文档承担主状态时不另建独立账本；独立账本承担主状态时，计划只保存账本路径和稳定合同，不复制当前工作包、完成项或下一动作。非主载体不能维护另一份进度。
+- 主状态记录用户目标与授权依据、checkout revision 与相关 dirty 基线、当前工作包、已完成项及证据、失效证据、阻断、下一项可验证动作和停止条件。用户目标、相关源码、合同或基线变化会使受影响状态与证据 stale，重新对齐或重验后才能恢复。
+- 续作时重新读取项目指令、计划及其指向的主状态；两者相同时只读一次。核对 checkout 与相关 diff，定位首个未完成且已解锁的工作包，从唯一下一动作恢复。聊天摘要和执行者自报不能替代主状态或原始证据。
+- 实施状态与计划状态分开。只能根据当前证据标记未开始、实施未验证、已验证、阻断或完成，不使用“基本完成”掩盖未决项。
+
+## 最小交付结构
+
+项目没有既有模板时，按实际需要从下列结构取用：
+
+```markdown
+# <任务>实施计划
+
+> 状态：计划就绪；不表示实现完成。
+
+## 目标、非目标与完成证据
+## 当前事实、缺口与未知
+## 需求覆盖与必须保持
+## 工作包、依赖与允许范围
+## 验证、失败恢复与停止条件
+## 执行状态与续作方式（仅在需要时；非主状态只放主状态指针）
+```
+
 交付前删除无用途的章节和占位符，确认计划没有暗中扩大产品范围、写入授权或完成声明，并让下一执行者无需重新决定目标、边界和验收即可开始首个工作包。