@xgent-ai/skills 0.7.0 → 0.7.2

package/skills/agi-mode/assets/sdlc/index.md

@@ -4,14 +4,12 @@
 
 - 回写规则：[协议](protocol.md)
 - 状态定义与自愈：[固定状态模型](state-model.md)
-- 记录格式：[事件模板](event-template.md)
 - 对象状态：[类型导航](status/index.md)
-- 状态历史：[事件导航](events/index.md)
 
 由改变本目录内容的执行者按[目录索引维护规则](protocol.md#目录索引维护)同步入口；下级状态变化不逐级重写本页。分类或对象快捷链接可按需放在当前重点，不代替完整目录入口。
 
 ## 当前重点
 
-<列当前需要跟进的工作项：业务主题、文档类型及可见的原文仓根相对路径/链接，附对象状态页入口；用通俗语言说明进展、具体阻塞、首选下一步与完成条件，保留状态及证据码。完整活动项见分类索引。没有可确认活动项时如实说明。>
+<只列影响下一步的当前工作项：业务主题、文档类型及可见的原文仓根相对路径/链接，附对象状态页入口；用通俗语言说明进展、具体阻塞、首选下一步与完成条件，保留状态及证据码。完整活动项见分类索引，不追加历次盘点、旧建议、测试流水或重复计数。没有可确认活动项时如实说明。>
 
-<!-- 初始化时只链接实际存在的索引；未创建的类别写“暂无登记”，不要留断链。 -->
+<!-- 初始化时只链接实际存在的索引；未创建的类别写“暂无登记”，不要留断链。有历史或必要补充事件时才增加事件导航/模板入口，不预建事件树或复制模板。 -->

package/skills/agi-mode/assets/sdlc/object-status.md

@@ -1,7 +1,7 @@
 # <对象标题> · 状态
 
 - 对象 ID / 类型：<完整 UUID / prd、plan、review>
-- 状态模型：<协议 v3 / state-model v2；评审对象另写 review_type>
+- 状态模型：<协议 v4 / state-model v3；评审对象另写 review_type>
 - 来源：<实际文档/报告链接，版本>
 - 核查时间：<带时区时间>
 - 可见范围：<分支/HEAD/dirty、所核实范围及同步限制>
@@ -11,7 +11,7 @@
 | 维度 / 范围 | 固定状态码 | 来源自述 | 证据质量 | 证据 / 对应事件 | 差异、缺证或阻塞 | 下一步及完成判据 |
 | --- | --- | --- | --- | --- | --- | --- |
 
-<!-- 状态码按仓内 state-model.md 的判定顺序取最强可支撑状态，证据质量写 confirmed / provisional / stale / conflict；只有没有可读依据才用 unknown。差异列用一句话写缺什么或哪些改动未覆盖，不堆免责说明。原计划状态滞后时保留自述及纠正依据；开发完成不代表验收或发布。 -->
+<!-- 日常直接更新本页，不另建事件。状态码按仓内 state-model.md 判定，证据质量写 confirmed / provisional / stale / conflict；没有可读依据才用 unknown。证据直接链接原产物的必要章节并注明版本，共同基线只在页头写一次。计划汇总整体进度和当前局部阻塞，完成明细从原计划读取；评审和处置放在同一页。差异用一句话说明，旧建议与已解决过程不追加流水；唯一的待决、授权依据或未解冲突必须保留。开发完成不代表验收或发布。 -->
 
 ## 关联
 
@@ -20,6 +20,6 @@
 
 <!-- PRD 链到承接计划；计划链到 PRD、实施记录及各轮评审状态页；评审链到所审对象、前轮与整改证据。复审不覆盖原轮结论。关联不明就写待关联，不靠同名猜测。 -->
 
-## 已纳入事件
+## 补充事件与历史入口（有事件才保留）
 
-<!-- 只列本对象全部已纳入事件 UUID 及链接，按 ID 排序；包括历史事件，排序不代表执行顺序。可折叠；其他对象事件在各自状态页维护。 -->
+<!-- 链接本对象事件目录索引，列已核对末端 UUID 与链接；其 predecessors 可达祖先视为已纳入，不抄全量清单。未纳入、并发、缺前序、成环和 ID 冲突另列待核对，不能因精简丢掉。历史不覆盖本页后来直接更新的事实；无事件删除整节，不预建目录。 -->

package/skills/agi-mode/assets/sdlc/protocol.md

@@ -1,24 +1,36 @@
-# 项目状态记录协议 · v3
+# 项目状态记录协议 · v4
 
-本目录默认是仓根 `.xgent-ai/sdlc/`，随项目版本控制保存。`index.md` 只作导航；`status/<kind>/index.md` 列对象去向，`status/<kind>/<object_id>.md` 各保存一个对象的状态；`events/<kind>/<object_id>/` 保存该对象的独立事实记录，`event-template.md` 是写入模板。本协议可由任意 agent 或人工执行，无脚本、数据库或特定 skill 安装依赖。路径可按项目约定调整，以下文件名相对于本协议目录。
+本目录默认是仓根 `.xgent-ai/sdlc/`，随项目版本控制保存。`index.md` 作导航；`status/<kind>/index.md` 列对象去向，`status/<kind>/<object_id>.md` 各保存一个对象的当前状态。**日常回写直接更新状态页，不再为每次进展另建事件。** 本协议可由任意 agent 或人工执行，无脚本、数据库或特定 skill 安装依赖。路径可按项目约定调整，以下文件名相对于本协议目录。
 
 判断和回写前读取随仓保存的 [固定状态与证据校准](state-model.md)：使用固定状态码，区分原文自述与核查结论，并按其中的规则发现漏记的评审、处置和实施证据。台账、原文状态行都可能滞后，不直接照抄为当前事实。
 
+## 保存取舍
+
+| 信息 | 保存方式 |
+| --- | --- |
+| 需求、计划、每轮评审、实施与验收证据 | 沿用原产物及其版本；台账只链接必要章节，不另存摘要报告、日志、指纹清单或副本 |
+| 当前进度、证据适用性、阻塞、关系与下一步 | 更新对应对象状态页；同一事实只展开一次，共同版本与环境在页头写一次 |
+| 普通中间进展、检查时间、无关 HEAD 变化 | 不新建文件，不追加流水；里程碑明细从计划的恢复快照与记录读取 |
+| 历史状态 | 从原产物的可取回版本、已有事件及 Git 历史按需读取；当前页不逐条抄历史 |
+| 必须独立保留的事实 | 仅项目明确要求不可变审计，或并发/纠错事实无法由原产物及其可取回版本保留时，按下文新增补充事件 |
+
+新来源或版本仍需在状态页准确登记，但不单独构成创建事件的理由。覆盖当前页前确认被替换的有效事实已有可取回来源；唯一的待决、授权依据或未解冲突不得直接丢弃，先保留在当前页，确需独立留存时才建事件。hash 只能检测变化，不能代替可取回内容。用户要求只读/仅聊天/不保存时不登记。
+
 ## 分类与读取
 
-- 本目录只保存状态及其索引、协议和事件。PRD、开发计划、评审报告、实施/验收记录、测试计划、原始日志/截图等继续按用户习惯与项目约定保存；不规定它们的目录或文件名，不搬迁、复制或创建在本目录。用 `artifact`、`sources` 及来源链接引用实际位置。
+- 本目录只保存状态及其索引、协议和必要的补充事件。PRD、开发计划、评审报告、实施/验收记录、测试计划、原始日志/截图等继续按用户习惯与项目约定保存；不规定它们的目录或文件名，不搬迁、复制或创建在本目录。用 `artifact`、`sources` 及来源链接引用实际位置。
 - `kind` 的默认目录名固定为 `prd`、`plan`、`review`。每个对象单独状态页；每轮评审也是独立对象，计划状态页链接各轮而不复制报告。类型索引只列 ID、标题、来源、状态页及活动/归档标记，不存所有对象的进度正文。
 - 类型索引过大时按领域或年份分片，父索引列全分片与范围；归档另列索引，不删事件，不以文件年龄推断归档。顶层列直接文件、子目录入口和当前重点，不能悄悄截断活动工作。
-- 显式枚举隐藏目录：`rg --files --hidden .xgent-ai/sdlc`。先看导航/分类索引，再按活动对象、用户选定范围及依赖读状态页和相关来源。比较该对象事件目录与其已纳入集合；没登记的对象/事件要提示，不默认全文加载所有历史。
-- 旧 `docs/project-status/` 或其他登记台账沿原协议维护，不自动生成第二份。仅在台账迁移获授权时迁移状态资料，保留 ID、历史内容与来源版本，转换来源链接并记录旧路径映射；原文档保持原位；核验后登记新入口，旧入口只留指引。不要用本 v3 模板直接覆盖旧协议；协议升级与历史自由文本的兼容按 state-model.md 执行。
+- 显式枚举隐藏目录：`rg --files --hidden .xgent-ai/sdlc`。先看导航/分类索引，再按活动对象、用户选定范围及依赖读状态页和相关来源。有事件时按下文核对末端，只为遗漏、冲突或追溯展开相关历史；不默认全文加载历史，也不漏掉未登记对象。
+- 旧 `docs/project-status/` 或其他登记台账沿原协议维护，不自动生成第二份。迁移只在获授权后进行，保留 ID、历史内容与来源版本，转换来源链接并记录旧路径映射；原文档保持原位，核验后登记新入口，旧入口只留指引。协议升级见文末，不直接覆盖项目自定义规则。
 
 ## 目录索引维护
 
-本规则适用于 `.xgent-ai/` 下实际创建的每层状态目录，包括 `sdlc/`、`status/`、`status/<kind>/`、`events/`、`events/<kind>/`、`events/<kind>/<object_id>/`、非开发任务的 `tasks/` 与任务子目录，以及后续增加的归档或分片目录。每个目录都有 `index.md`，目录按需创建，不为索引预建空树。原文档目录不受本规则约束。
+本规则适用于 `.xgent-ai/` 下实际创建的每层状态目录，包括 `sdlc/`、`status/`、`status/<kind>/`、确有事件的各层 `events/`、非开发任务的 `tasks/` 与任务子目录，以及后续增加的归档或分片目录。每个目录都有 `index.md`，目录按需创建，不为索引预建空树；没有事件不建事件目录或复制事件模板。原文档目录不受本规则约束。
 
 - **内容与边界**：写明目录用途、覆盖范围与本规则入口；列全直接文件和子目录，不自列 `index.md`。文件链接到自身，子目录链接到其 `index.md`，链接相对当前索引解析，不含机器绝对路径。类型目录一对象一行，保留 ID、标题/来源、状态页及活动/归档标记；事件叶目录一事件一行，保留事件 ID、facet/scope 和文件链接，不复制状态结论。普通导航只列名称、用途和入口，不在每层复制全树或进度。
 - **职责与时机**：创建或改变目录内容的执行者，在同一批交付中维护受影响索引；先落状态文件/事件，再更新本层索引，最后更新入口有变化的祖先。首次创建目录同时创建索引；旧目录缺索引时在已授权维护范围内补齐。无关目录和内容不变的索引不重写，也不只为检查刷新时间。状态正文改变但身份、去向和目录成员不变时，无需改索引；当前重点实际改变时才更新重点。
-- **新增与移动**：新对象、新事件、新子目录必须登记；已有对象的新事件只新增到对应事件清单，不逐级改总索引。获准移动状态文件时保持对象/事件 ID，更新旧、新父目录与受影响链接，保留历史路径映射；不改写不可变事件。原文链接变化须核实新位置，维护索引不授权移动原文。
+- **新增与移动**：新对象、必要的新事件、新子目录必须登记；已有对象只改状态正文时不改目录索引；确有新事件只新增到对应事件清单，不逐级改总索引。获准移动状态文件时保持对象/事件 ID，更新旧、新父目录与受影响链接，保留历史路径映射；不改写不可变事件。原文链接变化须核实新位置，维护索引不授权移动原文。
 - **归档与删除**：归档须有事实依据，更新活动/归档去向并保留可达入口和事件历史。索引过期条目只有确认目标已按授权删除或迁移后才删除或改指；本机目标缺失先标未同步/待核对，不能顺手删记录、删目录或裁掉历史。原文已删除也保留状态与事件，标明来源不可用。
 - **增长与排序**：条目按相对路径或稳定 ID 排序，避免每次按状态、机器时间重排。索引过大时拆为 `index-<分片名>.md`，首页列全分片与明确范围；每项恰属一个分片。分片是导航文件，不产生对象或事件 ID；如另建物理目录，该目录也须有 `index.md`。活动项不能因分页或归档而从入口消失。
 - **事件识别**：`index.md`、`index-*.md` 都是可修改导航，必须排除在事件读取、事件数量及已纳入事件集合之外。实际事件以 UUID 文件名和一致的 `event_id` 字段识别；疑似事件但格式损坏时报告待核对，不悄悄忽略。
@@ -29,13 +41,22 @@
 
 - PRD 正文定义需求；计划正文定义范围、门槛与恢复入口；实际实现、验证及处置记录支撑进度判断。原文自报状态不享有绝对优先级：与可核实交付不符时，台账保留自述并给有证据的规范状态及差异原因，不顺手修改原文或外部系统。
 - PRD、计划、评审各有稳定 `object_id`。一份 PRD 可关联多计划，一份计划可关联多 PRD；依赖可细到需求、里程碑或检查，不强制串行。一轮评审可审多个对象，未关联计划的代码评审也可独立登记。
-- 原文件名与状态对象 ID 分开：登记时沿用已有对象 ID，否则分配 UUID，不要求原报告用 UUID 命名。每次实际评审是独立对象，即使同日、同机器或同路径重跑也分配新的评审 ID；同轮整改沿原评审对象追加处置。复审用 `rechecks` 关联前轮，问题以 `评审 object_id + 报告内问题 ID` 定位。原报告被授权覆盖时，引用可取回的历史版本或用户约定位置的快照，不把快照放进本状态目录；仅有 hash 而内容不可取回时标证据缺失。
-- 已有本协议 ID 时沿用；新对象/事件用独立生成的 UUID（例如 `python3 -c 'import uuid; print(uuid.uuid4())'`，也可用系统 UUID 工具），不依赖机器名、时钟或共享递增编号。文件移动保持对象 ID，并在新事件登记新路径和旧路径；复制出独立计划则新建 ID，关联 `derived-from`。
-- 同一历史对象被两台机器首次导入为不同 ID 时，只有读到来源/版本/范围等证据确认相同，才新增带 `same-as` 关系的对账事件；保留原 ID 和所有历史。同名、同 hash 的两次真实评审不能因此合并。
+- 原文件名与状态对象 ID 分开：登记时沿用已有对象 ID，否则分配 UUID，不要求原报告用 UUID 命名。每次实际评审是独立对象，即使同日、同机器或同路径重跑也分配新的评审 ID；同轮整改更新原评审对象的处置。复审用 `rechecks` 关联前轮，问题以 `评审 object_id + 报告内问题 ID` 定位。原报告被授权覆盖时，引用可取回的历史版本或用户约定位置的快照，不把快照放进本状态目录；仅有 hash 而内容不可取回时标证据缺失。
+- 已有本协议 ID 时沿用；新对象/事件用独立生成的 UUID（例如 `python3 -c 'import uuid; print(uuid.uuid4())'`，也可用系统 UUID 工具），不依赖机器名、时钟或共享递增编号。文件移动保持对象 ID，在当前页登记新旧路径及依据；复制出独立计划则新建 ID，关联 `derived-from`。
+- 同一历史对象被两台机器首次导入为不同 ID 时，只有读到来源/版本/范围等证据确认相同，才登记 `same-as` 关系及依据；保留原 ID 和所有历史。同名、同 hash 的两次真实评审不能因此合并。
+
+## 对象当前状态
 
-## 事件字段
+状态页保留稳定对象 ID、kind、标题、artifact，以及状态模型版本、核查时间和 checkout 基线（HEAD、branch、clean/dirty；非 Git 写可用版本或 unknown）。当前事实按 `facet + scope` 列固定状态、source_state、evidence_status、必要来源的路径/版本/章节、差异或阻塞、下一步及完成条件；关系保存类型、目标对象 ID 和范围。评审另存 review_type、所审版本、范围与原判定，不能用观察 checkout 冒充所审版本。
 
-每次变化新建 `events/<kind>/<object_id>/<event_id>.md`，YAML frontmatter 加简短 Markdown 证据正文。用 `event-template.md`，去掉不适用的可选字段。记录一旦交付保存不覆盖；纠错/补证新建后续事件。写前重读相关记录，文件名已存在则核对，禁止覆盖不同内容。
+- 计划默认汇总 `readiness / plan`、`implementation / plan` 及当前影响下一步的局部阻塞；已完成里程碑明细从原计划读取，不再复制一套完成记录。只核实局部时明确该 scope，不能提升为整计划完成。
+- 每轮评审仍有独立对象与原报告，`review` 和 `disposition` 在同一状态页登记，不为两个维度分别建事件或复制报告。前轮未关闭或未覆盖问题继续保留入口，新轮通过不能抹掉它们。
+- 当前页保留有效事实、未解问题和必要关系。已解决的过程说明、旧的建议与检查流水从当前正文移出，已有原产物或历史入口可追溯时不另建归档副本。
+- **有事件才保留历史入口与已核对末端 ID**：沿 `predecessors` 可达的祖先视为已纳入，不再在状态页重复列全部事件 ID。枚举事件元数据找未被接续的末端；新末端不在已核对末端及其祖先中即为待核对。同维度同范围的多个末端、缺前序、成环或同 ID 冲突不能折叠为一个结论，保留各入口及限制。未核实事件不能因精简被标为已纳入。
+
+## 补充事件（按需）
+
+仅符合“保存取舍”中的独立留存条件时，新建 `events/<kind>/<object_id>/<event_id>.md`，并注明为何原产物与当前页不足以保留该事实。首次需要时再复制事件模板为 `event-template.md`；已有模板沿用。记录为 YAML frontmatter 加简短 Markdown 证据正文，去掉不适用的可选字段。一旦交付保存不覆盖；需要纠正该事件时新建接续事件。写前重读相关记录，文件名已存在则核对，禁止覆盖不同内容。字段兼容 v3 历史事件：
 
 | 字段 | 约定 |
 | --- | --- |
@@ -72,23 +93,23 @@
 
 ## 回写流程
 
-1. 正常先交付/更新原产物和证据，再登记本次变化。实质进展、阻塞、交接、评审完成、整改/复核完成时回写；普通任务切换和无变化查询不写流水。
-2. 按对象、维度、scope 找已有事件和 ID。仅更新这次工作触及的维度，不为登记代码评审顺便改变计划的 Ready 或完成状态。不明确的关联保留待关联。
-3. 新事件列出实际读过且接续的前序，记录当前来源版本与证据。根据 state-model.md 判断规范状态；来源、规范状态、证据质量/适用性、范围和关系均不变时不重复写，不因无关提交改变 HEAD 就新增事件；初始化只记当前可核实的状态，历史缺失不补造。漏记或滞后按模型的自愈规则补证、纠错，不直接覆盖旧事件。
-4. 更新受影响的 `status/<kind>/<object_id>.md`，其中保留未关联、过期、冲突、缺证及关系。写本对象的观察时间、checkout 基线和精确的已纳入事件 ID 清单（排除索引文件）。按“目录索引维护”同步本对象事件清单、必要的分类索引与祖先入口，不每次重写所有状态页和索引。只看数量或最大时间不能发现遗漏。事实、来源适用性、可见范围和建议均无变化时无需重写视图，保留上次保存时间，在回复说明本次已核对即可。
-5. 回读新事件与视图，核对链接、ID、前序、来源及目录索引覆盖。事件保存成功、视图/索引更新失败时保留事件并说明待刷新范围；原产物成功但登记失败时明确台账未同步，不回退产物。
+1. 先交付/更新原产物和证据。实质进展、阻塞、交接、评审完成、整改/复核完成时核对台账；普通任务切换和无变化查询不写流水。
+2. 找已有对象 ID、状态页及必要来源，按 state-model.md 判断本次触及的维度。不为登记代码评审顺便改变计划的 Ready 或完成状态；不明确的关联保留待关联。初始化只记当前可核实状态，不补造历史阶段。
+3. 写前重读状态页，检查是否有其他执行者改动；有变化先合并核实，不覆盖未读事实。按“保存取舍”直接更新当前页，通常无需新建文件；只有满足独立留存条件才新增事件，列实际接续的前序。来源、状态、证据适用性、范围、关系和建议均无变化时不改文件或保存时间，不因无关 HEAD 变化重记。
+4. 仅身份、去向、活动/归档标记或目录成员改变时更新索引；当前重点改变才改导航重点。若有新事件，更新其叶索引及状态页的已核对末端；不复制全量历史清单。
+5. 回读受影响状态页、来源和必要索引，核对链接、ID、范围及未解问题；有事件才核对前序与末端。保存失败说明具体缺口，成功的原产物或事件不回退，不为重试另造记录。
 
 其他技能只需读本协议与相关记录即可回写，不要求加载 agi-mode 的完整流程。用户要求仅聊天/只读/不保存时不登记。只安装部分技能、旧版技能或人工操作未回写的产物，由下一次盘点发现并提示，不能把“未登记”解释为“未发生”。
 
 ## 多机、分支与冲突
 
-- 每次变化独立文件，降低并行追加的文本冲突；Git 只是传输方式，不提供自动同步或全局锁。协议、事件与状态页可纳入版本控制，不能放进本机缓存目录；原文和证据按项目原有方式同步，本目录只引用其位置与版本。记录未提交/未推送时说明尚未共享；不自动提交、推送、拉取或改分支。
+- 对象分文件降低无关工作间的写冲突；同一工作树中的同一对象由一个写入者维护，并行执行者交回事实与来源，不竞争覆盖。写前重读，合并时逐维度核对双方来源。Git 不提供自动同步或全局锁。协议、必要事件与状态页随仓保存，不能放进本机缓存；原文和证据按项目原有方式同步。记录未提交/未推送时说明尚未共享；不自动提交、推送、拉取或改分支。
 - 只报告当前可见范围。分支名是线索，commit/内容和实际来源才是依据；已 fetch 的远程引用也不证明另机没有未提交工作。另一分支事件可列出，但不能当成本 checkout 已实现。
 - 未提交代码的评审/验证保留 `dirty@HEAD`、所涉及的 tracked/untracked 路径及内容指纹或快照位置，不能只有 HEAD。指纹只能检测变化；缺少可同步的快照时明确“仅原工作树可复现”，另一台机器必须重新核对。hash 的文件集合和算法写清，不能把 index、工作树和未跟踪文件混为一谈。
 - 文档评审记录所审文档 hash/可取回版本及依赖的代码基线；代码评审保留精确模式、base/target、文件限制和可选计划版本。对比相关内容确认当前适用性；后续无关提交不会自动使全部证据失效。
 - 对同 `object_id + facet + scope`，沿 `predecessors` 找未被接续的末端。只有一个末端也仍需核对当前来源；多个末端是并发观测。两条一致且来源等价可合并展示但保留记录；矛盾或适用分支不同则并列标“待核对”，不得按机器时间或字典序取最后一条。前序缺失/成环也列待核对，不静默丢记录。
-- 状态后退可以是真实回归；“已完成”不比“阻塞”优先。证据核实后新增对账事件，`predecessors` 引用全部被解决末端，并说明选择/合并的依据。跨 scope 的局部完成不覆盖计划整体状态；总进度仍核对计划本身。
-- 合并时保留所有事件。对象状态页只是派生视图，冲突时从合并后的事件与来源重建；原 PRD/计划/报告发生冲突按原文件处理，不能只修对象状态页。相同 event ID 内容不同则先保留双方并标 ID 冲突，修复引用后再汇总。
+- 状态后退可以是真实回归；“已完成”不比“阻塞”优先。状态页冲突保留双方来源、版本、范围和未解事项，不能按时间选一方。若源记录不足以保留两条独立观测，分别保存补充事件；核实后在当前页说明取舍依据，涉及事件对账时新增接续全部被解决末端的事件。跨 scope 的局部完成不覆盖计划整体状态；总进度仍核对计划本身。
+- 合并时保留所有已有事件。当前页从双方有效事实、原产物与必要事件重建，不能仅凭旧事件覆盖后来直接回写的事实；原 PRD/计划/报告冲突按原文件处理。相同 event ID 内容不同则先保留双方并标 ID 冲突，修复引用后再汇总。
 - 记录找不到来源时区分未同步、已移动、已删除、历史版本不可访问与未知；不擅自删事件或把历史完成改成未开始。非 Git 场景可以同步本状态目录，原文和证据仍各按既有位置同步，再以 UUID 与来源核对，无法证明同步就写未知。
 
 ## 当前有效与下一步
@@ -96,3 +117,9 @@
 对象状态页同时显示“固定状态码”“来源自述状态”“证据质量”与“当前核查限制”。历史评审通过后有相关改动，保留原结论并写当前待复核；源文档与记录冲突时展示双方出处，有充分证据可纠正台账并注明原文滞后，不能顺手覆盖原文。未评审、无需评审、评审结论不可判定、过期待核对不能混用。
 
 建议只依赖已核实的前置，并尊重项目自己的门槛。发现独立计划可推进时列出；有共享文件、接口、环境或前置依赖时说明实际冲突。状态盘点不默认重跑测试、评审或开始开发；执行以用户已有授权和当前任务范围为准。
+
+## 既有协议升级
+
+新台账使用 v4。已有台账仍按仓内协议写入；用户明确要求精简或升级时才切换，并在导航登记版本和范围，不双写。项目自定义原则、授权、状态或审计要求保留；有冲突先列差异，不能借升级替换它们。
+
+v3 → v4 保留状态枚举、对象/事件 ID、原产物路径及全部已有事件，改为日常直接更新当前页。核对旧页已纳入集合与实际事件，只有其覆盖的祖先才可压缩为已核对末端及历史目录入口；未纳入、缺失或矛盾记录继续显式列出。历史事件不批量改写、删除或另存副本，旧事件模板可保留但不必在新台账预置。清理历史文件须另有明确范围，不能把“以后少写”当作删除证据的授权。状态模型兼容见 state-model.md。

package/skills/agi-mode/assets/sdlc/state-model.md

@@ -1,10 +1,10 @@
-# 固定状态与证据校准 · v2
+# 固定状态与证据校准 · v3
 
 本文件随状态协议保存到项目，不依赖安装 agi-mode。状态是基于当前可见证据的判断，不是从原文标题或状态行直接复制的事实。PRD、计划、评审、处置和实现记录仍在用户约定的位置。
 
 ## 状态字段
 
-每条事件声明 `schema_version: 3`，`state` 从下面对应 `kind + facet` 的集合取值；原文自述另存 `source_state`（无状态文字用 null）。正文解释来源、版本、覆盖范围、判断依据及差异。各维度独立，不把整个项目强制压成一个阶段，也不要求补造中间事件。
+当前状态页与必要的补充事件共用以下判定；补充事件仍声明 `schema_version: 3`。`state` 从下面对应 `kind + facet` 的集合取值；原文自述另存 `source_state`（无状态文字用 null）。正文解释来源、版本、覆盖范围、判断依据及差异。各维度独立，不把整个项目强制压成一个阶段。保存粒度服从仓内协议，v4 日常直接更新当前页，不要求补造中间事件。
 
 - **state 取最强可支撑状态**：按下文各节的判定顺序，取原文记录与可核验物（记录文件、登记的提交、报告判定行、处置节、决策记录）支持的最强状态。之后相关文件又有改动时状态不降级，改由证据质量表达；只有完全没有可读依据时才用 `unknown`。
 - `evidence_status` 表达依据质量与当前适用性，不是百分比置信度，固定为：
@@ -88,20 +88,22 @@ scope 为 `plan` 才表示整份计划完成；M1 完成不代表 M2 完成。
 2. **确认关联**：打开候选，核对目标路径/文档 ID、报告类型、所审版本与范围。明确指向原对象的实际报告可补 `reviews` 关系；版本缺失时仍可登记发生过评审，但当前适用性单列未知。仅同名不足，空模板、目标不明、文件找不到或未同步时保留候选与限制，不造关联或重复评审。改名通过内容、稳定 ID、Git 历史等确认后沿用对象 ID；同一路径的新一轮评审仍需独立 ID。
 3. **发现处置**：核对逐项修改位置、最终处置和复核证据；不要求必须调用某个 skill 或存在独立 applied 文件。代码看似修复但缺少逐项确认/验证时只标待核实；记录只有部分关闭时保留剩余范围。无需处理的完整报告用 review-not-required，不为了凑流程推荐空跑 apply。
 4. **纠正滞后**：计划状态行、复选框、状态页和事件都可能过期。对计划规定的每项必需交付/里程碑，核对实现记录、完成记录登记的提交、必要验证结果及未关闭事项；按相关版本和范围判断，不按文件更新时间选赢家。不默认重跑测试或整轮评审。记录覆盖全部门槛时在 SDLC 确认 completed，并指出原计划状态滞后；覆盖不足时按判定顺序取可支撑的状态（如 in-progress，或证据 provisional 的 completed）并列补证动作，不能只凭文案重开开发或反过来虚报完成。
-5. **有限修复**：查询时在回答中重算、解释冲突与建议修复，不写文件。初始化/更新时自动补登记可确认的既有对象/评审、关系和必要索引；状态纠错追加事件并接续相关前序，刷新受影响视图，保留旧证据。只修派生视图时不需新造事实事件。原计划/报告改稿、执行 apply、测试或评审须在已有任务授权内，不从“自愈”推导这些授权。
-6. **容错与幂等**：单个坏文件、缺来源、损坏 frontmatter、缺前序、断链或同 ID 冲突标记到对应对象，继续盘点其他计划；保留损坏原文件，不覆盖或静默丢弃。来源缺失不等于未开始，哈希存在不等于内容可取回。新证据/关联、固定状态、证据质量或适用范围实质改变才追加记录；重复更新不因时间/无关 HEAD 改变重记事件。修复失败保留成功的事件并报告待修复范围。
+5. **有限修复**：查询时在回答中重算、解释冲突与建议修复，不写文件。初始化/更新时自动补登记可确认的既有对象/评审、关系和必要索引；按仓内协议保存纠正依据，v4 直接更新当前页，只有符合独立留存条件时才新增事件；旧协议仍按其规则接续事件。保留必要旧证据，只修索引不造事实。原计划/报告改稿、执行 apply、测试或评审须在已有任务授权内，不从“自愈”推导这些授权。
+6. **容错与幂等**：单个坏文件、缺来源、损坏 frontmatter、缺前序、断链或同 ID 冲突标记到对应对象，继续盘点其他计划；保留损坏原文件，不覆盖或静默丢弃。来源缺失不等于未开始，哈希存在不等于内容可取回。新证据/关联、固定状态、证据适用性、范围或建议实质改变才更新当前页，不因时间/无关 HEAD 改变重写；有变化也不自动要求独立事件。修复失败保留成功的产物并报告待修复范围。
 
 ## 验收线与扩展
 
-独立验收线的固定状态暂为 **TBD**，不虚构 passed、accepted、released 等默认阶段。已有验收/集成/发布事实可保留来源与范围；没有项目已登记枚举时新 v3 事件使用 `state: unknown` 并在 `source_state` 保留原结论，明确“未定义状态映射”，不是判定验收失败。已有项目枚举沿用其版本，不抹除历史。开发完成不自动说明产品验收、集成或发布完成。
+独立验收线的固定状态暂为 **TBD**，不虚构 passed、accepted、released 等默认阶段。已有验收/集成/发布事实可保留来源与范围；没有项目已登记枚举时，当前页或 schema_version 3 的事件使用 `state: unknown` 并在 `source_state` 保留原结论，明确“未定义状态映射”，不是判定验收失败。已有项目枚举沿用其版本，不抹除历史。开发完成不自动说明产品验收、集成或发布完成。
 
-自定义 kind/facet 或新增状态必须先在项目的本文件登记含义、证据条件和版本，再写事件；不能每个 agent 临时造同义词。
+自定义 kind/facet 或新增状态必须先在项目的本文件登记含义、证据条件和版本，再保存状态；不能每个 agent 临时造同义词。
 
 ## 旧记录兼容
 
-无 schema_version 的旧事件按原协议解释，不将其自由文本当 v3 枚举，也不回写修改。维护任务明确包含协议升级时保留原规则的兼容说明，新增本文件并升级协议/模板；有证据才追加 v3 规范化事件，接续同对象、维度和 scope 的旧前序。原文字段保留在 source_state，无可靠映射用 unknown。只读盘点可在回答中给固定状态映射，不静默升级仓内文件；历史事件/对象 ID 不变。
+无 schema_version 的旧事件按原协议解释，不将其自由文本当固定枚举，也不回写修改。维护任务明确包含协议升级时保留原规则的兼容说明，升级协议/必要模板；有证据才保存规范状态。v4 写入当前页，仍采用事件回写的旧协议则追加 schema_version 3 的规范化事件，接续同对象、维度和 scope 的旧前序。原文字段保留在 source_state，无可靠映射用 unknown。只读盘点可在回答中给固定状态映射，不静默升级仓内文件；历史事件/对象 ID 不变。
 
 **v1 → v2**：v1 要求 ready、completed、applied 的依据必须 confirmed，否则记 unknown 加候选；v2 改为取最强可支撑状态，证据质量单独标注。状态集合、事件字段与 `schema_version` 不变。
 
 - 仓内副本与 v1 原样一致时（`state-model.md` 的 SHA-256 为 `35a5abdf71d59bd1b4de16b09c6efcb8f127bd08e9e7af413599a5f90ffe772e`，`event-template.md` 为 `d5a418d1e47d53a92e7bce50636c642c4fb142a42cc1cb1e9aaddd3b7f795cf6`），初始化或更新直接替换为新版，并在台账导航登记升级时间与版本。副本有项目改动时保留，列出差异请用户决定，不覆盖。
-- v1 事件不改写。升级后首次核对按 v2 重判，状态或证据质量有变化时追加接续事件（`predecessors` 指向原事件），正文注明口径升级；无变化不追加。查询模式按 v2 在回答中给状态，并说明台账仍是旧口径。
+- v1 事件不改写。升级后首次核对按新版重判，状态或证据质量有变化时按仓内协议保存纠正依据：v4 更新当前页，旧协议追加接续事件（`predecessors` 指向原事件）；注明口径升级，无变化不重写。查询模式给新版状态，并说明台账仍是旧口径。
+
+**v2 → v3**：状态集合、判定顺序、证据门槛及事件字段不变；保存方式统一服从仓内协议，配合协议 v4 减少重复事件。旧协议不因模型升级自动切换。用户要求精简/升级且仓内副本与原版 v2 一致时（SHA-256 为 `5988742ef88e56f69ee270c68ba662c8772302656273daf4475f7eccb115b783`），可替换并在导航登记；项目改过的副本保留，先核对差异。历史按协议的兼容规则保留，不为模型版本号单独新增事件。

package/skills/agi-mode/evals/scenarios.md

@@ -371,6 +371,8 @@
 | --- | --- | --- |
 | “用 agi-mode 讲讲从想法到上线的流程。”只安装 agi-mode，无项目材料和 SPMS | 读取内置 SDLC 手册，解释阶段与输入/产物，按需说明专用技能；无项目判断不扫仓 | 依赖仓库外 docs，要求先安装全套技能/初始化台账，或伪造项目状态 |
 | “agi-mode，PRD、CRD、开发计划和测试计划有什么区别？” | 按产品行为、跨项目契约、实现安排、测试方法解释，CRD 含 Q&A 与文末答复 | 把 CRD 的 QA 当质量测试，或只返回技能名称列表 |
+| “PRD 写好了，想把每项功能和我确认一遍，该用什么？”另一变体为已有开发计划 | 建议 `spec-human-decision <文档>`，说明功能/价值、计划做法及确认/驳回/附说明修改，修改版再确认后改稿；咨询保持只读 | 直接启动问答或改稿、只推荐质量评审，或把用户确认当 Ready |
+| “按这份已授权的 Ready 计划继续开发，功能之前已经确定。” | 按计划实施入口续做；不自动插入 spec-human-decision 或把逐项确认变成开工前置 | 重问已定功能、暂停等整篇再批准，或从确认记录推导新功能已实现 |
 | “已有 Ready 计划，下一步怎么做？先只给建议。”有实际计划、进度和部分前置证据 | 用 what-next 核实现状，建议具体里程碑或补证，解释完成条件 | 仅凭 Ready 判开工、直接实施、或调用 dev-plan 重写 |
 | “为审批应用写开发计划，接入统一身份服务并验收完整流程。”身份服务在同仓由平台组维护，缺少需求依赖的角色 claim，用户未纳入平台改造 | 计划明确审批应用改动及身份服务 non-scope；缺口写平台提供方、契约、就绪证据与解除条件，关键未决为 Blocked；保留真实集成门，已确定独立部分可另立范围 | 因同仓/自有或完整流程而新增身份平台里程碑、迁移/种子/部署任务，或建设替代身份系统冒充终验 |
 | “这期同时改审批应用和身份服务的角色 claim，由我们负责两边。”已有明确范围与契约依据 | 两边改动进入范围、文件清单及里程碑，定义兼容与集成验收；沿用已有授权 | 一概排除身份服务、漏掉已要求的改动，或重复请求跨系统授权 |
@@ -401,29 +403,35 @@
 | 自然请求与材料 | 应观察的行为 | 失败信号 |
 | --- | --- | --- |
 | “agi-mode 看项目下一步。”隐藏的 `.xgent-ai/sdlc/` 只存状态，PRD 在 docs/、计划在 goal/ 和 design/ | 显式发现状态目录，再沿来源链接和项目习惯定位原文，只读给状态与下一步 | 只搜索状态目录就说没有 PRD/计划；开始实施或新建文件 |
-| “初始化项目跟进。”多 PRD、多计划多对多承接，同一计划有两轮代码评审 | 按类型、对象创建独立状态页与事件；各轮保留版本及处置；顶层只作导航 | 所有内容塞进单一 STATUS.md，或第二轮抹掉第一轮未覆盖问题 |
-| “$agi-mode init-sdlc。”分别提供空项目、现有材料项目和已登记自定义台账；随后重复调用 | 空项目只建协议、模型、模板及根/SDLC 索引；有材料时核实登记；已有台账沿用并补缺，无变化不重写；兼容 what-next 初始化 | 要求先跑其他命令，重置历史、另建竞争台账、静默升级或预建空对象 |
+| “初始化项目跟进。”多 PRD、多计划多对多承接，同一计划有两轮代码评审 | 按类型、对象创建独立当前页，不为初始状态另建事件；各轮保留版本及处置，同轮两个维度同页；顶层只作导航 | 所有内容塞进单一 STATUS.md，每个维度各建事件，或第二轮抹掉第一轮未覆盖问题 |
+| “$agi-mode init-sdlc。”分别提供空项目、现有材料项目和已登记自定义台账；随后重复调用 | 空项目只建协议、模型及根/SDLC 索引，不建事件模板/目录；有材料时核实登记；已有台账沿用并补缺，无变化不重写；兼容 what-next 初始化 | 要求先跑其他命令，重置历史、另建竞争台账、静默切换存储协议或预建空对象 |
 | “$agi-mode init-sdlc。”提供统一待办 PRD、七里程碑计划及来源协作 CR；计划 3/7 完成，M4 等待来源完整对账与资格撤回合同 | 聊天工作项及台账当前重点均写业务主题、文档类型和可见的原文路径/链接；中文解释进度与具体阻塞，保留状态/证据码；首选命令带实际路径，说明所缺来源交付、M4 含义及解除条件 | 只列“PRD / 开发计划 / 来源 CR”，只链接 UUID 状态页，堆状态码，或只说“接续 Q&A / 补齐契约 / 取得 M4 解锁证据” |
 | “看项目下一步。”两份计划同名但位于不同目录/期次，另有仅在线链接的协作材料 | 每项用实际路径和范围区分，在线材料使用真实来源；下一步可对应到具体对象，不猜未说明的里程碑或问题 ID 含义 | 同名合并、隐藏目录导致无法区分，编造本地文件名/解除条件，或拿状态页入口代替原文路径 |
-| “再更新一次。”来源、适用性和可见范围均未变化 | 无重复事件，不重写无变化的其他对象页 | 因观察时间或无关 HEAD 改变重复记账 |
+| “再更新一次。”来源、适用性和可见范围均未变化 | 不新增文件，不改内容或保存时间 | 因观察时间或无关 HEAD 改变重复记账 |
+| “更新进度。”协议 v4，计划连续多次有实际进展，每次原计划与里程碑记录均已回写 | 只更新该计划当前页的相关维度与来源；整体进度和当前阻塞可恢复，文件数不随回写次数增长 | 来源版本变化就新增事件，重抄各里程碑完成记录，或把旧建议/测试流水追加到当前页 |
+| “登记这轮代码评审。”协议 v4，有完整报告且无需整改 | 新建一个评审对象当前页，同时记录 review-recorded 与 review-not-required，链接原报告及所审版本，不新增事件 | 每个维度建事件、复制报告，或假造 apply 历史 |
+| “精简旧台账。”协议 v3，当前页列出已纳入历史事件，另有未纳入分支事件 | 明确切换 v4 并保留旧事件/ID；已覆盖历史压缩为末端及入口，未纳入事实与未解问题显式保留；后续普通回写只改当前页 | 批量删除历史，另存一套归档副本，跳过未纳入事件，或继续每次新增事件 |
+| “更新下一步。”协议 v4，当前页是唯一保留某授权条件与未解决定的地方，原文没有它们 | 保留唯一事实与来源限制；只有确需独立留存时才建补充事件，不能被新摘要覆盖 | 认为 Git 必有历史或 hash 可还原内容而删除唯一记录 |
+| “更新跟进。”项目明确要求每次变更不可变审计 | 按仓内审计规则留事件，保存实际前序与必要来源；不能用默认精简取消该要求 | 为减少文件擅自降级审计或授权要求 |
 | “换机器接着看。”同一里程碑存在完成、阻塞两条并发事件 | 保留两个末端，核对证据可见性；未知范围不推成已完成 | 按机器时间取最后一条，或未同步当成没做 |
 | “只看支付计划。”有许多历史 PRD/计划，类型索引已按领域分片 | 读支付对象与真实依赖，不加载全部历史；全项目查询沿全部活动分片核对范围 | 把首个分片当作全仓，或单对象查询全文读取所有历史 |
 | “继续旧计划。”已有 goal/ 计划、旧记录链接与 docs/project-status/ 台账 | 沿原入口更新，无新迁移授权不搬迁或双写；新建原产物遵循用户习惯和项目既有约定 | 因新默认目录建立第二份进度；旧记录断链 |
-| “初始化跟进。”PRD 在产品目录、计划在 goal/、评审在 reviews/，文件名不含 UUID | 仅在 `.xgent-ai/sdlc/` 创建分类状态与事件，来源指向原文件；原名、路径和内容保持不变 | 创建 PRD/计划/评审/日志副本，重命名原文，或把原产物默认路径改成状态目录 |
+| “初始化跟进。”PRD 在产品目录、计划在 goal/、评审在 reviews/，文件名不含 UUID | 仅在 `.xgent-ai/sdlc/` 创建分类当前状态与必要索引，来源指向原文件；原名、路径和内容保持不变 | 创建 PRD/计划/评审/日志副本，重命名原文，或把原产物默认路径改成状态目录 |
 | “只保存一次排障交接。”没有 PRD/开发计划 | 优先引用已有记录；必要时开发排障仅在 sdlc/status/task/ 保存状态，非开发调查用 tasks/；不强建计划 | 所有任务挤进一份全局状态，或把排障原始日志复制进 sdlc/ |
-| “初始化跟进。”只发现一份开发计划；另一次仅保存非开发任务交接 | 实际创建的根、中间层、类型、事件叶目录或 tasks/任务目录均有 index.md，逐层可达；无空类别 | 仅类型目录有索引，漏根或事件目录；为了有索引预建整棵空树 |
-| “更新这个里程碑。”已有对象增加一条事件，顶层重点未变 | 新增事件并更新本对象状态页及事件索引；其他索引不重写；事件集合不包含索引或分片 | 每次变更修改全树索引；把 index.md 算成新事件；重跑无变化仍写文件 |
+| “初始化跟进。”只发现一份开发计划；另一次仅保存非开发任务交接 | 实际创建的根、中间层、类型或 tasks/任务目录均有 index.md，逐层可达；无空类别或事件树 | 仅类型目录有索引，漏根；为了有索引预建整棵空树 |
+| “更新这个里程碑。”协议 v4，已有对象进度变化，身份/去向与顶层重点未变 | 只改本对象当前页和相关来源链接，不新建事件或修改索引 | 每次变更修改全树索引、增加事件文件，或重跑无变化仍写文件 |
 | “合并两机的跟进记录。”双方各新增事件，索引单边覆盖且有缺失目标 | 保留事件，按 ID/路径恢复双方索引条目；缺失来源标待核对；保留人工说明与历史 | 按时间选一方索引，删除另一方事件，或因本机缺文件清理历史 |
+| “合并两机的当前页。”协议 v4，同一对象一方完成、一方阻塞，另有当前页直接保存的新事实 | 按维度核对双方来源与版本，保留未解冲突；来源不足以保留独立观测才建补充事件；旧事件不覆盖后来直接回写的事实 | 按时间或完成优先取一方，只从旧事件重建而丢掉新事实 |
 | “只看下一步。”类型索引分片有漏项，事件目录无 index.md | 枚举可见文件发现缺项并说明覆盖限制，仍只读；后续获准更新时补齐索引和入口 | 查询时自动补文件，或因索引缺失断言没有待办 |
 | “更新跟进。”原计划没有登记评审，但同目录有 .review.md、.codereview.md 与 .code-review.md | 打开报告确认目标/类型/版本，补登记独立评审与关联，文档 review 与 code review 分开；不要求重跑评审 | 只信台账说未评审，或文件存在就判通过/完成 |
 | “看下一步。”同名报告指向另一个目录的计划，另有空评审模板 | 仅列候选或待关联，不把空模板算实际评审；其余计划继续核对 | 同名自动绑定；单个坏文件阻断全项目 |
 | “维护状态。”计划仍写未开始，但所有必需交付有当前版本实现及验证证据 | SDLC 写 dev-plan-completed / confirmed，保留 source_state 和原文滞后依据，不擅改原计划；重复更新无新事件 | 把状态行当唯一事实重开开发，或为了自愈改原文 |
 | “看完成情况。”计划自报完成，但完成记录只有快照计数、记录里只有一次局部测试，另有一份过期代码评审 | 判 dev-plan-completed，证据 provisional 并列出要补的记录或验证；过期评审保留该轮状态、证据 stale；不自动重跑测试 | 用 unknown 或候选代替判断，或把自报完成、有代码评审报告当成验收通过 |
 | “看下一步。”计划 4/4 完成且记录齐全，未找到计划文档评审，完成后相关文件另有 2 个提交 | 就绪判 dev-plan-ready（provisional，注明未发现评审），实施判 dev-plan-completed（stale，列出 2 个提交）；不建议给已实施计划补计划评审 | 就绪写 drafted、实施写 unknown 或候选，或要求重跑全部验收 |
-| “更新跟进。”仓内 state-model 与 v1 原样一致，旧事件为 unknown 加候选 completed | 替换为 v2 并在导航登记升级；按 v2 重判并追加接续事件，旧事件保留 | 继续写 unknown，覆盖或删除旧事件，或把项目改过的模型副本也直接覆盖 |
+| “更新跟进。”仓内 state-model 与 v1 原样一致，旧事件为 unknown 加候选 completed | 按兼容规则升级模型并在导航登记；用新版判定，保存方式遵循仓内协议，旧事件保留 | 继续写 unknown，覆盖/删除旧事件，把项目改过的模型副本直接覆盖，或仅因模型升级切换存储协议 |
 | “看下一步。”另有一份原文标为历史方案的旧计划，交付文件仍在仓内 | 归档列出并注明原文依据，不推就绪/实施状态，不给下一步 | 按判定顺序推出 ready、in-progress，或恢复旧待办 |
 | “评审后下一步。”一轮只有 F-01 已处理，另一轮无需修改，处置写在报告中 | 前轮部分处置保留未完项，后轮 review-not-required；不用 applied 文件是否存在判断，不让后轮覆盖前轮问题 | 部分 applied 变成整轮关闭；无意见仍推荐空跑 apply |
-| “采用固定状态并升级台账。”已有 v2 自由文本事件与并发前序 | 保留旧事件/ID，在模型中登记版本，证据充分才追加 v3 映射及前序；未授权升级的查询只给显示映射 | 覆盖旧事件，或把未知词语直接当 v3 固定状态 |
+| “采用固定状态并升级台账。”已有旧版自由文本事件与并发前序 | 保留旧事件/ID，在模型中登记版本；证据充分才保存固定状态，v4 写当前页；必要补充事件接续实际前序，未授权升级的查询只给显示映射 | 覆盖旧事件，把未知词语当固定状态，或因精简丢掉并发事实 |
 | “看下一步。”计划全部里程碑标已完成，但完成记录仍有「待提交」，工作树有对应改动 | 指出最终提交未完成，不判 dev-plan-completed；建议先按计划提交并回填 SHA，再 `review-code <计划>` | 判整体完成，或直接推荐差异核查、发布 |
 | “看下一步。”计划需求来源为某 PRD 的 P1，同目录有 `.code-review.md`（需要修改）与 `.code-review.r2.md`（通过验收） | 以轮次最大的 r2 为最新一轮，判代码验收通过，建议可选的 `review-prd-dev-gaps <计划>` | 按首轮判仍需修改，按文件时间猜最新一轮，或忽略需求来源不提差异核查 |
 | “看下一步。”计划同目录有 `.ui-review.md`（需要修改）、`.ui-review.r2.md`（需要修改 · 停滞预警）与 `.ui-review.r3.md`（需用户裁定） | 以 r3 为最新一轮，列出停滞项与可选项，等用户决定 | 按首轮推荐 apply，继续推荐修复或重跑评审，或跳过停滞直接推荐差异核查 |

package/skills/agi-mode/playbooks/sdlc.md

@@ -27,6 +27,7 @@
 | 跨项目协作 | 谁需要另一方提供什么、双方怎样配合；完整 CRD、Q&A、逐轮答复 | 被当前工作依赖的契约与责任已明确，未承诺部分有追踪 | 提出方固定用 `crd` 起草/修订、整合接收方回复及续接 Q&A；接收方固定用 `crd-respond` 评估/答复或收录澄清，详见第 4 节 |
 | 方案与开发计划 | 本方开发哪些对象与行为、排除什么、依赖谁；设计、需求映射、里程碑与提交点、实施入口 | 当前单元的范围、关键设计与前置成立，外部缺口未转为本方任务，项目要求的评审/处置已满足 | 写作或修订用 `dev-plan`，按 PRD 期次出计划用 `dev-plan <PRD> P1`（P = Phase，计划顶部记录需求来源）；设计评审用 `review-dev-plan` |
 | 文档评审处置 | 意见是否成立、怎样改才消除问题；修订原文与逐项处置依据 | 当前相关阻塞解除，其他待决项保留 | `apply-doc-review`；只审不改与落实修订分开 |
+| 功能逐项决策（可选） | 每项是什么、为什么需要，计划另述怎么做；用户决定与修订文档 | 指定范围逐项已有确认、驳回或修改后确认，未决与关联影响如实保留 | 用户希望逐项取舍时用 `spec-human-decision <PRD/计划>`；固定确认/驳回/修改，修改须附说明，用户确认不代替技术评审或就绪核对 |
 | 计划阻塞解除 | 处置后计划仍 `Blocked`：每个阻塞缺什么证据或决定、推荐怎么解；决策记录与回改后的计划 | 已解除项落进计划并重判就绪，剩余阻塞有解除条件与负责人 | `resolve-blocked`；能查证的先查证，需拍板的交互确认；可按轮多次运行直至 `Ready` |
 | 测试设计 | 用什么数据、动作和观察验证验收条件；条件到用例的映射 | 当前范围可测，缺少判据的条目已明确回传 | `test-plan`；用例草稿不是执行结果 |
 | 实施 | 本次单元实际改变了什么；代码、配置、迁移、实现/验证记录及提交 | 该单元必要行为与回归检查有适用证据，依赖方能使用；计划约定的提交已完成并在完成记录登记 SHA | 直接读已有计划的实施入口，可用 `/goal 按 <计划> 开发` 推进；按需用 [功能交付](feature.md)、[缺陷修复](bug-fix.md) 或 [重构与迁移](migration-refactoring.md) |
@@ -48,6 +49,8 @@
 
 各专用技能收尾时先给明确判定，再给可直接复制的下一条命令，由用户决定是否执行。指引下一步时与这些收尾提示保持一致，事实不足先补证：
 
+PRD 或计划成稿后，用户需要逐项确认功能取舍时可用 `spec-human-decision <文档>`，讲清功能、价值及计划中的做法，按决定修订文档并保存决定记录；修改版再次逐项确认。这个可选环节不改变下列评审和开工条件，也不把已有逐项答复再交整篇重复求批。
+
 1. （可选）`prd` → `review-prd`：需要修改则 `apply-doc-review <报告>`；可交接后按期次 `dev-plan <PRD> P1`。临时或小任务可直接从 `dev-plan` 开始。
 2. `dev-plan` → `review-dev-plan`：需要修改则 `apply-doc-review <报告>`；之后 `Blocked` 用 `resolve-blocked <计划>`（可多次），`Ready` 用 `/goal 按 <计划> 开发`。
 3. 实施按计划的提交点提交，全部里程碑完成后最终提交，SHA 记入完成记录，再提示 `review-code <计划>`。
@@ -104,6 +107,8 @@ CRD 承载一方向另一方提出的协作请求，QA 在这里是双方 **Q&A
 
 实际项目状态、并行计划与跨机恢复交给 [what-next](what-next.md)；持久化遵循 [目录约定](../references/workspace-layout.md)。`.xgent-ai/sdlc/` 只放状态与来源链接，原 PRD、CRD、计划、报告和验证记录继续留在项目约定位置。没有台账不妨碍咨询；只有初始化/更新或已有任务授权覆盖回写时才保存。
 
+新台账日常直接更新对象当前页，不为每次进展或来源版本变化另建事件；独立事件只按仓内协议用于明确审计要求或必须独立保留的并发/纠错事实。每轮实际评审仍独立保留对象与报告，同轮结论与处置同页。已有台账沿原协议，用户要求精简/升级时再兼容切换，保留旧证据。
+
 使用固定状态码时读取 [状态模型](../assets/sdlc/state-model.md)：取原文记录支持的最强状态，证据质量单独标注；已有项目的旧版模型按 what-next 的升级规则处理。本手册的生命周期名称不是新增枚举。模型中的独立验收线仍为 TBD，不据此发明默认 `passed`、`accepted` 或 `released` 状态；事实、来源与尚未定义映射分开报告。
 
 专用 skill、SPMS、CI、仓库或发布平台的可用能力在目标环境核实，不能从本手册或历史流程图推定已经安装、可写或具备某个接口。只装 agi-mode 时仍可完成流程指导；需要专用技能才说明具体缺口，不阻断不依赖它的工作。

package/skills/agi-mode/playbooks/what-next.md

@@ -9,18 +9,18 @@
 入口约定：`$agi-mode init-sdlc [PRD/计划/范围]` 明确授权初始化并保存状态；省略范围时盘点当前项目的可发现材料。`$agi-mode what-next` 默认只读，`what-next 更新` 保存核实后的变化；原有 `what-next 初始化` 等价于 `init-sdlc`。这些入口共用以下流程，不需要先运行另一条初始化命令。
 
 - **查询（默认）**：只读盘点，聊天交付状态表和下一步。无跟进表也能工作，不能因缺表要求先初始化。用户指定计划或需求时聚焦该范围，同时读必要依赖。
-- **初始化 / 更新跟进表**：用户要求建立、维护、刷新或保存状态时，核实来源，新增事实记录并刷新受影响的对象状态页及必要索引。首次读 [目录约定](../references/workspace-layout.md)，使用 [协议](../assets/sdlc/protocol.md)、[状态模型](../assets/sdlc/state-model.md)、[事件](../assets/sdlc/event.md)、[对象状态页](../assets/sdlc/object-status.md)、[分类索引](../assets/sdlc/type-index.md)、[导航](../assets/sdlc/index.md) 和 [通用目录索引](../assets/directory-index.md) 模板。已有等价台账则沿用其结构和事实源，不另建竞争台账。
+- **初始化 / 更新跟进表**：用户要求建立、维护、刷新或保存状态时，核实来源，按仓内协议更新受影响对象的当前状态及必要索引。新台账日常不另建事件。首次读 [目录约定](../references/workspace-layout.md)，使用 [协议](../assets/sdlc/protocol.md)、[状态模型](../assets/sdlc/state-model.md)、[对象状态页](../assets/sdlc/object-status.md)、[分类索引](../assets/sdlc/type-index.md)、[导航](../assets/sdlc/index.md) 和 [通用目录索引](../assets/directory-index.md) 模板；符合独立留存条件时才读 [补充事件模板](../assets/sdlc/event.md)。已有等价台账沿用其结构和事实源，不另建竞争台账。
 - **继续做**：本流程给出有证据的路由。用户同时明确授权继续某项工作时，完成状态核对后接续该任务；查询本身不授权开始实施、运行评审、提交、推送或部署。多个候选没有明确优先级时，推荐并说明理由，不擅自启动所有计划。
 
-`init-sdlc` 可重复执行：已有台账按其协议补齐缺失结构、索引及本次核实的状态，不覆盖已有协议或重置历史；无实质变化不重写。沿用已登记的自定义台账，不因该入口另建默认目录或静默升级。新项目尚无可登记材料时，只创建 `.xgent-ai/index.md`、`sdlc/index.md` 及协议、状态模型、事件模板，说明尚无工作项，不预建空类型或伪造事件。
+`init-sdlc` 可重复执行：已有台账按其协议补齐缺失结构、索引及本次核实的状态，不覆盖已有协议或重置历史；无实质变化不重写。沿用已登记的自定义台账，不因该入口另建默认目录或静默切换存储协议。新项目尚无可登记材料时，只创建 `.xgent-ai/index.md`、`sdlc/index.md` 及协议、状态模型，说明尚无工作项，不预建类型、事件树或事件模板。
 
 不要求联网或外部项目管理工具，不把本机缓存、对话历史或远程跟踪分支当作全项目实时真相。用户已有的执行授权继续有效。
 
 ## 1. 定位项目与记录
 
 1. 读取当前仓与适用目录的规则。Git 项目用仓根定位，记录分支或 detached HEAD、HEAD、dirty 状态；非 Git 项目记录目录范围和可用版本标识。持久化路径使用仓根相对路径，不写机器绝对路径、用户名或带凭证的 remote URL。
-2. 按 [目录约定](../references/workspace-layout.md) 定位台账：用户指定和仓库登记优先，已有 `docs/project-status/protocol.md` 可继续沿用；无旧台账的新默认是 `.xgent-ai/sdlc/`。多套台账没有明确切换记录时展示各自范围并核对，不武断选新目录为真。默认协议位于 `protocol.md`，导航和分类索引指向各对象状态页，事件按类型和对象分目录。
-3. 有台账时读协议、导航及分类索引，只展开活动或指定对象与依赖，核对各状态页的已纳入事件集合；遗漏说明视图陈旧。历史正文按需读。发现状态时在存在的 `.xgent-ai/sdlc` 下显式用 `rg --files --hidden`；原文则沿用户指定、仓库约定、来源链接及仓内实际文档目录发现，不能只搜索状态目录。目录名只作候选；跳过依赖、构建产物和技能范例。核对各层 index.md 与实际目录及分片覆盖，查询时报告缺索引、漏项和断链，不自动修复。index.md 与 index-*.md 不当作事件。未展开的内容明确未核实，不能因只看首页就称全项目无待办。
+2. 按 [目录约定](../references/workspace-layout.md) 定位台账：用户指定和仓库登记优先，已有 `docs/project-status/protocol.md` 可继续沿用；无旧台账的新默认是 `.xgent-ai/sdlc/`。多套台账没有明确切换记录时展示各自范围并核对，不武断选新目录为真。默认协议位于 `protocol.md`，导航和分类索引指向各对象当前状态页；有必要事件时才按类型和对象分目录。
+3. 有台账时读协议、导航及分类索引，只展开活动或指定对象与依赖。有事件时，v4 按前序可达性核对已核对末端，旧协议核对其已纳入集合；未纳入事件说明存在待核对事实，旧事件不覆盖当前页后来直接回写的事实。历史正文按需读。发现状态时在存在的 `.xgent-ai/sdlc` 下显式用 `rg --files --hidden`；原文则沿用户指定、仓库约定、来源链接及仓内实际文档目录发现，不能只搜索状态目录。目录名只作候选；跳过依赖、构建产物和技能范例。核对各层 index.md 与实际目录及分片覆盖，查询时报告缺索引、漏项和断链，不自动修复。index.md 与 index-*.md 不当作事件。未展开的内容明确未核实，不能因只看首页就称全项目无待办。
 4. 读取 PRD 范围/分期、每份相关计划的就绪状态、需求来源（PRD 与期次）和实施快照（含完成记录的提交 SHA）、报告基线/结论/处置节、决策记录的最新轮次，以及支撑下一步的验收记录。默认覆盖已发现的所有活动计划，归档项提供索引入口而不全文读取；没读到的范围明确标未核实。关联以原文需求 ID 和显式链接为准，不能因同名或相邻就关联。
 5. 按 [状态模型的发现与自愈规则](../assets/sdlc/state-model.md#发现与自愈) 查漏：同名 `.review.md`、`.codereview.md`、`.code-review.md`、`.ui-review.md`（UI 验收评审，目标包为 `.ui-target.md`）、带轮次文件（如 `<计划名>.code-review.r2.md`，轮次最大者为最新一轮）及其他项目命名均作候选，打开报告确认目标/类型/范围后才补关联；在报告处置节、`.applied.md` 和实施记录查已处理证据，不要求固定处置文件。单文件损坏或来源未同步时保留问题并继续其他对象，不能把“未登记”或“未找到”直接解释为“未做”。
 
@@ -28,7 +28,7 @@
 
 读取 [固定状态与证据校准](../assets/sdlc/state-model.md)，每个维度都给出一个固定状态码：按模型各节的判定顺序，取原文记录与可核验物支持的最强状态，再用 evidence_status 标依据质量与当前适用性；原文状态文字另存 source_state。只有完全没有可读依据时才写 unknown，不用 unknown 或候选代替判断。原文标为历史、废弃或已被取代的对象按模型的归档规则只列入口，不推就绪/实施状态，也不给下一步。
 
-台账的状态模型低于技能自带版本时，查询按新版判定，并说明台账仍是旧口径；初始化或更新时按模型「旧记录兼容」一节升级：仓内副本与旧版原样一致则替换并登记，项目改过的副本保留并列出差异请用户决定。其他已有协议与自定义沿用仓内版本；旧事件不改写，旧自由文本记录可在回答中映射。
+台账的状态模型低于技能自带版本时，查询按新版判定，并说明台账仍是旧口径；初始化或更新按模型「旧记录兼容」中的具体版本条件处理，项目改过的副本保留并列出差异。旧存储协议沿用仓内版本，用户明确要求精简或升级时才按协议切换为 v4，并保留项目原则、授权和审计要求。旧事件不改写，旧自由文本记录可在回答中映射。
 
 - 分开列 **文档就绪、实施进度、评审结论、整改处置、验收/集成**。`Ready` 不是已完成，里程碑完成不是 PRD 全部交付，修复已验证不是重新通过独立评审。
 - 对象状态页、事件与原文的状态行都可能滞后。计划定义范围与门槛，恢复快照、完成记录、登记的提交与实现/验证记录是实施依据；代码文件存在、复选框打勾、空 findings 或一次测试成功不能单独支撑完成。缺失、未核实、不适用、尚未做必须区分。
@@ -48,6 +48,7 @@
 | 核实到的情况 | 可推荐的动作（遵循项目已定流程，不强制补全流水线） |
 | --- | --- |
 | PRD 尚有影响范围或验收的未决项 | 指出具体待决项；需要撰写/修订时用 `prd`，质量评审用 `review-prd` |
+| 用户希望逐项确认已有 PRD/计划中的功能取舍 | `spec-human-decision <文档>`：每项讲清功能与价值，计划另述做法；固定确认/驳回/修改，修改须附说明并确认修订版，决定落实到文档；查询本身只推荐，不启动问答或改稿，逐项确认不等于技术评审或 Ready |
 | 本项目是 CRD 接收方，需评估/答复或续接提出方澄清 | 固定建议 `crd-respond <CRD>`；评估时基于最新工作树比较目标、原案与长期备选，在原文末答复，需本方改码时实际调用 dev-plan，未决契约按就绪门标 Blocked。仅原样追加/收录不重评或生成计划，仅评估/仅答复遵守边界，不发送或实施；查询本身不运行该技能 |
 | 本项目是 CRD 提出方，需起草/修订、跟进或整合接收方返回稿 | 固定建议 `crd`，核对发出、返回与本地版本，整合实际答复、追加本方澄清/确认，维护需求与 Q&A；收到文件或答复反问不切换技能。角色不明先核实；对方已回复不等于已承诺或完成集成 |
 | 文档评审有当前确认待处理意见 | 指定报告和原文交给 `apply-doc-review`；已 applied 或无需处理不重复执行，是否已处理不明时先补核查 |
@@ -75,11 +76,11 @@
 
 ## 4. 保存（仅写入模式）
 
-1. 首次建立默认台账时，将协议复制到 `.xgent-ai/sdlc/protocol.md`、状态模型复制到 `.xgent-ai/sdlc/state-model.md`、事件模板复制到 `.xgent-ai/sdlc/event-template.md`，按导航/分类索引/对象状态模板创建实际需要的文件；每个实际创建的目录同步建立 index.md，包括 `.xgent-ai/` 根、status/events 中间层和事件叶目录，其余层用通用目录索引模板。不建巨型 `STATUS.md`，不预建所有目录或空对象。已有文件先核对，不覆盖。协议和模型随仓保存，使仅安装其他技能的机器也能回写；旧协议升级按状态模型的兼容规则保留历史。自定义位置沿用仓库已有登记方式；没有登记时在适用 `AGENTS.md` 中仅补一条台账路径，用户禁止改规则文件时说明自动发现限制。
+1. 首次建立默认台账时，将协议复制到 `.xgent-ai/sdlc/protocol.md`、状态模型复制到 `.xgent-ai/sdlc/state-model.md`，按导航/分类索引/对象状态模板创建实际需要的文件；每个实际创建的目录同步建立 index.md。没有必要事件不复制事件模板或创建事件目录。不建巨型 `STATUS.md`，不预建空对象。已有文件先核对；用户已要求精简/升级时按协议与模型的兼容规则切换，否则沿用。协议和模型随仓保存，使仅安装其他技能的机器也能回写。自定义位置沿用仓库已有登记方式；没有登记时在适用 `AGENTS.md` 中仅补一条台账路径，用户禁止改规则文件时说明自动发现限制。
 2. 只登记本次核实的事实；旧材料导入记录的观察时间是现在，原活动时间能证实才写。不伪造中间阶段或历史轮次，关系不明的单列待关联。
-3. 按仓内协议与模型新增独立事件；同对象、维度、范围、来源内容、规范状态、证据质量/适用性和关系没有变化时不新增重复事件，不因无关提交改变 HEAD 就重复记账。补登记漏记评审及处置时沿用可确认的对象 ID，纠错追加事件并接续前序；只修漏索引或重建已有事实视图时不新造事件。更新各计划时只记相关维度，不复制完整正文，不因“自愈”擅自改原文状态。
-4. 按类型为每个已核实对象维护独立状态页，保存该对象精确的已纳入事件 ID 集合及当前核查基线；按协议的目录索引规则只刷新受影响状态页、本层索引与入口变化的祖先，补齐维护范围内缺失索引。事实、来源适用性、可见范围和建议均无变化时不重写视图，仅在回复说明已核对；表内时间保留上次保存时间。回读新事件、受影响状态页/索引和源链接，检查重复 ID、悬空前序、冲突、索引覆盖、遗漏活动计划和过期结论。结构正确不代表验收通过。
-5. 写入失败分别说明哪些记录/视图未完成；事件已保存而状态页失败时保留事件，下次可重建。默认不提交、推送或改远端，明确未提交记录尚未随 Git 共享。
+3. 按仓内协议保存。v4 日常直接更新对象当前页；来源版本或证据变化也不自动新增事件。只有明确审计要求或无法由原产物及其可取回版本保留的并发/纠错事实才独立留存。补登记评审及处置沿用可确认对象 ID，新一轮评审仍独立建对象；同轮两个维度写在同页。只修索引不造事件，不因“自愈”擅自改原文。
+4. 写前重读受影响状态页，合并本次触及维度，保留唯一待决、授权依据、未解冲突与必要来源；计划不另抄完整里程碑明细，已解决过程和旧建议不留在当前正文。有事件只记已核对末端和历史入口，不抄全量 ID。按协议只更新成员/去向变化的索引和实际变化的当前重点。事实、来源适用性、可见范围和建议均无变化时不改文件或保存时间，仅回复已核对。回读来源、受影响页/索引及必要事件，检查范围、链接、冲突和遗漏；结构正确不代表验收通过。
+5. 写入失败分别说明哪些记录/状态未完成；已保存事件保留，下次可恢复，不能仅从事件覆盖后来直接更新的事实。默认不提交、推送或改远端，明确未提交记录尚未随 Git 共享。
 
 ## 交付
 

package/skills/agi-mode/references/workspace-layout.md

@@ -1,6 +1,6 @@
 # 状态目录与原文档边界
 
-`.xgent-ai/` 是 agi-mode 的工作状态目录，开发生命周期的状态放在 `.xgent-ai/sdlc/`。**`sdlc/` 只放状态及其索引、协议、事件，不存放或复制 PRD、开发计划、评审报告、实施/验收记录、测试计划、日志、截图或原始证据。** 这些原产物的位置由用户习惯、项目约定与已有链接决定，本约定不改变各写作和评审技能的原文档落盘规则。
+`.xgent-ai/` 是 agi-mode 的工作状态目录，开发生命周期的状态放在 `.xgent-ai/sdlc/`。**`sdlc/` 只放当前状态及其索引、协议和必要补充事件，不存放或复制 PRD、开发计划、评审报告、实施/验收记录、测试计划、日志、截图或原始证据。** 这些原产物的位置由用户习惯、项目约定与已有链接决定，本约定不改变各写作和评审技能的原文档落盘规则。
 
 只读查询不创建目录；初始化和更新仅保存必要的状态文件，不为统一目录而搬迁或重命名原文档。
 
@@ -21,7 +21,6 @@
     index.md                   分类导航与当前重点
     protocol.md                项目内可独立执行的状态回写协议
     state-model.md             固定状态、证据门槛与自愈规则
-    event-template.md          单次状态变化记录模板
     status/
       index.md                 状态类型导航
       prd/index.md             PRD 状态索引
@@ -30,16 +29,11 @@
       plan/<object-id>.md      每份计划的就绪、实施进度和记录链接
       review/index.md          评审状态索引
       review/<object-id>.md    每轮评审的结论、整改状态和报告链接
-    events/
-      index.md                 事件类型导航
-      <kind>/
-        index.md               对象事件目录
-        <object-id>/
-          index.md             本对象事件清单
-          <event-id>.md        每次状态变化一文件
 ```
 
-按需创建，不预建空对象。无计划的开发任务需要恢复状态时，可增加 `status/task/` 等状态类型，不为跟进强建计划；实验也只登记状态和产物链接，实验材料仍沿用户指定位置保存。
+新台账默认协议 v4：日常直接更新对象当前页，不为每次进展新建文件。明确审计要求或必须独立保留的并发/纠错事实才按协议建 `events/<kind>/<object-id>/<event-id>.md` 及各层索引，首次需要时复制 `event-template.md`。旧事件按原路径保留，不因精简另存归档副本。
+
+按需创建，不预建空对象或事件树。无计划的开发任务需要恢复状态时，可增加 `status/task/` 等状态类型，不为跟进强建计划；实验也只登记状态和产物链接，实验材料仍沿用户指定位置保存。
 
 `experience/` 保存待复盘线索，不是 SDLC 状态或原始日志；收集由 `experience-capture` 负责，复盘由 `$agi-mode 复盘` / `$agi-mode reflect` 读取。只安装 agi-mode 也可读取已有记录，无需先安装收集 skill；用户指定或项目登记的已有经验目录优先，不双写。
 
@@ -56,21 +50,23 @@
 - 状态对象与事件使用独立 UUID；原文件不要求 UUID 命名、不嵌入台账编号，不因登记改名。每次实际评审有独立对象 ID，通过所审对象、范围、版本和报告链接区分轮次。
 - `artifact`、`sources.path` 保存原产物的仓根相对路径或可访问的稳定 URL；Markdown 链接按状态文件所在目录计算。例如状态页可引用仓内 `docs/requirements/`、`goal/`、`design/` 或任意用户目录，不能假定原文在 `.xgent-ai/sdlc/` 下。
 - 原文移动时先核实对应关系，沿用对象 ID、登记新旧路径并更新索引链接；状态整理本身不授权移动原文。跨机器按各自仓根解析路径，来源缺失标明未同步或不可核验。
-- 状态只存简要事实、关系、版本/指纹、证据位置、阻塞及下一步。完整问题说明、验收步骤和运行日志留在原处，不在状态目录另存副本作为新事实源。
+- 状态只存当前事实、关系、必要版本/指纹、证据位置、阻塞及下一步。完整问题说明、验收步骤和运行日志留在原处，不在状态目录另存副本作为新事实源；来源版本变化不自动要求独立事件。
 - 状态码按随仓保存的 [状态模型](../assets/sdlc/state-model.md) 固定，原文自述与证据质量单列。原计划状态行并非绝对真相；可用适用的实现、验证及处置证据纠正台账，保留差异与历史，不擅自修改原文。
 
 ## 增长与按需读取
 
-- 每个对象独立状态页，计划页面链接各轮评审页面；不把所有 PRD、计划与历史塞进一个 `STATUS.md`。实施状态归对应计划，详细实现与验收记录继续按原计划链接读取。
-- `sdlc/index.md` 列直接文件和状态/事件子目录入口，可快捷链接分类索引与当前重点。类型索引一对象一行，列 ID、标题、来源、状态页和活动/归档标记，不复制进度正文；归档标记须有来源，不按文件年龄推断。
+- 每个对象独立当前页，计划页面链接各轮评审页面；不把所有 PRD、计划与历史塞进一个 `STATUS.md`。同轮评审与处置在同页，计划页只汇总整体进展与当前局部阻塞，详细实现与验收记录继续按原计划链接读取。
+- `sdlc/index.md` 列直接文件和实际子目录入口，可快捷链接分类索引与当前重点；重点只留影响下一步的事实，不追加历次盘点、旧建议或测试流水。类型索引一对象一行，列 ID、标题、来源、状态页和活动/归档标记，不复制进度正文；归档标记须有来源，不按文件年龄推断。
 - 类型索引过大时按领域或年份分片，父索引列全分片及范围。归档另列索引，保留原对象及事件；不要求搬动原文或历史记录，不截断列表冒充完整盘点。
-- 查询先读分类索引，再读活动/指定对象及依赖；枚举对象和事件文件可发现遗漏，不默认全文加载全部历史。原产物从用户提供的位置、项目约定、已登记链接及仓内文档发现，不将状态目录当作唯一搜索范围。
+- 查询先读分类索引，再读活动/指定对象及依赖；枚举对象及必要事件可发现遗漏，不默认全文加载全部历史。有事件时当前页只保留已核对末端和历史入口，以前序可达性识别覆盖范围及待核对项，不重复列全量 ID。原产物从用户提供的位置、项目约定、已登记链接及仓内文档发现，不将状态目录当作唯一搜索范围。
 - `.xgent-ai` 是隐藏目录，状态发现显式使用 `rg --files --hidden .xgent-ai/sdlc`（目录存在时）或等价枚举；原文在其他隐藏目录时同样显式定位。必要来源被忽略时说明限制，不擅自改变项目忽略规则。
 
 ## 已有台账与共享
 
 状态台账位置按「用户指定 → 仓库明确登记 → 默认 `.xgent-ai/sdlc/`」确定。已有 `docs/project-status/protocol.md` 或等价台账沿原协议维护；新旧入口并存又无明确切换记录时先核对，不建立竞争台账或双写。
 
+用户明确要求精简或升级时按 v4 兼容规则切换，保留项目原则、授权和审计要求；未授权时旧台账继续按仓内协议写入。原事件不批量改写或删除，当前页可在核实覆盖范围后压缩历史清单，未解问题仍需显式保留。
+
 用户要求迁移台账时，只迁移状态资料：保留对象/事件 ID、历史结论、来源版本，转换相对链接并记录路径映射，核验后登记新入口。原文档不在迁移范围内；旧入口留指引，不同时维护两套状态。不可变事件的历史路径可通过映射解析，不改写历史 hash。
 
 开发任务仍以原计划及实施记录为恢复入口，状态页只是跨对象索引；没有现有恢复记录时才按需补充任务状态。使用 [项目状态流程](../playbooks/what-next.md) 与 [可复制协议](../assets/sdlc/protocol.md) 回写。协议、状态页与事件可随 Git 共享，来源文件仍各按项目方式同步；状态已同步不代表源码、原文和证据已同步。

package/skills/apply-code-review/SKILL.md

@@ -67,6 +67,6 @@ description: 用于按代码评审报告及其开发计划落实修复或复核
 
 ## 项目状态回写
 
-若仓库已登记状态台账，或存在仓根 `.xgent-ai/sdlc/protocol.md`（兼容已有 `docs/project-status/protocol.md`；两套并存且未登记切换时先核对，不能双写），交付原产物后读取台账的回写规则（默认目录读上述协议），按其格式新增本次事实记录并刷新受影响的状态页与必要索引；未启用时不自动建表，不依赖另装技能。只读/仅聊天/不保存要求优先，登记失败须说明，不影响如实交付已完成的原产物。
+若仓库已登记状态台账，或存在仓根 `.xgent-ai/sdlc/protocol.md`（兼容已有 `docs/project-status/protocol.md`；两套并存且未登记切换时先核对，不能双写），交付原产物后读取台账的回写规则（默认目录读上述协议），按仓内协议更新受影响对象的当前状态与来源链接，必要时维护索引；v4 日常直接更新当前页，事件留存条件或旧版事件要求以仓内协议为准；未启用时不自动建表，不依赖另装技能。只读/仅聊天/不保存要求优先，登记失败须说明，不影响如实交付已完成的原产物。
 
 接续原评审对象的处置维度，记录问题 ID、修复版本、验证和未完项，链接对应实现记录；仅同步实际改变的实施进度。已修改待验证与已验证分开，不把修复登记为独立复审通过。

package/skills/apply-doc-review/SKILL.md

@@ -107,6 +107,6 @@ description: 用于按评审报告修订 PRD、开发计划或复核修订效果
 
 ## 项目状态回写
 
-若仓库已登记状态台账，或存在仓根 `.xgent-ai/sdlc/protocol.md`（兼容已有 `docs/project-status/protocol.md`；两套并存且未登记切换时先核对，不能双写），交付原产物后读取台账的回写规则（默认目录读上述协议），按其格式新增本次事实记录并刷新受影响的状态页与必要索引；未启用时不自动建表，不依赖另装技能。只读/仅聊天/不保存要求优先，登记失败须说明，不影响如实交付已完成的原产物。
+若仓库已登记状态台账，或存在仓根 `.xgent-ai/sdlc/protocol.md`（兼容已有 `docs/project-status/protocol.md`；两套并存且未登记切换时先核对，不能双写），交付原产物后读取台账的回写规则（默认目录读上述协议），按仓内协议更新受影响对象的当前状态与来源链接，必要时维护索引；v4 日常直接更新当前页，事件留存条件或旧版事件要求以仓内协议为准；未启用时不自动建表，不依赖另装技能。只读/仅聊天/不保存要求优先，登记失败须说明，不影响如实交付已完成的原产物。
 
 接续原评审对象的处置维度，按评审 ID 与问题 ID 记录修订/复核及修后版本；同步确实改变的文档事实。不伪造新一轮独立评审，也不把部分关闭记成全部通过。

package/skills/apply-ui-review/SKILL.md

@@ -92,6 +92,6 @@ description: 用于按 UI 验收评审报告修复界面差距；不用于初次
 
 ## 项目状态回写
 
-若仓库已登记状态台账，或存在仓根 `.xgent-ai/sdlc/protocol.md`（兼容已有 `docs/project-status/protocol.md`；两套并存且未登记切换时先核对，不能双写），交付原产物后读取台账的回写规则（默认目录读上述协议），按其格式新增本次事实记录并刷新受影响的状态页与必要索引；未启用时不自动建表，不依赖另装技能。只读/仅聊天/不保存及 managed 能力异常时的只读边界优先，登记失败须说明，不影响如实交付已完成的原产物。
+若仓库已登记状态台账，或存在仓根 `.xgent-ai/sdlc/protocol.md`（兼容已有 `docs/project-status/protocol.md`；两套并存且未登记切换时先核对，不能双写），交付原产物后读取台账的回写规则（默认目录读上述协议），按仓内协议更新受影响对象的当前状态与来源链接，必要时维护索引；v4 日常直接更新当前页，事件留存条件或旧版事件要求以仓内协议为准；未启用时不自动建表，不依赖另装技能。只读/仅聊天/不保存及 managed 能力异常时的只读边界优先，登记失败须说明，不影响如实交付已完成的原产物。
 
 接着原评审对象登记处置：差距编号、处置、修复版本、自检结果和未完项，并链接实现记录。「已修改待评审」不登记为已解决，修复也不能登记成独立复审通过。

package/skills/dev-plan/SKILL.md

@@ -186,6 +186,6 @@ description: 仅在用户要求撰写、修订或评审开发计划、技术设
 
 ## 项目状态回写
 
-若仓库已登记状态台账，或存在仓根 `.xgent-ai/sdlc/protocol.md`（兼容已有 `docs/project-status/protocol.md`；两套并存且未登记切换时先核对，不能双写），交付原产物后读取台账的回写规则（默认目录读上述协议），按其格式新增本次事实记录并刷新受影响的状态页与必要索引；未启用时不自动建表，不依赖另装技能。只读/仅聊天/不保存要求优先，登记失败须说明，不影响如实交付已完成的原产物。
+若仓库已登记状态台账，或存在仓根 `.xgent-ai/sdlc/protocol.md`（兼容已有 `docs/project-status/protocol.md`；两套并存且未登记切换时先核对，不能双写），交付原产物后读取台账的回写规则（默认目录读上述协议），按仓内协议更新受影响对象的当前状态与来源链接，必要时维护索引；v4 日常直接更新当前页，事件留存条件或旧版事件要求以仓内协议为准；未启用时不自动建表，不依赖另装技能。只读/仅聊天/不保存要求优先，登记失败须说明，不影响如实交付已完成的原产物。
 
 登记计划的实际路径、版本、就绪状态与需求关联；实施状态只取顶部真实进度。评审模式登记独立评审事实，不替原计划改状态；本次仅聊天时不登记。

package/skills/dev-plan/references/plan-skeleton.md

@@ -48,7 +48,7 @@
 
 **独立记录**：按需建 `<计划名>.records/M<n>.md`，头部写计划链接、更新时区、状态及验证基线（commit SHA；未提交写 dirty@起始SHA 与关键改动路径）。正文只写交付行为/路径、必要偏差、未完项与继续动作；验收按 `检查 ID/覆盖范围 | 命令或步骤 | 结果/必要证据` 记录，共同环境和基线在头部写一次，有差异再单列。同一测试组可覆盖多条退出条件，须逐条可追溯；引用原证据与复用依据，不复制断言全文、成功日志或调试流水。证据是命令、结果和必要的少量输出，不为留证另写一次性脚本、哈希清单或大体量证据目录。未运行、失败、环境缺失明确区分；只有复杂交接、排错或证据需独立保存时才另建任务记录/日志/截图并链接。
 
-**项目跟进索引**：仓库已登记状态台账，或存在仓根 `.xgent-ai/sdlc/protocol.md` 时（兼容已有 `docs/project-status/protocol.md`；两套并存未切换时先核对，不双写），每次上述回写完成后，读取台账的回写规则（默认目录读上述协议）并追加本计划的实施变化记录，链接本节和对应验收记录，再刷新受影响对象状态页和必要索引；未启用则跳过。复用已有计划 ID，只更新本次触及的范围，保留其他计划和各轮评审；台账仅作项目索引，不替代本节的恢复快照。跨机器使用仓根相对路径与明确基线，未提交成果标明同步限制；登记失败说明缺口，不将原成果回退。
+**项目跟进索引**：仓库已登记状态台账，或存在仓根 `.xgent-ai/sdlc/protocol.md` 时（兼容已有 `docs/project-status/protocol.md`；两套并存未切换时先核对，不双写），上述回写完成后读取台账协议，只同步实际改变的当前状态和来源链接，必要时更新索引；默认直接更新本计划状态页，不因普通进展或来源版本变化另建事件，独立留存按仓内协议；未启用则跳过。复用已有计划 ID，只更新本次触及的范围，保留其他计划和各轮评审，不复制本节及里程碑记录；台账仅作项目索引，不替代本节的恢复快照。跨机器使用仓根相对路径与明确基线，未提交成果标明同步限制；登记失败说明缺口，不将原成果回退。
 
 **提交**：在里程碑表后的「提交点」提交：里程碑较多时在标出的阶段收口后提交，全部里程碑完成后必须提交一次；仓库规则或用户对分支、提交信息、签名或是否由 agent 提交另有要求时从其要求。提交前先回写本次进度；提交点要求的检查就是本次覆盖的里程碑或阶段收口的检查，已通过且未失效的证据直接引用，不为提交重跑；只暂存本计划相关改动，不纳入、不回退他人改动，不跳过提交钩子。提交后把短 SHA 写入完成记录中本次覆盖的各里程碑行的「提交」列（代码评审修复的提交写作「修复」加短 SHA，UI 验收修复的提交写作「UI修复」加短 SHA，均追加在原 SHA 之后），再单独提交这次只改计划文件的更新，该提交不回填自己的 SHA。已完成但未到提交点的行写「待提交」；无法提交时写明原因并记入当前阻塞，不伪造 SHA。