@xgent-ai/skills 0.5.0 → 0.7.0

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

@@ -0,0 +1,108 @@
+# 项目状态与下一步（what-next）
+
+回答三个问题：当前有哪些工作在推进，各自卡在哪里，现在最值得做什么。允许多 PRD、多计划、多轮评审和不同交付流程并存，不把整个项目压成一个线性阶段。`.xgent-ai/sdlc/` 只保存状态资料；原文档、报告、实施记录与证据始终按用户习惯和项目约定读取，不因初始化台账而创建副本、迁移或更改命名。
+
+只问流程知识、产物区别或技能选择时使用 [SDLC 指引](sdlc.md)，无需先盘点项目。状态查询需要解释阶段条件、跨项目交接或测试/发布顺序时按需读该手册，复用本流程已核实的事实，不重复盘点；状态码仍以状态模型为准。
+
+## 模式与边界
+
+入口约定：`$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) 模板。已有等价台账则沿用其结构和事实源，不另建竞争台账。
+- **继续做**：本流程给出有证据的路由。用户同时明确授权继续某项工作时，完成状态核对后接续该任务；查询本身不授权开始实施、运行评审、提交、推送或部署。多个候选没有明确优先级时，推荐并说明理由，不擅自启动所有计划。
+
+`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 不当作事件。未展开的内容明确未核实，不能因只看首页就称全项目无待办。
+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` 和实施记录查已处理证据，不要求固定处置文件。单文件损坏或来源未同步时保留问题并继续其他对象，不能把“未登记”或“未找到”直接解释为“未做”。
+
+## 2. 校准当前状态
+
+读取 [固定状态与证据校准](../assets/sdlc/state-model.md)，每个维度都给出一个固定状态码：按模型各节的判定顺序，取原文记录与可核验物支持的最强状态，再用 evidence_status 标依据质量与当前适用性；原文状态文字另存 source_state。只有完全没有可读依据时才写 unknown，不用 unknown 或候选代替判断。原文标为历史、废弃或已被取代的对象按模型的归档规则只列入口，不推就绪/实施状态，也不给下一步。
+
+台账的状态模型低于技能自带版本时，查询按新版判定，并说明台账仍是旧口径；初始化或更新时按模型「旧记录兼容」一节升级：仓内副本与旧版原样一致则替换并登记，项目改过的副本保留并列出差异请用户决定。其他已有协议与自定义沿用仓内版本；旧事件不改写，旧自由文本记录可在回答中映射。
+
+- 分开列 **文档就绪、实施进度、评审结论、整改处置、验收/集成**。`Ready` 不是已完成，里程碑完成不是 PRD 全部交付，修复已验证不是重新通过独立评审。
+- 对象状态页、事件与原文的状态行都可能滞后。计划定义范围与门槛，恢复快照、完成记录、登记的提交与实现/验证记录是实施依据；代码文件存在、复选框打勾、空 findings 或一次测试成功不能单独支撑完成。缺失、未核实、不适用、尚未做必须区分。
+- 原文自述与记录不符时按记录取状态并注明原文滞后，例如计划仍写“未开始”但完成记录覆盖全部里程碑，判 dev-plan-completed。只有自述没有记录时状态照判，证据记 provisional 并给补证动作；记录之后相关文件又有改动时状态不降级，证据记 stale 并列出未覆盖的提交。真实回归或失败的验证照实修正状态，不为保持完成忽略失败，也不盲从状态行重新开发。
+- 计划完成记录有「提交」列时，核对登记的 SHA 在当前分支可达，「待提交」表示成果仍在工作树。全部里程碑已完成但仍有「待提交」或缺 SHA，说明计划约定的最终提交未完成，不判 dev-plan-completed，列为缺口。
+- `.review.md` 内容确认后说明做过文档评审，`.codereview.md` / `.code-review.md` 内容确认后说明做过代码评审，`.ui-review.md` 内容确认后说明做过 UI 验收评审，均不证明已 applied 或已通过。每轮分别判 review-recorded 与处置状态；完整且无需整改的评审用 review-not-required，不推荐无意义的 apply。报告结论首行的判定（文档评审「是否需要修改」、代码评审与 UI 验收的「验收判定」）是该轮原结论，记入来源与摘要，处置仍按证据核对；用户豁免通过的未修问题按延期处理，不算关闭。文档 ready 与实施 completed 分维度；独立验收线暂为 TBD，不自动推导验收通过。
+- 每轮评审单独保留对象、范围、所审版本、报告及处置。报告之后代码/文档相关部分又有改动时，该轮状态保留，证据记 stale 并说明改动范围；只有需要对新改动下结论时才建议新一轮评审，不要求无关变更后重跑所有评审。
+- 读取本地分支/工作树与可用提交历史，区分本分支状态、其他分支记录和未提交成果。本地找不到远端提交时写“本地不可核验”，不能判为没做；远程跟踪引用未经刷新不能证明已同步。不自动 fetch/pull/checkout/stash。
+- 同对象同范围的矛盾记录按协议保留并列，不按日期、文件名或“完成优先”裁定。先核验能核验的来源；只对确实无法从仓内证据解决的决定提问，其余计划继续盘点。
+
+## 3. 选择下一步
+
+先服从用户当前目标和项目约定，再比较真实阻塞、已成立缺陷、依赖解除收益及可执行性。每条建议给出对象/路径、理由、前置条件、具体动作和完成判据；一般突出 1 个首选，另列可独立推进的工作。推荐专用技能时给可直接复制的命令（按当前客户端的技能调用写法），与该技能自身的收尾提示一致。不编造优先级、负责人或交期。
+
+涉及 UI 循环时，先读取 `<前缀>.ui-review.json`、报告及安装回执以区分人工与 managed。managed 当前报告和未结束轮次从索引及匹配 engine 的只读状态返回定位，不按 mtime 或 Markdown 最大后缀覆盖它；`review status` 的退出 0 不等于 UI 通过。只读查询不执行 begin、import、安装、评审或修复。下表的 UI 修复建议先满足循环能力边界。
+
+| 核实到的情况 | 可推荐的动作（遵循项目已定流程，不强制补全流水线） |
+| --- | --- |
+| PRD 尚有影响范围或验收的未决项 | 指出具体待决项；需要撰写/修订时用 `prd`，质量评审用 `review-prd` |
+| 本项目是 CRD 接收方，需评估/答复或续接提出方澄清 | 固定建议 `crd-respond <CRD>`；评估时基于最新工作树比较目标、原案与长期备选，在原文末答复，需本方改码时实际调用 dev-plan，未决契约按就绪门标 Blocked。仅原样追加/收录不重评或生成计划，仅评估/仅答复遵守边界，不发送或实施；查询本身不运行该技能 |
+| 本项目是 CRD 提出方，需起草/修订、跟进或整合接收方返回稿 | 固定建议 `crd`，核对发出、返回与本地版本，整合实际答复、追加本方澄清/确认，维护需求与 Q&A；收到文件或答复反问不切换技能。角色不明先核实；对方已回复不等于已承诺或完成集成 |
+| 文档评审有当前确认待处理意见 | 指定报告和原文交给 `apply-doc-review`；已 applied 或无需处理不重复执行，是否已处理不明时先补核查 |
+| 需求已有边界但尚未有承接计划 | 以明确的需求集合、开发对象与排除交给 `dev-plan`，按 PRD 期次时用 `dev-plan <PRD> P<n>`；不默认一份 PRD 对应一份计划，依赖系统缺口保留提供方与前置，不自动转成本方开发 |
+| 计划需要设计评审 | `review-dev-plan`，注明具体计划与版本 |
+| 计划评审意见已 apply，状态仍为 `Blocked` | 以该计划交给 `resolve-blocked` 逐项解除阻塞，可多次运行直至 `Ready`；不重跑 apply 或评审来消除阻塞。剩余项只等外部条件时先说明要拿到什么，条件未变时重跑不会改变结果 |
+| 验收条件已有口径但缺用例或执行证据 | 用例设计用 `test-plan`；已有用例则核对实际执行与覆盖缺口，不把用例草稿当通过，也不重复设计已覆盖项 |
+| 计划可实施且前置已满足 | 直接读计划实施协议继续对应里程碑，用 goal 推进时为 `/goal 按 <计划> 开发`；不加载 `dev-plan` 重写计划 |
+| 代码评审有当前仍成立的缺陷 | `apply-code-review <报告>`，计划可从报告头定位；修复后回到 `review-code <计划>` 复审。缺输入时先定位，不虚构关联 |
+| 计划实施完成待验收、修复已完成或待审代码范围明确 | 有计划时推荐 `review-code <计划>`：按完成记录登记的提交与未提交改动定范围，已有本计划报告时按轮次复审；无计划时明确 base/target 或工作树范围与对应历史报告 |
+| 代码评审已通过验收，变更涉及界面，且没有覆盖当前版本的 UI 验收 | 可选推荐 `review-ui <计划>`，它不是必经步骤；用户跳过时按闭环推荐差异核查 |
+| 已有 managed UI 索引，但 engine 缺失、不匹配、schema 未知或状态损坏 | 只读历史，可收集未登记素材；先说明如何恢复回执固定版本及匹配协议，恢复后续接原轮/revision。当前不推荐修产品、改目标/处置/计数/生成区，或换前缀、降人工重置历史 |
+| 人工 Markdown UI 历史没有 managed 索引，CLI 不可用 | 可继续原人工合同，不要求补装才能读取或续接；接管须用户明确要求并显式 import，未知尝试/重构次数保持未知 |
+| 匹配 managed 能力，索引当前轮仍草稿、缺证或等待确认评审 | 指向原轮次与缺项，建议用 `review-ui <原对象>` 续接补采/确认；不新开一轮绕过，不把旧轮通过或 CLI 退出 0 当本轮完成 |
+| 最新一轮 UI 验收判定需要修改（含停滞预警或待裁定标记） | `apply-ui-review <报告>`，计划与目标包从报告头定位；修复后回到 `review-ui <计划>` 复审。带待裁定标记时，同时列出这些事项请用户决定 |
+| 最新一轮 UI 验收判定需用户裁定 | 列出报告中停滞或待裁定的事项和可选项，等用户决定；用户给出方向前，不推荐继续 apply 或重跑评审 |
+| UI 验收已通过，但其 UI 修复带来的代码改动尚未经代码评审 | `review-code <计划>` 复审这些改动，再按闭环推荐差异核查 |
+| 实现已交付但验收缺证、未集成或未发布 | 给出具体补证/集成动作；不把评审通过当部署授权 |
+| 计划完成而 PRD 覆盖还未核对 | 计划来自 PRD 时可推荐 `review-prd-dev-gaps <计划>`（从需求来源定位 PRD 与期次），按闭环通常在最新代码评审通过验收或用户豁免之后；需要时带上所有相关计划，不重复创建已有 gaps plan |
+| 原计划状态滞后但实际交付已核实 | 显示规范状态与证据；写入模式修复 SDLC 跟进，原计划进度回写列为待同步项，在已有授权内处理，不重开已完成开发 |
+
+推荐的技能不存在时给出等价动作与输入，不要求安装才能解释状态。不把所有“未评审”自动变成阻塞，也不把待用户决策的工作推荐为可直接开工。
+
+开发验收默认由 Agent 执行；用户角色可按知识、资料与权限约束模拟，不因缺少真人测试者制造开发阻塞。确需真人的指标按原文来源与阶段列为公测/上线后验证；用户明确规定的开发真人门仍列实际前置，未验证项不算通过。缺设备、权限或真实集成证据时指出具体缺口，角色模拟不解除这些前置。
+
+## 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` 中仅补一条台账路径，用户禁止改规则文件时说明自动发现限制。
+2. 只登记本次核实的事实；旧材料导入记录的观察时间是现在，原活动时间能证实才写。不伪造中间阶段或历史轮次，关系不明的单列待关联。
+3. 按仓内协议与模型新增独立事件；同对象、维度、范围、来源内容、规范状态、证据质量/适用性和关系没有变化时不新增重复事件，不因无关提交改变 HEAD 就重复记账。补登记漏记评审及处置时沿用可确认的对象 ID，纠错追加事件并接续前序；只修漏索引或重建已有事实视图时不新造事件。更新各计划时只记相关维度，不复制完整正文，不因“自愈”擅自改原文状态。
+4. 按类型为每个已核实对象维护独立状态页，保存该对象精确的已纳入事件 ID 集合及当前核查基线；按协议的目录索引规则只刷新受影响状态页、本层索引与入口变化的祖先，补齐维护范围内缺失索引。事实、来源适用性、可见范围和建议均无变化时不重写视图，仅在回复说明已核对；表内时间保留上次保存时间。回读新事件、受影响状态页/索引和源链接，检查重复 ID、悬空前序、冲突、索引覆盖、遗漏活动计划和过期结论。结构正确不代表验收通过。
+5. 写入失败分别说明哪些记录/视图未完成；事件已保存而状态页失败时保留事件，下次可重建。默认不提交、推送或改远端，明确未提交记录尚未随 Git 共享。
+
+## 交付
+
+先用一句话说明总体情况和可见性边界，再给紧凑表格：`工作项（名称 / 原文文件） | 文档状态 | 实施进度 | 各轮评审/处置 | 证据 | 下一步`。聊天答复和写入台账的“当前重点”都遵循以下要求：
+
+- **每项可定位**：工作项写业务主题或原文标题、文档类型及原文的仓根相对路径，路径文字直接可见并尽量可点击，如“登录一期（开发计划）· [goal/LOGIN-P1.md](goal/LOGIN-P1.md)”。不能只写“PRD”“开发计划”“来源 CR”，也不能只链接 UUID 状态页；状态页可作补充入口。同名文件用目录和期次区分。材料没有本地文件时写实际来源链接与范围，不编造文件名。
+- **状态可理解**：用中文说明当前状态、进度和影响下一步的具体原因，同时保留固定状态码、轮次及证据码用于核对，如“实施受阻，3/7 完成：来源尚未提供完整对账接口（dev-plan-implementation-blocked）”。证据写“已核实（confirmed）”“待补证（provisional）”“已过期（stale）”“有冲突（conflict）”或“无可读依据（unknown）”，非 confirmed 时简述原因；不要只堆状态码或把部分交付写成整体完成。详细依据留在来源链接与台账。
+- **下一步可执行**：说明对哪个文件/事项做什么、当前缺什么以及怎样算完成，再给带实际输入路径的可复制命令。引用期次、里程碑或问题 ID 时同时说明事项含义，如“M4（接入外部待办来源）”，不要只写“接续 Q&A”“补齐契约”“取得解锁证据”。等待外部材料时列出所需交付，将下游动作明确写为条件满足后执行；材料未说明的含义或解除条件标为待核实。
+
+例如：
+
+```text
+| 登录一期（开发计划）· [goal/LOGIN-P1.md](goal/LOGIN-P1.md) | 已就绪（dev-plan-ready） | 已完成 4/4（dev-plan-completed） | 代码评审 R2 无需整改（review-not-required） | 已核实（confirmed） | $review-prd-dev-gaps goal/LOGIN-P1.md：核对登录一期需求覆盖，记录遗漏与差异 |
+| 计费（开发计划）· [goal/BILLING.md](goal/BILLING.md) | 设计受阻：退款范围待定（dev-plan-blocked） | 尚未开始（dev-plan-not-started） | 计划评审 R1 意见已处理（review-applied） | 已过期（stale）：评审后 §5 退款范围有改动 | $resolve-blocked goal/BILLING.md：确认退款范围并回写 §5，重判就绪后才能开发 |
+```
+
+PRD 没有计划、代码评审没有计划关联也单列，不静默遗漏。原文状态滞后时明确说明；验收事实另列，不冒充已定义统一验收流程。
+
+对象很多时按类型/范围分组并链接分类索引，首选动作突出但不静默遗漏其他活动项。各状态附源路径或事件链接，历史结论与当前判断分开。随后给首选动作和可并行候选，明确缺证/待决。写入模式附台账链接及同步情况；查询模式不声称已刷新文件。无活动工作或证据不足时如实说明，不强造下一项开发任务。
+
+```text
+使用 $agi-mode what-next 看看当前项目做到哪里、下一步做什么。
+使用 $agi-mode init-sdlc，纳入仓内现有 PRD、计划和评审的状态。
+使用 $agi-mode what-next 更新跟进表，重点核对 goal/LOGIN.md 与 design/billing-plan.md（使用项目实际路径）。
+使用 $agi-mode what-next 我换了机器，核对本地可见进度和未同步的证据。
+```

package/skills/agi-mode/principles/falsifiable-verification.md

@@ -18,4 +18,6 @@
 
 例如：源码改成无条件成功，非法输入测试却仍绿，应先核对是否运行旧构建，不能接受这次修复。
 
+评审、验收类流程同理：先喂设计稿、旧截图、按代码推断的描述等替代证据，确认它拒绝打分，而不只是拒绝坏实现。
+
 执行见 [突破阻塞](../playbooks/unblock.md)，方法见 [实验与反证](../references/experiments.md)。

package/skills/agi-mode/references/continuity.md

@@ -4,7 +4,9 @@
 
 ## 最小持久状态
 
-优先使用任务已有的计划或进度文件。只有跨会话恢复确有需要而现有文件不足时，才在项目约定的位置创建一份任务状态文件，并告知路径。不要生成第二套冲突的进度记录。
+优先使用任务已有的计划或进度文件，原文位置遵循用户习惯与项目约定。开发任务的跨对象状态按 [状态目录约定](workspace-layout.md) 保存在 `.xgent-ai/sdlc/`，通过链接引用原计划、实施记录和证据，不复制或迁移它们。只有现有记录不足以恢复时才补独立任务状态；非开发任务可用 `.xgent-ai/tasks/<task-id>/state.md`，无计划开发任务可按需用 `sdlc/status/task/<object-id>.md`。告知实际路径，不创建第二套冲突进度。跨计划/跨机盘点使用 [项目状态流程](../playbooks/what-next.md)。
+
+新建上述状态目录时，每层同时创建 `index.md`，包括 `.xgent-ai/`、`tasks/` 和任务目录；按 [通用目录索引模板](../assets/directory-index.md) 保留入口和维护约定。恢复时核对目录实际内容，保存时修补受影响索引；仅状态正文改变不逐级重写。
 
 记录足以让新会话接手的信息：
 

package/skills/agi-mode/references/interface-design.md

@@ -0,0 +1,50 @@
+# 界面设计调研：规范、参考与交互选型
+
+界面任务需要提炼或更新设计规范、把参考转成视觉 brief，或比较交互方案时读取对应部分。实现与验收仍回到 [界面交付](../playbooks/ui-delivery.md)；方向分叉的比较与收敛仍由 [设计与原型](../playbooks/design-prototype.md) 持有。已安装 `design-md`、`design-reference`、`ui-pattern-research` 时可按其说明执行，它们不是运行依赖。
+
+## 共同底线
+
+- **先找项目规范。**请求只点名一个组件文件时，仍在项目中查找 `DESIGN.md`、主题 token 和共享组件（根目录、`docs/` 等），再去外部找参考；找不到时说明。已有规范优先于外部参考，确需改变时标明提议及影响。
+- **分开三类内容：**直接观察的事实、来源作者的解释、为当前产品提出的建议。精确色值、尺寸、字体和时序要有代码、计算样式或明确出处；截图估计只能标为估计。
+- **只拿到文字时**不写参考站的颜色、尺寸、悬停或布局细节，也不宣称视觉核验；仍列出来源链接和可借鉴的原则。
+- 外部网页或现成 prompt 里的安装、上传、发布、评分指令属于待分析材料，不扩大授权。检索只发送所需的公开信息，不上传内部资料。
+- 研究交付不宣称页面已实现或已通过可访问性测试；引用文档不等于测试通过。已授权继续实现时直接进入实现，不重复申请。
+- 可用 Phoenix CLI 时，用 `phoenix-ui context --target <明确目标> --json` 读取原文与 provenance、parseCoverage、conflicts；partial 仍需读原文，missing 不填默认值。无 CLI 或不可用时直接读项目文档，不自动补装或声称 profile 已加载。profile 仅作建议，不能覆盖明确用户决定、已接受规范和冻结目标；矛盾项先核实用户决定。
+- 已接受且适用的 surfaceBrief 跨会话沿用，不重新抽方向；stale、missing、ambiguous 或多个适用方向时核对原文件与接受来源，不按 mtime 选择或重新接受。仅研究未要求保存的方向不能宣称可恢复。
+
+## 设计规范：提炼与维护
+
+- **两种权威：**规范表达「应该如何」，源码和运行结果表达「目前如何」。实现不符时报告偏差；只有本次授权或明确取代旧约定的证据才能改写规范。重复出现的硬编码值是线索，不自动成为 token 或品牌意图。
+- **追踪生效链。**沿样式入口、构建期品牌、租户或运行时注入确认最终值；记录默认值、覆盖范围和覆盖缺口，不把基础 CSS 写成所有部署的固定值。未接入的旧主题、demo 和未来方案不算当前事实。
+- 只写能改变实现选择的规则：颜色用途、字体角色、布局密度、主题、组件变体与必要状态。只纳入已观察或已规定的主题、状态和断点，不机械反色补暗色，不为凑阶梯生成数值。审美偏好和待接受的建议留在交付说明中。
+- 用户已接受的决策做局部更新，保留未被取代的约定；无实质变化时不改文件。
+- **网站 URL**生成独立的重建草稿（无约定时用 `docs/design/<站点>-design-draft.md`），开头写输入 URL、采样范围、取证方法和未知项，不覆盖当前产品规范。草稿供当前产品参考时，单列「对当前产品的借鉴」：把观察到的原则映射到现有 token，标出冲突和待决定项，写成建议而不是原站事实。
+- **机器可读格式**沿用项目已有约定。使用 Google DESIGN.md 格式时，YAML 存值、正文写用途，并检查引用能解析。可用 `npx @google/design.md lint DESIGN.md` 或 `export --format css-tailwind|json-tailwind|dtcg` 核验，但要检查实际输出是否保留了颜色、字体、尺寸和模式，不以退出码代替语义检查，也不靠删有效信息消除报错。
+
+## 视觉参考转成 brief
+
+1. 用一句话写清目标与约束：页面用途、受众、主要任务、必须保留的品牌与技术约束。营销页的效果不自动适用于高频产品界面；用户已指定参考时先分析它。
+2. 选少量互有差异、适合任务的具体页面或组件，记录链接、观察范围和访问时间。搜索摘要、获奖标签和收藏量只用于找线索；静态截图不证明响应式、悬停、键盘或状态切换。
+3. 每项参考写成：具体观察 → 在原界面中的作用 → 对当前任务的价值 → 采用或放弃的理由。品牌标识、文案和素材只在有权使用且确有需要时复用。
+4. brief 按需覆盖：目标与约束、参考取舍（附链接）、推荐方向、结构与主次操作、沿用规范与新提案的区分、必要状态、可用原语、验收的视口、主题、内容与操作，以及待核实项。实现者应能据此决定结构、样式和关键状态。
+5. 颜色、字体和状态映射到规范的 token 与规则。不挪用规范已有专门用途的 token，例如把选中用的 tint 拿来标未读、把强调色用于失败。新数值标为设计选择并说明用途。
+6. 用户接受方向且已授权保存/继续实现时，在项目约定的原 brief 中记录 target、来源及接受决定；有 CLI 时执行 `phoenix-ui surface-brief link <明确目标> <原brief路径> --decision <接受决定引用>` 并回读 context 核对原文件 hash。只存路径映射，不在 .phoenix-ui 复制第二份正文；无 CLI 时沿用原文并说明未建立机器映射。已冻结目标的变更须明确批准范围并重建基线。
+
+来源按缺口选择，不遍历：整页方向用 [Kage](https://kage.design/)、[Minimal Gallery](https://minimal.gallery/)、[Land-book](https://land-book.com/)；风格值用 [Refero Styles](https://styles.refero.design/)、[DesignMD](https://designmd.ai/)（第三方整理不等于官方规范）；组件外观与状态用 [Component Gallery](https://component.gallery/)，再跟进原设计系统；可复用代码用 [shadcn/ui](https://ui.shadcn.com/)、[21st](https://21st.dev/)，需核对技术栈、依赖和许可；动效用 [Motion Primitives](https://motion-primitives.com/)，需核对减少动态效果的处理和连续触发。
+
+## 交互方案选型
+
+1. 写出「谁要完成什么，当前困难是什么」。确认使用频率、数据量与分页或查询位置、现有组件、键盘与窄屏需求，以及接口实际支持的过滤、选择、权限和提交语义。不要把「后台」直接推导为密集表格、「权限」推导为树、「复杂」推导为向导。
+2. 先评估现有组件的最小组合，再比较真正改变任务完成方式的候选。按任务成本比较：找到目标需要什么操作、如何理解当前状态、误操作后如何恢复、规模和规则能否支撑、键盘与窄屏下能否完成同一任务。不为凑数列方案，不用没有依据的评分。
+3. 关键业务规则未知时不擅自定规则：给出条件推荐，说明每种可能答案会怎样改变推荐、状态或接口需求，并写明换用备选的具体条件。
+4. 把推荐写成行为契约，省略与本题无关的项：默认与入口；状态转换（区分空数据、无匹配、加载和错误）；提交时机、取消与失败后保留什么；批量范围与权限；键盘焦点与窄屏；实现依据（事实、假设和待定项分开）。不顺手新增保存视图、导出、撤销、审批等未要求的能力。
+5. 用具体输入走主路径和最易出错的分支，例如勾选后翻页、改筛选后仍有选择、批量请求部分成功、继承导致不可编辑，检查推荐是否成立、是否要求了接口没有的能力。
+
+**选型启发（先核实业务契约）：**
+
+- **筛选：**按需求逐级使用文本查询、选择器、属性条件或查询构建器。核对运算符和组合逻辑。远程分页不能用过滤已加载行冒充全量；接口不支持的语义（如 OR）要明确说明限制，给出当前可用方案和所需接口变更。即时应用还是显式提交，依据查询成本决定并写明理由。条件变更后重置分页，丢弃过期响应。
+- **表格与批量：**区分本页、跨页已选 ID 和当前查询的全部结果；服务端没有按查询执行或快照能力时，不承诺「全部匹配」。用稳定 ID 保存选择，不可见的已选项要显示并可清除，不悄悄扩大范围。不可操作项给出原因。逐项结果区分成功、失败、未知，只重试失败项。接口有单次上限时，比较「限制在一次请求内」与「前端分批」；分批要定义某批失败后继续还是停止，以及用户离开页面时已发送与未发送部分的状态。表格里有控件不等于需要 `role="grid"`。
+- **权限：**先确认谁给谁、对哪些资源授予哪些操作，以及继承、覆盖和有效权限如何计算。界面区分直接授予、继承来源和有效结果。`mixed` 状态不兼任继承、拒绝或只读；「拒绝」需要业务依据。UI 禁用不是服务端校验。矩阵、树形导航、分组列表加详情按任务选择，不按资源数量设固定阈值。
+- **编辑容器：**行内编辑、抽屉或分栏、详情页、向导按任务选择；向导只用于有真实先后依赖的流程。说明切换对象、关闭、后退和提交失败时如何处理未保存修改，以及焦点的进入和返回；不凭桌面抽屉截图推定手机体验。
+
+依据：[Cloudscape 筛选模式](https://cloudscape.design/patterns/general/filter-patterns/)、[WAI-ARIA Table](https://www.w3.org/WAI/ARIA/apg/patterns/table/) / [Grid](https://www.w3.org/WAI/ARIA/apg/patterns/grid/) / [Treegrid](https://www.w3.org/WAI/ARIA/apg/patterns/treegrid/)、[Carbon Data table](https://www.carbondesignsystem.com/building-blocks/core/components/data-table/guidelines)。它们是比较起点，不要求项目采用对应控件。

package/skills/agi-mode/references/principle-tradeoffs.md

@@ -0,0 +1,12 @@
+# 原则冲突裁决
+
+先满足指令、用户目标与必要不变量，再选择成本更低的执行方式。原则不能扩大授权或降低验收。对真实取舍说明“什么约束使我们选择什么”，不要求在回复中罗列原则名。只在读过对应文件且它确实改变了决定时引用它。
+
+| 张力 | 裁决依据 |
+| --- | --- |
+| 少改代码 vs 完整交付 | 做满足全部必要验收的最小变化，不能漏掉必要调用方 |
+| 先建基础 vs 快速见到结果 | 前置实际阻塞后续工作的基础，用最小端到端切片校验它 |
+| 自主推进 vs 产品决定 | 事实主动查证、范围内选择主动执行；不可推导的关键偏好保留给用户 |
+| 退出旧路径 vs 兼容性 | 内部可控消费者同批迁移；外部承诺用明确兼容窗口兑现 |
+| 持续尝试 vs 收敛 | 必要工作有有效路径就继续；无信息动作换策略，达标即结束 |
+| 复用证据 vs 再次验证 | 依输入与环境是否仍适用判断，既不盲信旧结果，也不机械重跑全部 |

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

@@ -0,0 +1,76 @@
+# 状态目录与原文档边界
+
+`.xgent-ai/` 是 agi-mode 的工作状态目录，开发生命周期的状态放在 `.xgent-ai/sdlc/`。**`sdlc/` 只放状态及其索引、协议、事件，不存放或复制 PRD、开发计划、评审报告、实施/验收记录、测试计划、日志、截图或原始证据。** 这些原产物的位置由用户习惯、项目约定与已有链接决定，本约定不改变各写作和评审技能的原文档落盘规则。
+
+只读查询不创建目录；初始化和更新仅保存必要的状态文件，不为统一目录而搬迁或重命名原文档。
+
+## 状态布局
+
+```text
+.xgent-ai/
+  index.md                     工作状态总入口
+  experience/                  开发经验收件箱，首次有效记录时创建
+    index.md                   任务记录导航
+    <task-id>.md              简短观察、证据链接及复盘处置
+  tasks/                       非开发任务按需创建
+    index.md                   任务目录
+    <task-id>/
+      index.md                 本任务状态文件入口
+      state.md                 恢复状态
+  sdlc/
+    index.md                   分类导航与当前重点
+    protocol.md                项目内可独立执行的状态回写协议
+    state-model.md             固定状态、证据门槛与自愈规则
+    event-template.md          单次状态变化记录模板
+    status/
+      index.md                 状态类型导航
+      prd/index.md             PRD 状态索引
+      prd/<object-id>.md       每份 PRD 的状态与原文链接
+      plan/index.md            开发计划状态索引
+      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/` 等状态类型，不为跟进强建计划；实验也只登记状态和产物链接，实验材料仍沿用户指定位置保存。
+
+`experience/` 保存待复盘线索，不是 SDLC 状态或原始日志；收集由 `experience-capture` 负责，复盘由 `$agi-mode 复盘` / `$agi-mode reflect` 读取。只安装 agi-mode 也可读取已有记录，无需先安装收集 skill；用户指定或项目登记的已有经验目录优先，不双写。
+
+## 每层目录索引
+
+`.xgent-ai/` 下每个实际创建的目录都维护 `index.md`，包括根目录、中间层、对象事件目录、任务目录及后续归档/分片目录；不要求原文档所在目录采用本约定。新目录与其索引同批创建，旧状态目录缺索引时在获准维护范围内补齐，查询模式只报告缺失。
+
+普通目录使用 [通用目录索引模板](../assets/directory-index.md)，SDLC 入口使用 [工作导航模板](../assets/sdlc/index.md)，对象分类使用 [类型索引模板](../assets/sdlc/type-index.md)。每层索引列出直接文件及子目录入口，子目录链接其 `index.md`；索引自身不自列，不在上层重复展开全树。目录用途、覆盖范围和维护规则入口随索引保存，非开发任务索引也保留维护约定，不依赖 SDLC 已初始化。
+
+创建或改变目录内容的执行者负责同步索引；内容未改变去向时不逐级重写。新增、移动、归档、删除及多机合并的完整规则见 [协议：目录索引维护](../assets/sdlc/protocol.md#目录索引维护)。索引是可重建导航，不是进度事实、锁或不可变事件；事件枚举必须排除索引文件。
+
+## 身份与来源
+
+- 状态对象与事件使用独立 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、标题、来源、状态页和活动/归档标记，不复制进度正文；归档标记须有来源，不按文件年龄推断。
+- 类型索引过大时按领域或年份分片，父索引列全分片及范围。归档另列索引，保留原对象及事件；不要求搬动原文或历史记录，不截断列表冒充完整盘点。
+- 查询先读分类索引，再读活动/指定对象及依赖；枚举对象和事件文件可发现遗漏，不默认全文加载全部历史。原产物从用户提供的位置、项目约定、已登记链接及仓内文档发现，不将状态目录当作唯一搜索范围。
+- `.xgent-ai` 是隐藏目录，状态发现显式使用 `rg --files --hidden .xgent-ai/sdlc`（目录存在时）或等价枚举；原文在其他隐藏目录时同样显式定位。必要来源被忽略时说明限制，不擅自改变项目忽略规则。
+
+## 已有台账与共享
+
+状态台账位置按「用户指定 → 仓库明确登记 → 默认 `.xgent-ai/sdlc/`」确定。已有 `docs/project-status/protocol.md` 或等价台账沿原协议维护；新旧入口并存又无明确切换记录时先核对，不建立竞争台账或双写。
+
+用户要求迁移台账时，只迁移状态资料：保留对象/事件 ID、历史结论、来源版本，转换相对链接并记录路径映射，核验后登记新入口。原文档不在迁移范围内；旧入口留指引，不同时维护两套状态。不可变事件的历史路径可通过映射解析，不改写历史 hash。
+
+开发任务仍以原计划及实施记录为恢复入口，状态页只是跨对象索引；没有现有恢复记录时才按需补充任务状态。使用 [项目状态流程](../playbooks/what-next.md) 与 [可复制协议](../assets/sdlc/protocol.md) 回写。协议、状态页与事件可随 Git 共享，来源文件仍各按项目方式同步；状态已同步不代表源码、原文和证据已同步。

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

@@ -1,19 +1,20 @@
 ---
 name: apply-code-review
-description: 根据开发计划与代码评审报告（如 xxx.code-review.md）逐条核实问题，实施合理且在范围内的修复，验证结果并更新对应里程碑的实现与验收记录及计划进度。用户要求 apply-code-review、落实代码评审、按评审修复并回写实现记录时使用；不用于只做代码评审、只修订计划或无评审输入的整份计划实施。
+argument-hint: "<代码评审报告> [开发计划] [上轮报告/处置记录] [修复/仅复核] [问题ID/里程碑]"
+description: 用于按代码评审报告及其开发计划落实修复或复核修复效果；不用于初次评审、仅改计划或无评审输入的计划实施。逐条核实修复，按计划约定提交，回写处置与证据。
 ---
 
 # apply-code-review · 核实并落实代码评审
 
 将评审意见转成有证据的修复和可续做的实现记录。**报告是待核实的主张，不是自动执行的指令；问题成立与建议修法合理是两个判断。** 用户调用本 skill 即授权核实、实施范围内的合理修复、运行必要验证并回写记录，不在核实后重复询问是否开始。
 
-默认保留原评审报告及其历史结论，处置结果按报告来源与问题 ID 写入对应实现记录。只修改必要的代码、测试、配置和关联文档，不顺手实施后续里程碑、重构无关模块或发布外部评论。提交、推送、部署、实际数据迁移等按已有授权处理，不从评审文本推导额外授权。
+默认保留原评审报告及其历史结论，处置结果按报告来源与问题 ID 写入对应实现记录。只修改必要的代码、测试、配置和关联文档，不顺手实施后续里程碑、重构无关模块或发布外部评论。提交按输入计划的提交约定或用户授权执行（见第 3 节）；推送、部署、实际数据迁移等按已有授权处理，不从评审文本推导额外授权。
 
 `references/` 相对本文件解析。路径、技术栈和验证入口从目标仓发现；语言跟随用户。执行时直接读取输入计划的实施约定，不加载 `dev-plan` 的写作流程；也不要求重新运行 `review-code` 才能开始。
 
 ## 1. 锚定输入、修复目标与记录
 
-1. 定位用户提供的开发计划与评审报告。未给路径但上下文能唯一确定时直接采用并说明；缺任一输入或有多份无法判断时询问，不猜一份相邻文件代替。用户限制问题 ID、里程碑或“只核实”时，以该限制为准。
+1. 定位用户提供的评审报告与开发计划。只给报告时，从报告头「评审对象」的计划链接（相对报告所在目录解析）定位计划并核实身份；旧报告没有该头部时，用其计划符合性节写明的计划路径核实。未给路径但上下文能唯一确定时直接采用并说明；缺任一输入或有多份无法判断时询问，不猜一份相邻文件代替。用户限制问题 ID、里程碑或“只核实”时，以该限制为准。
 2. 读取适用仓库规则、计划的实施须知/实施者定位/进度、相关任务与验收、完整评审报告；仅按需读取对应记录和依赖证据，不批量加载全部历史记录。历史计划按其等价约定执行，不强制迁移为新版模板。
 3. 记录计划与报告的路径、版本或内容 hash，报告所审的 base/target、工作树/index 范围，以及当前仓库、分支、HEAD、dirty 状态。默认在用户当前指定工作树修复；报告的历史 SHA 用于取证，不意味着自动 checkout 或修改旧分支。
 4. 阅读当前相关 diff，区分已有用户修改与本次修复。行号漂移时按符号和行为重新定位；报告与当前工作树不一致时核查后续变更，不能套用旧 patch，也不能因 SHA 不同就拒绝所有意见。目标仓或分支无法确定时先澄清，只暂停依赖该目标的写入。
@@ -21,6 +22,13 @@ description: 根据开发计划与代码评审报告（如 xxx.code-review.md）
 
 ## 2. 逐条核实并裁定
 
+### 再次 apply 与仅复核
+
+- 默认或明确“再次 apply / 继续修复”时，先读已有处置，再处理仍成立且在范围内的未解决项、已修改待验证项和回归。明确“仅复核 / 只核实 / 检查修复效果”时，不修改目标代码、测试、配置或计划正文；可运行必要且允许的验证，并按记录合同保存复核结果。仅聊天/不保存优先，不自动调用 review-code。
+- 输入是复审报告时，读取其上轮报告引用、逐项复审表和已有实现记录，按“报告原始版本 + 问题 ID”映射。已解决项只核对证据适用性；仍存在、部分解决、回归及本轮新增问题才进入可能修复清单，未复核/待核实不当成关闭或自动授权扩大范围。同号 F-ID 必须带来源，确认同一问题后沿用主记录并补来源映射，不重复施加补丁。
+- 旧问题不因不在当前 diff 中而跳过。逐项记录上次处置、本次证据与复核结果；已解决的有效证据可复用并说明理由，缺证只标待核实。新证据推翻先前关闭时保留历史并重新打开，当前事实优先于旧的 applied 标记。
+- 没有事实、处置、证据适用性或范围变化时，只回复已核对，不改文件/时间、不重记 SDLC 事件；已修改但缺验证的项仅补所缺验证。apply 的复核属于原评审处置，不生成独立复审通过记录，也不自动开始下一轮 review。
+
 - 阅读报告引用的真实代码、当前调用链、计划契约、适用规则及已有测试。需要对比时读取报告所审版本；修复是否必要以当前目标行为为准。检查调用是否可达、输入是否允许、上游是否已有保护、行为是否有意改变。
 - 能做行为复现的缺陷先补充或运行能暴露问题的测试/最小实验；静态已足够证明的类型、接线或契约问题不为形式强造复现。无法复现不等于误报：分清未触发、环境缺失与证据反驳。
 - 独立判断建议修法是否满足计划、保留兼容性并解决根因。缺陷成立但建议会造成回归时，采用更小且正确的修法，在记录里说明依据，不机械执行报告的替换代码。
@@ -33,21 +41,32 @@ description: 根据开发计划与代码评审报告（如 xxx.code-review.md）
 1. 按根因、依赖和风险安排顺序。同根因多条意见可一次修复，但保留所有来源 ID。独立小改直接实施；多项相互依赖的修复先简述顺序及验证点。当前任务不因一条待决项整体停下。
 2. 保留用户原有修改，不 reset、stash 或回退到报告基线来“清理环境”。改前重读受影响内容；并发修改冲突时先核对归属，只暂停相互冲突的部分。仅清理本次修改造成的孤立代码。
 3. 遵守计划的前置成果、风险门和验收安排。需要行为测试的修复先红后绿；回归测试覆盖实际触发条件及应保留行为，不只匹配实现细节，不删除或放宽有效断言来获得通过。纯文档或低风险机械修正按适用检查验证即可。
-4. 运行能证明修复和受影响契约的检查，再完成仓库/计划要求的相关验证。读取命令及配置确认作用范围；外部环境、数据操作或不可逆动作需要未获授权的权限时，只保留该项缺口，不阻断其他已授权的本地工作。
-5. 记录实际命令/步骤、环境、所测代码基线与结果。旧证据只在代码、配置、依赖、输入和环境均未受影响时复用，附原记录与复用理由；不得把报告中的成功声明当作本次运行结果。失败区分新增回归、已有失败与环境问题。
-6. 新增回归继续修复并重跑受影响检查；通过后不重复无关全量测试。仍缺关键验证时标为“已修改待验证”，不能写“已修复并验证”。后续修改使先前测试失效时，重新验证受影响部分。
+4. 每条修复只跑能证明它的最低层检查：单元或契约测试能复现并证明的缺陷，不为它跑端到端或真实环境走查。全部修复完成后，把受影响里程碑的局部检查和仓库提交规则要求的检查合并跑一次，不每修一条跑一轮。不重跑全量测试或整套收口检查：修复改动共享契约、公共入口、构建或依赖时，扩大到受影响调用方的检查；缺陷只能在集成或真实环境中观察时，只重跑覆盖它的那几项收口检查。计划还有未通过的阶段收口时，全量回归留给该收口；没有时在记录写明未重跑的收口检查及依据。读取命令及配置确认作用范围；外部环境、数据操作或不可逆动作需要未获授权的权限时，只保留该项缺口，不阻断其他已授权的本地工作。
+5. 记录实际命令/步骤、环境、所测代码基线与结果。旧证据只在它实际覆盖的代码、契约、配置、依赖或数据没被本次修复改动时复用，附原记录与复用理由；不得把报告中的成功声明当作本次运行结果。失败区分新增回归、已有失败与环境问题。
+6. 新增回归继续修复，并重跑失败项和受影响的局部检查。仍缺关键验证时标为“已修改待验证”，不能写“已修复并验证”。后续修改使先前测试失效时，重新验证受影响部分。
 7. 按 [references/record-contract.md](references/record-contract.md) 回写对应实现记录与必要进度。仅在当前计划正文确实受修复影响且改动已在授权范围内时就地同步结论，不通过改需求/退出条件迁就实现；重大范围或设计改变先解决决策。
+8. 计划有提交约定（如「实施进度」的「提交」条款）或用户授权提交时，按记录合同的「修复提交」提交本次修复并在完成记录登记「修复」加短 SHA，使下一轮代码评审能找到它。两者皆无时不提交，修复留在工作树，由复审作为未提交变更纳入；提交失败或被规则禁止时如实记录，不伪造 SHA。
 
 ## 4. 回写核验与交付
 
 - 每个已处理问题都有来源定位、核实结论、最终处置和证据；每项修改能追溯到合理意见或其必要回归修复。明确尚未处理的用户排除项或依赖阻塞，不把它们当已关闭。
 - 回读实际记录与计划变化字段，核对状态、计数、链接、验证基线及未完项。按计划提供的可用进度校验命令检查；脚本缺失/模板不适用时人工核对并说明。结构检查通过不代表行为验收通过。
 - 查看最终 diff，确认没有无关更改、原评审被篡改或用户修改被覆盖。测试、代码与记录必须描述同一修复状态；文档写入失败时明确回写未完成，不能只靠聊天宣称闭环。
-- 最终回复给出：修复与未采纳/已解决/待核实项摘要、实际验证结果、更新的计划和记录链接，以及剩余阻塞。没有需要修改的代码时如实说明，不为显示工作量造补丁。未解决项存在时区分“本次已处理范围”与“全部问题关闭”。
+- 最终回复给出：修复与未采纳/已解决/待核实项摘要、实际验证结果、修复提交 SHA（或未提交的原因）、更新的计划和记录链接，以及剩余阻塞。没有需要修改的代码时如实说明，不为显示工作量造补丁。未解决项存在时区分“本次已处理范围”与“全部问题关闭”。
+- 结尾提示下一步：用 `review-code <计划路径>` 复审，按当前客户端的技能调用写法给出可直接复制的命令（如 Codex `$review-code`、Claude Code `/review-code`），路径填实际文件。代码评审是验收守门，修复后一律交回复审，由它判定通过验收或继续修改；有待用户决定的项一并列出，可在复审前决定。本技能不自行启动复审。
 
 调用示例：
 
 ```text
+使用 $apply-code-review goal/LOGIN.code-review.md
 使用 $apply-code-review，根据 goal/LOGIN.md 核实 goal/LOGIN.code-review.md，修复合理问题并更新对应实现记录。
 使用 $apply-code-review，计划 docs/plan/cache.md，评审 docs/reviews/cache.code-review.md，仅处理 F-01 和 F-03。
+使用 $apply-code-review goal/LOGIN.md goal/LOGIN.code-review.md，仅复核已有修复效果，参考 goal/LOGIN.records/M2.md。
+使用 $apply-code-review goal/LOGIN.md goal/LOGIN.code-review.r2.md，继续修复仍存在的问题，沿用报告中的前轮关联。
 ```
+
+## 项目状态回写
+
+若仓库已登记状态台账，或存在仓根 `.xgent-ai/sdlc/protocol.md`（兼容已有 `docs/project-status/protocol.md`；两套并存且未登记切换时先核对，不能双写），交付原产物后读取台账的回写规则（默认目录读上述协议），按其格式新增本次事实记录并刷新受影响的状态页与必要索引；未启用时不自动建表，不依赖另装技能。只读/仅聊天/不保存要求优先，登记失败须说明，不影响如实交付已完成的原产物。
+
+接续原评审对象的处置维度，记录问题 ID、修复版本、验证和未完项，链接对应实现记录；仅同步实际改变的实施进度。已修改待验证与已验证分开，不把修复登记为独立复审通过。

package/skills/apply-code-review/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "落实代码评审"
-  short_description: "结合开发计划逐条核实代码评审，修复合理问题、验证结果并回写实现记录"
-  default_prompt: "使用 $apply-code-review，根据指定开发计划和代码评审报告逐条核实并修复合理问题，验证结果，更新对应实现记录及必要进度，汇报处置、证据和剩余缺口。"
+  short_description: "按代码评审报告逐条核实并修复，按计划约定提交，回写记录后交回复审"
+  default_prompt: "使用 $apply-code-review，根据指定代码评审报告（从报告定位开发计划）逐条核实并修复合理问题，验证结果，按计划约定提交修复并登记 SHA，更新对应实现记录及必要进度；汇报处置、证据和剩余缺口，提示用 review-code 复审。"

package/skills/apply-code-review/references/record-contract.md

@@ -8,6 +8,19 @@
 4. 一个问题跨多个里程碑时，选直接承载修复的里程碑为主记录；其他实际受影响记录只同步相关验证/状态并链接主记录，避免复制整份处置表。集成终验归其原定收口里程碑，不新造“评审整改”里程碑改变总数。
 5. 记录已有内容须保留仍有效的交付事实、证据与未完项，只更新受影响部分。保留源 `xxx.code-review.md` 的问题与原结论；用户明确要求更新它时，追加可区分版本的处置摘要及记录链接，不把历史评审结论改成“当时就正确”。
 
+## 重复执行与修复效果复核
+
+读取输入报告引用的上轮报告及既有处置，以“来源报告/原始版本 + 问题 ID”建立对应关系；报告追加处置不改变原问题身份。复审报告中的旧问题通过明确映射接续，新问题保留新来源。报告链接相对记录所在目录，所审、修后与本轮核查版本分别保留。
+
+复核结果统一为 **已解决、仍存在、部分解决、回归、待核实、不再适用、本轮未复核**，与下文的处置状态分开：复核结果回答当前效果，处置状态记录做过什么及还缺什么。回归需先前关闭和当前失败证据；不再适用须有契约/范围依据，不表示已修复；证据不足不写已解决。
+
+沿用已有处置表，在同一条目保留上次处置/版本、本轮结果与当前证据；可加列，不另建重复整改台账。至少能读到：
+
+| 来源报告 / 问题 ID | 上次处置 / 版本 | 本轮复核结果 | 当前处置 / 修改 | 证据与适用范围 | 剩余动作 |
+| --- | --- | --- | --- | --- | --- |
+
+“仅复核/只核实”保留目标产物，只保存必要的复核记录；不会新增修复数或推进计划完成数。若用户要求完全只读/仅聊天，则不保存任何记录。原有关闭被推翻时保留历史及重新打开的依据；用户限定范围外标本轮未复核。无实质变化时不改内容或时间，不重复写台账事件；仅补缺证时接续原条目。
+
 ## 逐条处置
 
 以 **报告路径 + 报告版本/hash + 问题 ID/章节** 标识来源，避免不同报告都含 F-01 时串项。复跑同一报告、同一问题时更新已有条目并重新核对当前代码，不重复建表/记录，不重复施加补丁；新版本改变主张时注明新来源。状态可沿用仓库等价用语，但至少分清：
@@ -21,7 +34,7 @@
 | 待核实/待决策 | 缺事实、验收条件或关键选择；给影响、需要的证据/决定及可继续范围 |
 | 待修复/阻塞 | 已确认合理且需修，但尚未实施或依赖未满足；给阻塞、已完成部分和继续动作，不用“不采纳”掩盖未做 |
 
-用户排除的条目标“未处理（用户限定范围）”，说明来源范围即可，不展开额外调查。仅核实或全部不采纳时也记录相关结论，但不得据此增加完成数量或声称有代码修复。
+用户排除的条目标“未处理（用户限定范围）”，说明来源范围即可，不展开额外调查。仅核实或全部不采纳但有新结论时也记录依据，已有相同有效结论不重写；不得据此增加完成数量或声称有代码修复。
 
 ## 记录最小内容
 
@@ -67,6 +80,7 @@
 ## 计划同步与完成门
 
 - **顺序**：先更新记录并确认落盘，再更新计划恢复快照的变化字段及对应完成记录行。摘要只留 1–2 句当前成果/缺口，命令和逐条处置只在记录中。相关正文确有已授权偏差时就地改结论，不在计划里追加评审讨论历史。
+- **修复提交**：计划有提交约定或用户授权提交时，记录与进度落盘、SKILL.md 第 3 节第 4 步的检查通过后提交本次修复；计划提交点的检查清单不为修复提交整套重跑，仓库提交规则另有要求时从其要求；只暂存本次修复及其记录，不纳入或回退他人改动，遵守仓库提交规范，不跳过提交钩子。提交后把「修复」加短 SHA 追加到主记录里程碑在完成记录的「提交」列（保留原实现 SHA，如 `a1b2c3d；修复 e4f5a6b`），再按计划约定单独提交这次登记更新，它不回填自己的 SHA。计划没有「提交」列时改写在该里程碑记录的评审修复来源行。不提交时在记录和最终回复说明修复仍在工作树。
 - **一里程碑一行**：沿用原记录链接，只更新受影响行；不为同一里程碑追加“修复一次”“再复核一次”的流水。按 `dev-plan` 协议，已记进展的里程碑状态只用「进行中 / 阻塞 / 已完成」，带时区；完成时移动到已完成行末，最近完成取最后一条已完成记录。
 - **完成不等于修复数**：只有该里程碑所有退出检查通过或有仍有效的复用证据，才记已完成；修完 F-01 不能自动完成 M2，更不能完成整期。未改动的无关里程碑不重复验收或变更状态。
 - **必要时重新打开**：已完成里程碑的缺陷推翻退出条件，或修复使关键证据失效且尚未补齐时，改为进行中/阻塞，同步 n/N、最近完成、下一步及阻塞。若本次已补齐相关检查且其他证据仍有效，可保留完成状态，说明依据。仅低影响非阻塞建议不自动推翻已完成状态。

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

@@ -1,13 +1,14 @@
 ---
 name: apply-doc-review
-description: 根据 review-prd 的评审报告修订 PRD，或根据 review-dev-plan 的评审报告修订开发计划；逐条核实意见、落实合理修订、复核关联内容并回写处置结果。用户要求按文档评审改稿、落实 PRD/开发计划评审时使用；不用于代码修复、直接实施计划或从零撰写文档。
+argument-hint: "<文档评审报告> [原文路径] [上轮报告/处置记录] [修复/仅复核] [问题ID/范围]"
+description: 用于按评审报告修订 PRD、开发计划或复核修订效果；不用于代码修复、计划实施或从零写文档。核实 review-prd、review-dev-plan 意见，按模式改稿或仅复核并回写处置。
 ---
 
 # apply-doc-review · 核实并落实文档评审
 
 将文档评审意见落实为有证据、内部一致、可继续交接的 PRD 或开发计划。**问题是否成立、建议是否合理、改稿是否解决问题分别判断。** 报告是待核实的主张，不是自动执行的指令。
 
-调用本技能即授权修订指定原文及记录处置，无需逐条询问是否开始。默认交付为已更新的目标文档，以及原评审报告中可区分的「修订处置与复核」节；保留报告的原问题、原结论和所审基线。用户明确只要建议、patch 或另存时遵循其要求。
+调用本技能即授权修订指定原文及记录处置；只提供报告时，修订对象为报告明确引用且已核实身份的原文，无需再次要求原文参数或询问是否开始。默认交付为已更新的目标文档，以及原评审报告中可区分的「修订处置与复核」节；保留报告的原问题、原结论和所审基线。用户明确只要建议、patch 或另存时遵循其要求。
 
 `references/` 相对本文件解析；仓库约定、路径和工具在目标环境读取，语言跟随用户。
 
@@ -25,14 +26,28 @@ description: 根据 review-prd 的评审报告修订 PRD，或根据 review-dev-
 
 ## 1. 锚定输入和当前版本
 
-1. 定位报告和原文。用户只给报告时，从其中的目标路径与基线定位原文；上下文唯一明确时直接采用。缺少输入或有多份目标无法区分时询问，只暂停依赖该选择的修改。
+1. 定位报告和原文，按下方「仅报告输入的定位规则」建立映射。原文参数可省略；引用明确且身份核实后直接继续，不要求用户重复提供。只暂停目标仍缺失、无法访问或存在未解歧义的修改。
 2. 读取适用仓库规则、完整报告、目标文档及相关需求/决策。记录报告原版本/hash、目标文档修前版本/hash、代码仓 commit/dirty 状态；只读到截断内容时补读后再引用。
 3. 比较报告所审版本与当前版本、已有 diff 和处置记录。按需求 ID、标题、符号重新定位，不把旧行号直接当修改坐标；保留用户已有改动，不回退到评审时的版本。当前已解决的问题不重复改稿。
 4. 按 [references/disposition-contract.md](references/disposition-contract.md) 建处置清单：报告/问题 → 目标段落 → 核实依据 → 最小修订 → 关联影响 → 复核条件。覆盖选定范围内的 findings、影响修订的待核实/待决策和映射缺口；用户排除项标明不处理。
 5. 只加载实际需要的写作参考：PRD 按需读可用 `prd/references/product-quality.md`，采用其模板时再读骨架；开发计划按需读可用 `dev-plan` 的写作/修订约定与骨架，复杂契约再读架构参考。使用它们校准质量，不启动从零写作、外部录入或计划实施流程。参考缺失则说明受限项，继续可独立完成的修订，不强制迁移历史文档或自定义模板。
 
+### 仅报告输入的定位规则
+
+- 用户显式指定原文时使用该目标并核对报告身份；省略时读取报告头「评审对象」中的类型、原文档链接、所审版本与范围。本地相对链接以**报告所在目录**解析，不以当前工作目录或仓根解析；远程 URL 沿可用访问方式读取，不自动发布外部修改。
+- 报告明确列出多个评审目标时按行分别映射，只处理用户指定范围；未限定时处理明确列出的目标。背景引用、关联 PRD/计划和代码链接不自动成为修订对象。某个目标不明时继续其他已明确对象。
+- 兼容旧报告：从覆盖/基线节的明确目标路径与已有上下文核实。引用失效时可按稳定文档 ID、仓内链接和移动历史寻找唯一对应原文；仅同名或去掉 `.review` 后缀不足以确认。找不到持久原文、存在多个候选或显式参数与报告指向不同对象时，先核对是否为移动/改名；仍无法消歧才询问，不默默选一份修改。
+- 当前内容 hash 与所审版本不同不等于目标错误；身份确认后按本节的版本比较核实哪些意见仍适用。保留报告原始引用与所审基线，原文迁移后的当前路径和修后版本写在处置节，不回退原文以匹配旧 hash。
+
 ## 2. 核实意见并解决必要决策
 
+### 再次 apply 与仅复核
+
+- 默认或明确“再次 apply / 继续修订”时，先读已有处置，再处理仍成立且在范围内的未解决项、已修订待核实项和回归。明确“仅复核 / 只核实 / 检查修复效果”时，不修改目标 PRD/开发计划正文；只核对当前内容和必要关联检查，按处置合同保存结果。仅聊天/不保存优先，不自动调用 review-prd 或 review-dev-plan。
+- 输入是复审报告时，沿其上轮报告引用、逐项复审表和处置节/applied 文档建立来源映射。已解决项只核对证据适用性；仍存在、部分解决、回归及本轮新增问题才进入可能修订清单。不同报告的同号 F-ID 不混用；确认同一问题后引用已有处置，不能因新报告路径或 appended 处置导致 hash 变化就重复改稿。
+- 逐项记录上次处置、本次证据和复核结果。用户限定范围外的条目明确未复核；缺证不算关闭，不为关闭意见改变产品承诺。当前证据推翻原关闭结论时保留历史并重新打开，而非沿用 applied 标记。
+- 原文、处置、证据适用性与范围均无实质变化时，只回复已核对，不重写原文/报告或刷新时间，也不重复记 SDLC 事件。仅补验证时更新已有对应处置；apply 复核仍属于处置，不冒称新一轮独立评审通过。
+
 - 亲自读取问题对应的原文、引用材料及相关代码行为。区分当前事实、未来目标、设计选择、假设与验收要求；不能因为新功能未实现就删掉 PRD 或把计划中的未来设计改成缺陷。
 - 对「遗漏」先查全文、附录和已有引用；对矛盾核对两处原文及适用版本。事实能查则先查，不让用户代替证据判断。代码/环境无法访问时明确限制，不能沿用报告的「已核实」声明冒充本次核实。
 - 问题成立但建议会改变已确认目标、引入回归或扩大范围时，采用满足原目标的最小合理修订；报告里记录偏离建议的理由，不能以拒绝建议修法代替解决问题。
@@ -67,13 +82,31 @@ description: 根据 review-prd 的评审报告修订 PRD，或根据 review-dev-
 2. PRD 检查需求可断言、关键场景预期状态、分期和终验一致；计划检查事实、路径、契约、依赖、验证与进度一致。目标采用 `dev-plan` 协议且工具可用时，用其实际路径运行 `check_paths.sh <计划> <仓库根>` 和 `check_progress.sh <计划> <仓库根>`；先检查脚本适用性，人工区分计划新增路径与错误复用。工具缺失/模板不适用则人工核对并说明。
 3. 只运行证明文档修订所需的检查，不为改稿启动整套实施或业务验收。未来验证写为计划要求；已有证据、静态推演和本次实测分开。缺关键复核则标「已修订待核实」，不能标关闭。
 4. 按处置合同在报告追加或更新独立处置节，保留原结论，写明修后基线、逐项状态、验证结果、当前就绪判断及未完项；这是本次修订复核，不冒称重跑了完整独立评审。
-5. 回读已写入原文和报告，核对链接、状态、统计及最终 diff，确认没有无关变更和覆盖用户修改。零改动也要如实记录逐条依据；写入失败分别说明哪份文件未完成。
+5. 回读已写入原文和报告，核对链接、状态、统计及最终 diff，确认没有无关变更和覆盖用户修改。原文零改动但有新核实结论时仍记录逐条依据；已有相同且有效的处置则不重写。写入失败分别说明哪份文件未完成。
+
+最终回复给修订文档与处置报告链接、主要改动、未采纳/待决项和实际检查结果，再给一行明确判定和可直接复制的下一步命令：按当前客户端的技能调用写法（如 Codex `$dev-plan`、Claude Code `/dev-plan`），路径填实际文件。部分问题关闭不等于整份文档通过评审，更不等于实现或上线完成。
 
-最终回复给修订文档与处置报告链接、主要改动、未采纳/待决项和实际检查结果。PRD 使用「可交接 / 仍需修订 / 待补证或决策」描述本次核查范围；开发计划使用适用的就绪状态。部分问题关闭不等于整份文档通过评审，更不等于实现或上线完成。
+| 文档 | 判定 | 下一步 |
+| --- | --- | --- |
+| PRD | 可交接 | `dev-plan <PRD 路径> P1`：按 PRD 分期逐期出计划，列出全部期次及各期用户价值；未分期时省略期次 |
+| PRD | 仍需修订 / 待补证或决策 | 列出剩余项及所需决定或证据；补齐后再次 `apply-doc-review <报告路径>`，需要独立复核时 `review-prd <PRD 路径>` |
+| 开发计划 | Ready | `/goal 按 <计划路径> 开发` |
+| 开发计划 | Blocked | `resolve-blocked <计划路径>`：逐项解除剩余阻塞 |
+
+开发计划处置后按真实前置判 `Blocked` 或 `Ready`：评审已处理完毕，原先只等这次评审的 `Proposed` 也要改判。唯一例外是仍在等用户指定的其他非阻塞评审，此时保留 `Proposed` 并写明等待项；用户要求再评一轮时，下一步为 `review-dev-plan <计划路径>` 复审。只给出建议命令，不自行启动下一步。
 
 调用示例：
 
 ```text
-使用 $apply-doc-review，根据 docs/PRD-login.review.md 修订 docs/PRD-login.md，并记录各条意见的处置。
-使用 $apply-doc-review，根据 goal/LOGIN.review.md 修订 goal/LOGIN.md，仅处理 F-01 和 F-03。
+使用 $apply-doc-review docs/PRD-login.review.md
+使用 $apply-doc-review goal/LOGIN.review.md，仅处理 F-01 和 F-03。
+使用 $apply-doc-review，根据 docs/reviews/login.review.md 修订 docs/PRD-login.md。
+使用 $apply-doc-review docs/PRD-login.review.md，仅复核已有修订效果，不改原文。
+使用 $apply-doc-review goal/LOGIN.review.r2.md，继续处理复审确认仍存在的问题。
 ```
+
+## 项目状态回写
+
+若仓库已登记状态台账，或存在仓根 `.xgent-ai/sdlc/protocol.md`（兼容已有 `docs/project-status/protocol.md`；两套并存且未登记切换时先核对，不能双写），交付原产物后读取台账的回写规则（默认目录读上述协议），按其格式新增本次事实记录并刷新受影响的状态页与必要索引；未启用时不自动建表，不依赖另装技能。只读/仅聊天/不保存要求优先，登记失败须说明，不影响如实交付已完成的原产物。
+
+接续原评审对象的处置维度，按评审 ID 与问题 ID 记录修订/复核及修后版本；同步确实改变的文档事实。不伪造新一轮独立评审，也不把部分关闭记成全部通过。

package/skills/apply-doc-review/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "落实文档评审"
-  short_description: "核实 PRD 或开发计划评审意见，修订原文、复核关联内容并记录逐条处置结果"
-  default_prompt: "使用 $apply-doc-review，根据指定的 review-prd 或 review-dev-plan 评审报告修订对应 PRD 或开发计划，核实并落实合理意见，在报告记录处置与复核结果，汇报修改、验证和剩余待决项。"
+  short_description: "核实 PRD 或开发计划评审意见，修订原文、记录处置，判定可交接或 Blocked/Ready"
+  default_prompt: "使用 $apply-doc-review，按指定的 review-prd 或 review-dev-plan 报告核实并修订对应 PRD 或开发计划，在报告记录处置与复核结果；汇报修改与剩余待决项，PRD 给出按期次 dev-plan 的命令，开发计划判定 Blocked 或 Ready 并给出下一步命令。"

package/skills/apply-doc-review/references/disposition-contract.md

@@ -2,12 +2,25 @@
 
 ## 写入位置与历史
 
-- 默认就地修订用户指定原文，在源评审报告追加或更新「修订处置与复核」节。调用本技能已经授权这些写入，不再询问是否保存；明确只核实、仅聊天或另存时以用户要求为准。
-- 原报告的问题、证据、评审基线和原结论保持不变；当前处置与修后判断独立成节，标明日期和修后版本。原文只保留修订后的产品/设计结论及必要决策理由，不混入 F-ID、采纳经过和评审流水。
+- 默认就地修订用户指定或由报告明确引用并核实的原文，在源评审报告追加或更新「修订处置与复核」节。仅提供报告也可执行，不要求重复传原文。调用本技能已经授权这些写入，不再询问是否保存；明确只核实、仅聊天或另存时以用户要求为准。
+- 原报告的问题、证据、原文档引用、评审基线和原结论保持不变；当前处置与修后判断独立成节，标明日期、当前目标链接和修后版本。原文已移动时记录旧引用到当前路径的对应依据；本地目标链接相对处置文档所在目录，另存 applied 文档时重新计算并核验。原文只保留修订后的产品/设计结论及必要决策理由，不混入 F-ID、采纳经过和评审流水。
 - 源报告只读或用户要求保留文件不变时，另存同目录 `<报告文件名去扩展名>.applied.md`，在处置文档中链接源报告和修订目标；远程来源没有本地目录时遵循仓库惯例，无惯例则用 `docs/reviews/<主题>.applied.md`。重名且未获更新授权时加日期及序号，不覆盖无关文件。
 - 多份报告对应同一原文时合并修订，但每份报告均能追踪其问题处置；同一 F-ID 不能跨报告混用。多份原文的版本与结论分别记录。
 - 重复运行先读已有处置，以报告原始版本/问题 ID 匹配更新，不重复应用修改。新报告改变主张时标明新来源；本技能追加的处置内容改变报告 hash 不应把旧 finding 变成新问题。
 
+## 重复执行与修复效果复核
+
+读取输入报告引用的上轮报告及既有处置，以“来源报告/原始版本 + 问题 ID”建立对应关系；报告追加处置不改变原问题身份。复审报告中的旧问题通过明确映射接续，新问题保留新来源。报告链接相对记录所在目录，所审、修后与本轮核查版本分别保留。
+
+复核结果统一为 **已解决、仍存在、部分解决、回归、待核实、不再适用、本轮未复核**，与下文的处置状态分开：复核结果回答当前效果，处置状态记录做过什么及还缺什么。回归需先前关闭和当前失败证据；不再适用须有契约/范围依据，不表示已修复；证据不足不写已解决。
+
+沿用已有处置表，在同一条目保留上次处置/版本、本轮结果与当前证据；可加列，不另建重复整改台账。至少能读到：
+
+| 来源报告 / 问题 ID | 上次处置 / 版本 | 本轮复核结果 | 当前处置 / 修改 | 证据与适用范围 | 剩余动作 |
+| --- | --- | --- | --- | --- | --- |
+
+“仅复核/只核实”保留目标产物，只保存必要的复核记录；不会新增修复数或推进计划完成数。若用户要求完全只读/仅聊天，则不保存任何记录。原有关闭被推翻时保留历史及重新打开的依据；用户限定范围外标本轮未复核。无实质变化时不改内容或时间，不重复写台账事件；仅补缺证时接续原条目。
+
 ## 逐条状态
 
 | 状态 | 使用条件 |
@@ -52,6 +65,6 @@
 ## 就绪与完成边界
 
 - PRD 关键范围、产品语义或验收未定时不能称可交接；文案修完不代表这些问题消失。无需新架构才能确定产品目标时，不强求 PRD 已有技术设计。
-- 开发计划的重大范围、安全、数据、外部契约或关键 NFR 未决时是 `Blocked`；仅等非阻塞评审才用 `Proposed`；关键前置均明确才可 `Ready`。这些不是实施进度或测试状态。
+- 开发计划的重大范围、安全、数据、外部契约或关键 NFR 未决时是 `Blocked`；关键前置均明确才可 `Ready`。处置完成即评审已处理，结论给 `Blocked` 或 `Ready`；唯一例外是仍在等用户指定的其他非阻塞评审，此时保留 `Proposed`。这些不是实施进度或测试状态。
 - 处置记录中的「复核通过」只覆盖此次检查的断言，不改写源报告的历史总体结论，也不假称完整独立评审通过。
 - 原文写入、报告回写、必要复核分别核验。任一步未完成都要明确，聊天摘要不能替代应落盘的产物；交付前回读实际文件，链接必须指向存在的文档。