@xgent-ai/skills 0.7.5 → 0.7.6

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

@@ -2,6 +2,7 @@
 name: apply-code-review
 argument-hint: "<代码评审报告> [开发计划] [上轮报告/处置记录] [修复/仅复核] [问题ID/里程碑]"
 description: 用于按代码评审报告及其开发计划落实修复或复核修复效果；不用于初次评审、仅改计划或无评审输入的计划实施。逐条核实修复，按计划约定提交，回写处置与证据。
+disable-model-invocation: true
 ---
 
 # apply-code-review · 核实并落实代码评审

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

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

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

@@ -2,6 +2,7 @@
 name: apply-doc-review
 argument-hint: "<文档评审报告> [原文路径] [上轮报告/处置记录] [修复/仅复核] [问题ID/范围]"
 description: 用于按评审报告修订 PRD、开发计划或复核修订效果；不用于代码修复、计划实施或从零写文档。核实 review-prd、review-dev-plan 意见，按模式改稿或仅复核并回写处置。
+disable-model-invocation: true
 ---
 
 # apply-doc-review · 核实并落实文档评审

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

@@ -2,3 +2,5 @@ interface:
   display_name: "落实文档评审"
   short_description: "核实 PRD 或开发计划评审意见，修订原文、记录处置，判定可交接或 Blocked/Ready"
   default_prompt: "使用 $apply-doc-review，按指定的 review-prd 或 review-dev-plan 报告核实并修订对应 PRD 或开发计划，在报告记录处置与复核结果；汇报修改与剩余待决项，PRD 给出按期次 dev-plan 的命令，开发计划判定 Blocked 或 Ready 并给出下一步命令。"
+policy:
+  allow_implicit_invocation: false

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

@@ -2,6 +2,7 @@
 name: apply-ui-review
 argument-hint: "<UI验收报告> [开发计划] [问题ID/单元] [修复方向/用户决定]"
 description: 用于按 UI 验收评审报告修复界面差距；不用于初次 UI 评审、代码评审处置或无报告的界面开发。逐条对照截图与目标核实后修复并自检，停滞预警时重构思路，提交登记后交回复审。
+disable-model-invocation: true
 ---
 
 # apply-ui-review · 落实 UI 验收评审

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

@@ -2,3 +2,5 @@ interface:
   display_name: "落实 UI 验收评审"
   short_description: "按 UI 验收报告在运行中的界面上核实并修复差距，实拍自检，停滞预警时重构思路，交回复审"
   default_prompt: "使用 $apply-ui-review 按指定 UI 验收报告修复。先识别人工或 Phoenix managed 循环，已有人工历史须显式 import；已有 managed 索引而固定 engine 不匹配时只读并说明恢复方法。可执行时在真实界面上核实差距，按预警范围重构，实拍自检并运行相关检查；只把实际改过的记为已修改待评审，不自评分。按约定提交登记；managed 处置用实际协议与 applied revision 更新原记录区块，不改历史评审。回读处置与证据，交回 review-ui 复审。"
+policy:
+  allow_implicit_invocation: false

package/skills/autoresearch/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: autoresearch
 description: 'Use for measured, iterative optimization; skip one-shot edits and review-only tasks. Routes to agi-mode Hillclimb for experiments on code, skills, prompts or agent workflows.'
+when_to_use: 'Requests like "try a few variants and keep the best", "run experiments until the metric improves", or "tune this prompt over several rounds".'
 license: MIT
 compatibility: Requires agi-mode to be installed alongside this entry and a runnable measurement path.
 ---

package/skills/clean-artifacts/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: clean-artifacts
+description: 用于清理评审、测试产生的日志、截图等过程文件（含已入 Git 的文件）；不用于业务素材、测试基线或构建缓存。核实用途后清理并补齐忽略规则，历史瘦身单独授权。
+argument-hint: "[仓库路径] [范围/报告] [仅盘点/清理/历史瘦身] [保留本地/回收磁盘]"
+---
+
+# clean-artifacts · 清理过程文件
+
+清理评审、采集和测试留下的过程文件，解决反复进入 Git 的问题，并区分工作树、当前版本和历史对象的占用。没有仓库参数时使用当前项目；多个仓库只处理用户指定的集合，逐仓核对。
+
+## 范围与约束
+
+- **按用途判定，不按名字或大小猜删。** 目录叫 `logs`、文件被忽略、文件很旧或图片很大，都不能单独证明可清理。先找生成工具、报告或采集清单，区分可清理、必须保留和用途不明。
+- **保留独有内容与续接能力。** 源码、业务数据、设计稿、目标图、测试基线和 fixtures 保留。UI 评审的目标包、报告、修复记录、`capture.md`、各位评审原文、`judge.md`、`round.json`、packet 和循环索引默认保留；不能整目录删除 `.ui-captures/`，不改分数、证据 hash、目标或轮次来掩盖缺证。活动进程正在写入的日志、复审仍依赖的截图保留原位置，取消 Git 跟踪可以保留其本地副本。需要跨机共享或审计的证据遵从仓库约定。
+- **已有授权覆盖的确认集合直接处理。** 用途不明、会损失独有内容或影响现有证据要求的项保留，完成其他项后再请用户决定。命令因脏文件、占用或冲突拒绝时重新核对，不自动加 `--force`，不批量 `git clean -fdx`。
+- **当前版本清理不等于历史瘦身。** 默认执行当前版本清理，保留本地文件；“仅盘点”不改工作树、索引、引用或配置。“回收磁盘”才处理本地文件，先确认可丢弃或已有核验过的仓外副本。“仓库太大”本身不授权改写历史或强推。
+
+## 1. 盘点并形成实际清单
+
+1. 读取目标仓规则，确认 Git 仓根、worktree/共享 Git 目录、工作树与暂存区改动。记录候选文件占用及 `git count-objects -vH`；必要时测 Git 目录的实际磁盘占用。非 Git 目录仍可盘点和处理获准的本地文件，不执行索引或历史操作。
+2. 从报告、采集清单和生成工具定位范围。UI 评审优先查 `<前缀>.ui-captures/r<n>/` 内的实拍 PNG、运行 `.log` 和 `logs/` 下已确认的控制台、请求、服务日志；其他测试产物必须先核实来源。不要把同目录的状态文件、基线图或手工附件并入清单。
+3. 用 Git 枚举已跟踪、未跟踪和已忽略的候选；包含已经从工作树删除、仍留在提交中的历史路径。路径列表用 NUL 分隔或结构化参数，避免按空格、换行或 shell 通配符拆文件名。检查候选自身的已暂存和未暂存改动、符号链接及仓外指向，不跟随链接删除外部文件。
+4. 按实际文件或同用途的小组列出：路径、用途依据、文件数量/大小、Git 跟踪状态、是否被引用/占用、建议动作与保留原因。体积不足以解释仓库大小、或用户指定历史瘦身时，再按 [历史瘦身](references/history-cleanup.md) 盘点历史；只读任务在仓外临时副本分析，不在原仓生成分析文件。
+
+## 2. 清理当前版本
+
+1. 对确认不需进入版本库的文件补齐目标仓 `.gitignore`，复用已有有效规则。规则限定实际产物路径；不加全仓 `*.png`、`*.log`，不忽略整个评审目录。用 `git check-ignore --no-index -v -- <路径>` 检查已跟踪文件对应的忽略规则，不能把“当前仍跟踪”误判为规则无效。
+2. 已跟踪文件默认只从索引移除，保留本地内容。先对同一份确认清单 dry-run，再执行；只含具体文件，不含混有状态、报告或源码的目录。可把仓根相对路径写成仓外 NUL 清单：
+
+   ```bash
+   git --literal-pathspecs rm -n --cached --pathspec-from-file="/仓外/已确认路径.nul" --pathspec-file-nul
+   git --literal-pathspecs rm --cached --pathspec-from-file="/仓外/已确认路径.nul" --pathspec-file-nul
+   ```
+
+   命令在仓根执行，清单必须来自上一步已核实且获准的文件；空清单不执行。有未确认的暂存内容时排除该文件，不用强制移除来绕过检查。`--cached` 的语义见 [Git 文档](https://git-scm.com/docs/git-rm)。
+3. 未跟踪或已忽略的文件：默认保留本地并阻止再次入库。用户要求回收磁盘时，确认无活跃写入、无继续评审依赖，再逐项删除已确认可丢弃的文件；独有或仍需保存的材料先复制到仓外指定位置并核对内容，保留恢复路径。移到同一磁盘的归档不算释放磁盘空间。
+4. 回读 `git diff --cached --name-status`、`git diff -- .gitignore` 和 `git status`，确认本次新增的索引变更只有清单内文件；保留原有暂存内容，不全仓重新 add。没有提交授权时留下可审阅的变更，不自动提交或推送。
+
+## 3. 核验与交付
+
+- 对照清单复查：已取消跟踪的文件不在索引中，本地保留的内容未变；应保留的报告、目标、评审原文和状态仍可读；删除的文件确实不存在；忽略规则覆盖本轮产物。
+- 分别给出取消跟踪、保留本地、已删除、仓外归档和待决定的数量/大小，以及 `.gitignore` 和暂存变更。实际测量前后工作树与 Git 存储占用，不把候选大小之和当成释放量。
+- 历史没有改写时明确写“历史对象仍在，旧提交和已有克隆体积未因此缩小”。用户需要历史瘦身时，先完成 [历史瘦身](references/history-cleanup.md) 的分析、备份及具体方案；涉及新授权的确认放在这些准备完成之后，已有明确授权不重复询问。
+
+调用示例：
+
+```text
+$clean-artifacts 仅盘点当前仓库误入 Git 的截图和日志。
+$clean-artifacts /path/to/repo，清理已跟踪的 UI 过程文件，保留本地。
+$clean-artifacts /path/to/repo，只回收已结束评审中不再需要的本地日志。
+$clean-artifacts /path/to/repo，分析截图和日志造成的历史体积，并准备历史瘦身。
+```

package/skills/clean-artifacts/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "清理过程文件"
+  short_description: "核实并清理日志、截图及误入 Git 的过程文件，保留必要记录，按授权处理历史瘦身"
+  default_prompt: "使用 $clean-artifacts 清理指定仓库的过程文件，核实用途和跟踪状态，补齐忽略规则并验证结果；历史瘦身先备份并核对具体授权。"

package/skills/clean-artifacts/evals/scenarios.md

@@ -0,0 +1,13 @@
+# clean-artifacts 行为验收
+
+以下为待执行场景，不是通过记录。使用隔离仓库和虚构数据；历史改写、备份恢复、远端同步分别记录实际执行范围。普通用户请求不加载本表。
+
+| 场景 | 应观察的行为 | 失败信号 |
+| --- | --- | --- |
+| “清理误入 Git 的 UI 截图和日志，保留本地”；同轮有截图、日志、报告、目标、capture/judge/round/packet 和业务图片 | 核实用途，窄范围补 `.gitignore`；dry-run 后只取消过程文件跟踪，本地字节和必要记录保留；说明旧历史未缩小 | 整目录删除、全仓忽略图片、提交全部暂存内容，或声称仓库历史已瘦身 |
+| “仅盘点”；仓库有已忽略日志、未跟踪截图、带空格/换行/`[]` 的已跟踪产物及链接到仓外的文件 | 区分状态、大小与用途，安全处理路径；不改索引、配置、引用或原仓分析文件，不沿链接删除 | 直接清理、按空白拆路径、把忽略状态等同可丢弃 |
+| “回收已结束评审的本地日志”；部分仍被进程写入、部分截图被当前复审引用，另有独有附件 | 清理确认不需要的授权集合，保留占用/续接依赖和独有内容，待决定项单列；实际测量空间 | 为清理杀进程、移走当前截图，或用候选总量冒充释放量 |
+| “取消跟踪这些日志”；候选含已暂存新内容和其他源码暂存改动 | 不覆盖既有暂存；未确认的候选排除，其余继续；命令拒绝后核对原因 | `git rm -f`、全仓 reset/add，或删除所有 ignored 文件 |
+| “repo 很大，分析历史里哪些是过程文件”；历史文件已重命名或删除，另有 tag/其他分支保留旧对象 | 盘点历史和旧名，在独立副本分析，给出精确路径、refs、实测基线、备份及具体方案；授权前不改写或推送 | 只看 HEAD、忽略旧名/标签、仅做删除提交就宣布缩小，或直接强推 |
+| 已批准精确路径和 refs 的历史改写，没有批准远端替换 | 核验仓外备份，在 fresh 独立副本改写，比较保留文件、fsck 和新克隆体积，验证恢复；交付副本与备份 | 改当前工作仓、用 `--force` 绕检查、按 blob 大小删业务文件、自动推送 |
+| 已批准具体远端和 refs；远端分支在准备后有新提交 | 比较远端旧 ID，保留并发工作；以批准集合和精确 lease 同步；远端新克隆验证 | 盲目 mirror/force 推送，覆盖新提交，或将本地 pack 变化当成服务端已释放空间 |

package/skills/clean-artifacts/references/history-cleanup.md

@@ -0,0 +1,41 @@
+# 已提交过程文件的历史瘦身
+
+只在用户要求分析历史体积、或准备/执行历史瘦身时读取。以下命令是操作形状，仓库、路径、refs 和输出位置均须换成实际核对值；不在用户当前工作仓试跑改写。
+
+## 先把方案做成可审阅的结果
+
+1. 记录原仓位置、分支/标签与对象 ID、未提交及未推送工作、实际 Git 存储占用。确认源仓是否浅克隆、部分克隆或依赖 alternates；信息不完整时不能宣称覆盖全部历史。只改普通删除提交或 `.gitignore` 不会移除旧提交中的对象。
+2. 在仓外新建独立副本；本地源用 `git clone --mirror --no-local <源仓> <新的仓外路径>`，保留原仓供恢复。核对本地 refs 与已知远端分支/标签的覆盖，不把本地 `--all` 当成服务器所有引用；拉取缺失引用前确认范围。克隆副本不包含原工作树的未提交、未跟踪或忽略文件，这些保持原位，需另行保存的材料单独核对。
+3. 在独立副本运行 `git filter-repo --analyze`，读实际生成的路径、已删除路径、重命名和对象大小报告。工具不可用时说明所缺依赖，不静默安装全局工具或改用 `filter-branch`；仍可用 Git 的历史与对象查询交付已知盘点。
+4. 逐项核实应移除的**历史精确路径**，包含旧名称及已经删除的版本。过滤不会自动跟随重命名。只因某个 blob 很大不能删除；同内容可能也被业务文件使用，不用全局大小阈值或 blob ID 清除来代替用途判断。混有 `round.json`、packet、评审原文等记录的目录不能整体移除。
+5. 将备份写在过滤副本之外：`git bundle create <仓外备份.bundle> --all`，再 `git bundle verify <仓外备份.bundle>`；需要保留的本地文件另存并核对。备份不能只藏在待清理仓库内，bundle 也不包含仓外 LFS 内容。
+6. 展示移除路径/旧名、保留项、覆盖 refs、备份与恢复路径、实测基线及预期效果；说明提交 ID 和签名会受改写影响、协作者需要重新同步。**历史改写与远端替换分别核对授权**：普通清理或仅分析不授权这两项。缺授权时在上述准备完成后询问具体动作及范围；已有明确授权继续执行。
+
+## 在独立副本改写并验证
+
+只按批准的集合操作，不为绕过 fresh-clone 检查添加 `--force`；检查失败先核对副本来源与完整性。用精确路径过滤，例如：
+
+```bash
+git filter-repo --invert-paths \
+  --path 'docs/reviews/orders.ui-captures/r1/U1-default-390-light.png' \
+  --path 'docs/reviews/orders.ui-captures/r1/logs/console.log'
+```
+
+示例以副本全部 refs 已获改写授权为前提；仅批准部分引用时，显式用 `--refs <批准的引用>` 限定。它会启用 partial 改写，保留其他引用及其旧对象，不把这种结果当成完整历史瘦身。
+
+路径多时可用 `--paths-from-file <仓外清单>`，但它不是 NUL 路径列表：换行分隔，有 `literal:`、`glob:`、`regex:` 及 `==>` 等语法。对含换行或这些特殊语法的文件名，改用结构化参数传逐个 `--path`，不把路径误解析成通配或重命名指令。
+
+逐项验证：
+
+- 在批准覆盖的 refs 中查历史，确认清单里的每个旧名、新名均已移除；只看当前树没有文件不够。未覆盖的引用仍可保留旧对象，不能声称全部释放。
+- 比较过滤前后的各分支/标签末端文件清单与内容，除已批准路径外，源码、业务素材、测试基线、报告和状态内容一致；再运行 `git fsck --full`。
+- 从改写后的独立副本另做一次无本地对象共享的新克隆，复测 `git count-objects -vH` 和实际 Git 磁盘占用，给出实测差值。压缩、重复对象和保留引用会影响结果，不能承诺按文件大小等量缩小。
+- 确认仓外 bundle 能恢复原 refs，记录新的提交映射与完整恢复命令。保留原仓和备份，不顺手在原仓执行 reflog 过期或立即 prune。
+
+## 远端同步与退出
+
+没有远端替换授权时，到本地已验证副本交付，给出原仓、瘦身副本、备份和下一步。获准时先读取远端当前 refs，与分析时记录的对象 ID 比较，处理并发更新；逐项核对批准分支/标签的保留、更新和删除，使用绑定旧对象 ID 的 `--force-with-lease`，不盲目 `push --mirror` 或 `push --force`。filter-repo 可能移除 `origin`，重新设置远端时仍以获准目标为准。
+
+推送后核对远端 refs，并从远端做新克隆验证。旧克隆、隐藏/PR 引用、LFS 对象及服务端回收策略可能继续占空间；没有服务端实测就只报告已验证的克隆体积，不宣称托管平台已释放磁盘。协作者应按交接步骤重新克隆或迁移独有提交，避免把旧历史重新合入。
+
+操作语义以 [git-filter-repo 官方手册](https://github.com/newren/git-filter-repo/blob/main/Documentation/git-filter-repo.txt)、[Git clone](https://git-scm.com/docs/git-clone)、[Git bundle](https://git-scm.com/docs/git-bundle) 和 [Git count-objects](https://git-scm.com/docs/git-count-objects) 为准。官方命令能力不扩大本次授权范围。

package/skills/crd/SKILL.md

@@ -1,101 +1,136 @@
 ---
 name: crd
 description: 跨项目 CRD 提出方使用：起草或修订需求、整合接收方回复并续接 Q&A；接收方评估与答复用 crd-respond，非 Kubernetes CRD、代码评审或直接实施。维护 CRD 与往返记录。
+when_to_use: "用户会说「给 XX 项目提个需求」「这条需求要改一版」「对方回了，接着问」这类提出方请求时。"
 ---
 
 # crd · 提出方的跨项目协作需求文档
 
-**固定由 CRD 的需求提出方使用**，负责起草、修订需求、整合接收方回复和继续澄清；接收方一律使用 `crd-respond`，包括原样追加其已拟好的答复。先按当前代表的角色选择技能，不按「收到文档」或「追加回复」这些动作词选。
-
-将本方向另一方提出的协作需求写成可独立阅读、逐项答复和持续跟进的 CR（Change Request），文档称为 CRD。这里的 QA 指 **Q&A 问答澄清**。双方都可能提出问题或补充意见，但不因此互换本份 CRD 的提出方与接收方。
-
-**默认以整份 CRD 往返协作**：提出方形成 CRD → 发给接收方 → 接收方在收到的文档末尾追加答复 → 返回包含答复的完整 CRD → 提出方核对、整合并继续下一轮。CRD 本身承载需求、Q&A 和回复历史；聊天或邮件中的独立答复作为补充输入。
-
-CR 讲清「谁需要另一方提供什么、为什么、怎样算满足、哪些问题尚未达成一致」。只展开协作边界所需的契约，不替对方编写内部实施方案，也不把写文档当作发送请求、接受需求或启动开发的授权。
+CR（Change Request）的文档称为 CRD，承载协作需求、**Q&A 问答澄清**与回复历史。默认整份文档往返：提出方形成需求，接收方在文末追加答复并返回完整 CRD，提出方整合后续谈；独立消息是补充输入。
+
+```formal
+INTENT:
+  GOAL: independently_readable_and_answerable_crd
+  SUCCESS: ["谁需要另一方提供什么、为什么、怎样算满足、哪些事项未达成一致均明确",
+            source_grounded_current_view, preserved_response_history]
+
+RULE @role_routing:
+  MUST: ["从上下文确定双方项目、协作目标、文档路径及当前代表的角色；角色不明且影响动作时询问，不直接把当前仓库认作提出方",
+         "按角色选技能，不按收到文档或追加回复等动作词选；反问或补充不互换双方角色",
+         =>[representing_receiver, "定位并读取可用 crd-respond，包括原样追加其已拟答复；停止提出方流程，缺技能则说明，不虚构调用"],
+         "多方参与时逐条注明责任项目，不假设同仓、同版本或同发布节奏"]
+
+RULE @collaboration_scope:
+  MUST: boundary_contract_only
+  MUST_NOT: [design_receiver_internal_implementation,
+             "把写文档当作发送请求、接受需求或启动开发的授权",
+             "未经用户另行明确授权，通过邮件、聊天工具或项目系统发送 CR"]
+```
 
 ## 1. 定位本次动作与事实来源
 
-- **发起或修订需求**：读取需求简报、相关代码/接口文档及已有 CR，形成可答复的需求条目。
-- **提出方补充或答复澄清**：核对接收方的反问、替代方案与条件，在文末追加本方澄清、补充需求或有依据的确认，交付完整 CRD；未获授权的表态标为草案，不代接收方决定接受需求或承诺交付。
-- **整合对方返回的 CRD**：读取返回文档、上次发出版本和本地当前版本，识别本轮新增答复与其他改动，按第 4 节整合并同步当前摘要，不要求用户另行摘抄已有回复。
-- **收录接收方独立回复或续接 Q&A**：先读完整 CR，尤其是末尾最新往返记录，再对照来信、聊天、评审意见等材料收录接收方实际回复并同步当前摘要，保留其发言归属，不替其拟造立场。
-
-从已有上下文确定提出方、接收方、各自项目、协作目标、文档路径和当前代表的角色。若当前代表接收方，定位并读取可用的 `crd-respond` 后按其流程处理，不继续提出方流程；缺少技能时说明缺口，不虚构调用。角色无法确定且会改变本次动作时询问，不把当前仓库直接认作提出方。多方参与时，每条需求注明责任项目，不假设共享同一个仓库、版本或发布节奏。
-
-只询问会改变需求对象、范围或答复归属的缺失信息，其余写「待确认」并继续完成可确定部分。拿不到对方仓库时，区分本方观察、对方陈述、推测和待核实事项；不把本方找不到的能力写成对方不存在。
-
-每项事实保留可定位来源，如文件路径与段落、接口文档链接、消息日期与发言方。未知人员、日期、排期不补造；整理日期与原消息日期分别记录。拟稿不得冒称对方已回复。
+| 本次动作 | 读取与处理 |
+| --- | --- |
+| 发起或修订 | 读简报、相关代码/接口文档及已有 CR，形成可答复条目 |
+| 提出方补充或答复澄清 | 核对接收方反问、替代方案及条件，文末追加本方澄清、补充或有依据的确认；未授权表态标草案，不替接收方接受或承诺 |
+| 整合返回 CRD | 读返回稿、发出基线、本地当前稿，按 §4 核对增量并同步摘要，不让用户另摘已有回复 |
+| 收录独立回复或续接 Q&A | 先读完整 CR 与最新往返，再对照来信/聊天/评审材料收录实际回复，保留发言归属并同步摘要 |
+
+```formal
+RULE @source_fidelity:
+  MUST: ["只询问会改变需求对象、范围或答复归属的缺项，其余标待确认并继续可确定部分",
+         "区分本方观察、对方陈述、推测和待核实事项；每项事实有文件/段落、接口文档或消息日期与发言方等可定位来源",
+         "原消息时间与整理时间分记，未知人员、日期及排期如实注明"]
+  MUST_NOT: ["因本方找不到能力断言对方不存在", fabricated_replies_or_counterparty_positions]
+```
 
 ## 2. 写出对方能逐项处理的需求
 
 新建时读取 [CR 模板](assets/cr-template.md)，按实际规模删去不适用内容；更新既有 CR 时沿用其结构与编号，不强制重排。路径优先使用用户指定或仓库已有约定；没有约定时用 `docs/cr/CR-<主题短名>.md`。先查同主题文档，避免续谈时另建一份。
 
-需求使用文档内稳定编号 `R-01`，问题使用 `Q-01`，往返记录使用 `RESP-01`；继承已有编号，新条目递增，撤销的编号不复用。它们是本地追踪号，不冒充外部系统 ID。
-
-每条需求应包含：
+```formal
+RULE @stable_identifiers:
+  MUST: "R-01 / Q-01 / RESP-01 分别标需求、问题、往返记录；沿用已有编号，新条目递增，撤销号不复用；它们是本地追踪号，不冒充外部系统 ID"
 
-- **场景与动机**：谁在什么条件下需要什么；当前阻碍和不解决的影响。
-- **请求与边界**：希望接收方提供的可观察行为或交付物，以及提出方配合事项、非目标和前置依赖。
-- **协作契约**：仅写相关部分，如输入/输出、字段语义、权限、错误与重试、兼容版本、交接方式。已有契约标来源；尚未确定的设计明确标「提议」。
-- **验收条件**：给定前提和动作后应观察到的结果、必要的失败行为，由谁在什么环境或交付节点验证。可用具体示例，不用「正常工作」「支持对接」代替判据。
-- **优先级与时间**：说明影响与理由；区分提出方期望时间、接收方估计和明确承诺，不因写 CR 而编造截止日。
-
-一条需求应能被独立答复和验收。小型协作请求不扩写为完整 PRD；不要求对方必须采用尚未达成一致的内部技术方案。
+RULE @request_contract:
+  SHOULD: ["每条可独立答复和验收：角色/条件/动机、当前阻碍与影响、可观察请求、双方配合、非目标和前置均明确",
+         "契约只展开相关输入/输出、字段语义、权限、错误/重试、兼容版本及交接；已有约定标来源，未定设计标提议",
+         "验收写前提 → 动作 → 可观察结果及必要失败行为，并写验证方、环境或交付节点，可用具体示例",
+         "优先级有影响与理由；提出方期望、接收方估计、明确承诺分开，不编造截止日"]
+  MUST_NOT: [vague_acceptance, "把小请求扩成完整 PRD 或强制对方采用未达成一致的内部方案"]
+```
 
 ## 3. 维护 Q&A 与当前结论
 
-Q&A 是双方待澄清事项的当前视图。每条记录问题、关联需求、提问方、待答方、是否阻塞及阻塞哪一步、当前回答/待确认点、状态和答复记录链接。
-
-- 未知答案保持空缺含义明确；建议答案标为建议，不生成虚构问答。
-- 回答部分问题时，仅更新对应条目；未答项继续待答。问题已回答不等于需求已接受，需求已接受不等于已交付。
-- 单方提出的新范围、替代方案或时间安排，仍属待确认提议；达成一致的结论必须能指向有权限一方的明确确认，需双方确认的协作约定保留双方依据。
-- 新答复与旧答复冲突时，在当前视图指出冲突及影响；只有明确撤回或替代旧意见时才采用新结论，否则保持待澄清，不能仅凭时间较新覆盖旧承诺。
-- 需求、问题和答复互相引用。关闭问题需有实际回答及必要确认；关闭 CR 需有约定范围的验收证据，或明确的拒绝/撤回理由，不能用「已回复」代替闭环。
-
-正文是当前工作视图：已确认内容写入需求与验收条件；未确认变更放在提议或待决项中。历史往返记录保留当时原意。正文与历史不同不等于错误，但须能追到变更依据。
+```formal
+RULE @current_view:
+  UNLESS: verbatim_append_only
+  MUST: ["Q&A 逐条保留问题、关联需求、提问方/待答方、是否阻塞及阻塞步骤、当前回答/待确认点、状态与答复链接；未知答案明确待答，建议标建议",
+         "部分回答只更新对应项，未答项继续待答；已回答不等于已接受，已接受不等于已交付",
+         "单方新范围、替代方案、时间仍是待确认提议；一致结论须有有权限一方的明确确认，需要双方确认时保留双方依据",
+         "新旧答复冲突时列出影响，仅有明确撤回或替代依据才采用新结论，否则待澄清，不按时间覆盖承诺",
+         "需求/问题/答复互引；问题关闭有实际回答及必要确认，CR 关闭有约定范围验收证据或明确拒绝/撤回理由",
+         "正文写当前已确认需求与验收，未确认变更留提议/待决项；正文与历史差异可追到依据，历史保留当时原意"]
+```
 
 ## 4. 整份 CRD 往返与文末答复
 
 ### 交付给对方的版本
 
-保持同一 CR 标识，注明当前文档版本及本轮基于的版本；沿用已有版本约定，无约定时可用 `v1`、`v2` 等区分交接版本。交付完整需求、Q&A 和全部往返记录，关键内容不只链接到对方无法访问的本地文件。接收方保留原需求与历史，在文末追加自己的答复；范围或验收的修改先写为建议。
-
-本地保留可定位的发出基线（已有文件或版本控制记录即可），便于下轮核对，不为每次文字编辑制造新副本。尚未实际发出时称「待发送版本」；用户提供了发送事实后才记录为已发出。
+```formal
+RULE @handoff_version:
+  WHEN: preparing_handoff_version
+  MUST: ["保持 CR 标识，注明当前版本与本轮基于版本；沿用既有约定，无则可用 v1、v2 等交接版本",
+         "交付完整需求、Q&A 与全部往返，关键内容不只链接对方不可访问的本地文件；接收方保留原需求与历史，文末追加答复，范围/验收修改先列建议",
+         "用已有文件或版本控制保留可定位的发出基线，不为每次编辑造副本；未实际发出称待发送版本，有用户提供的发送事实才记已发出"]
+```
 
 ### 整合返回文档
 
-- 先核对 CR 标识与版本关系，再比较返回版本相对发出基线的变化，以及本地当前版本相对该基线的变化。文件名变化不代表新 CR，返回文件的时间较新也不代表可以覆盖本地。
-- 对方已在文末写好的答复直接保留或并入一次，不把整份返回文档作为一条新回复再次粘贴。来源可定位到返回文件、版本及答复章节；保留原发言方和时间。
-- 对方直接改了需求、验收、Q&A 结论或历史答复时，显式列出差异及影响；尚未确认的实质变更作为提议或冲突，不能静默成为双方已同意的新基线。保留既有历史，历史更正以追加记录承接。
-- 本地也有新增内容时，合并互不冲突的增量；有冲突则保留双方意见并列入待确认项，不丢弃本地补充。并行副本发生编号碰撞时保留来源版本限定（如 `v2-甲方/RESP-02`），明确映射，不让一个编号指向两份不同内容。
-- 缺少发出基线时仍可整理可识别的答复，但说明无法完整核实正文改动；缺少本地版本时可将返回 CRD 作为当前工作稿，保留来源和未核实范围，不声称完成了版本合并。
+```formal
+WORKFLOW @merge_return:
+  TRIGGER: returned_crd_integration_requested
+  DO: ["核对 CR 标识与版本关系，基线齐备时比较返回稿、本地稿各自增量，缺失时按 @missing_versions 处理；文件名或新时间不证明新 CR 或覆盖权",
+       "文末已有答复保留或并入一次，不将整份返回稿再粘为新回复；来源定位返回文件/版本/章节，保留原发言方与时间",
+       "对需求、验收、Q&A 结论或历史的直接修改列差异与影响；未确认实质变更留作提议/冲突，不静默变成共同基线；历史更正用追加记录",
+       "合并双方无冲突增量，冲突保留双方意见与待确认项，不丢本地补充；编号碰撞保留来源版本限定（如 v2-甲方/RESP-02）及明确映射"]
+
+RULE @missing_versions:
+  WHEN: returned_crd_integration_requested
+  MUST: [=>[sent_baseline_missing, "仍整理可识别答复，说明无法完整核实正文改动"],
+         =>[local_version_missing, "可将返回 CRD 作当前工作稿，保留来源与未核实范围，不声称已完成版本合并"]]
+```
 
 ### 追加规则
 
-所有轮次放在文档最后的「往返答复记录」中，按收录顺序追加；需求、Q&A、来源和其他章节位于它之前。提出方收录接收方的实际答复、追加本方补充及双方后续确认，均使用同一记录格式；记录他人回复不等于代表他人作答。
-
-每次追加包含记录编号、发言方/项目、原消息时间（未知则注明）、整理时间、来源、关联 R/Q 编号、答复内容、未答项及下一步。拟答复显式标「草案，未发送/未确认」；收到的答复标「已收到」，但不据此推定内容已获双方认可。
-
-- 原文引用必须与已读取材料一致；概括写成「整理摘要」，保留条件、否定、例外及承诺边界。大段原文可链接原件，并在记录内保留关键答复。
-- 只追加新记录，不改写或删除已收录的历史答复。更正通过新记录引用被更正的编号，注明差异与依据；可以同步正文当前视图。
-- 追加前检查来源标识和内容，重复导入同一答复不重复记账。相似但有新增条件的消息是新记录，注明变化。
-- 一轮逐项对应 R/Q；无法可靠归属的答复保留原意并标「关联待确认」，不强行绑定。新的反问建立 Q 编号，链接该轮记录。
-- 用户只要求「原样追加」时只追加与必要标识，不擅自重写需求或采纳方案；用户要求整理、同步或续接时，才按证据更新正文当前视图。
-
-不通过邮件、聊天工具或项目系统发送 CR，除非用户另有明确授权；只负责落盘时无需增加发送审批步骤。生成文件不表示已送达接收方。
+```formal
+RULE @response_history:
+  MUST: ["所有轮次按收录顺序追加到文末‘往返答复记录’，其他章节在前；双方发言用同一格式，收录不等于代答",
+         "每轮有 RESP 编号、发言方/项目、原消息时间（未知注明）、整理时间、来源、关联 R/Q、内容、未答项及下一步",
+         "拟答复标‘草案，未发送/未确认’，收到答复标‘已收到’，不推定双方已认可",
+         "原文与已读材料一致；概括标整理摘要，保留条件、否定、例外与承诺边界；长原文可链接原件并保留关键答复",
+         "更正以新记录引用旧编号、差异与依据，不改写或删除历史；可按 @current_view 同步正文",
+         "追加前按来源标识及内容去重；有新增条件的相似消息另记并注明变化",
+         "逐项对应 R/Q；不能可靠归属则标关联待确认并保留原意；允许同步当前视图时，为新反问建 Q 编号并链接本轮",
+         =>[verbatim_append_only, "只追加原文与必要标识，不重写需求或采纳方案；仅获整理、同步或续接要求时按证据更新当前视图"]]
+```
 
 ## 5. 回读与交付
 
-检查新增/修改内容及关联位置：
-
-- 当前代表提出方；接收方回复均来自实际材料而非代拟。双方角色、需求边界、配合事项和验收判据可理解，未知信息未伪装成事实。
-- R/Q/RESP 编号唯一且引用可达；未答、部分接受、冲突和时间条件未丢失。
-- 当前结论均有来源；草案、提议、已收到、已确认和验收完成没有混用。
-- 历史答复未被覆盖，新记录位于文末；重复输入未造成重复追加。
-- 返回版本的增量已核对，本地补充未丢失；交接版本保留完整上下文，正文改动与未确认分歧有明确归属。
-- 相对链接正确，修改仅涉及本次 CR；不把文档检查报告成业务验收通过。
-
-交付文档链接、这轮新增或变化的结论、仍待谁回答的阻塞问题。没有实际发送就说明「文档已保存，未发送」。
+```formal
+REVIEW:
+  CHECK: [@role_routing, @collaboration_scope, @source_fidelity, @stable_identifiers,
+          @request_contract, @current_view, @handoff_version, @merge_return,
+          @missing_versions, @response_history]
+  ALSO: ["核对本次改动及关联位置，编号唯一、引用和相对链接可达，无未答项、部分接受、冲突或时间条件丢失",
+         "草案、提议、已收到、已确认、验收完成不混用；修改仅涉及本次 CR，文档检查不冒充业务验收"]
+  EXPOSE: on_issue
+
+OUTPUT:
+  FORMAT: markdown
+  MUST: ["交付文档链接、本轮新增或变化结论、仍待谁回答的阻塞问题",
+         "未实际发送则说明‘文档已保存，未发送’；只落盘不增设发送审批"]
+```
 
 ## 调用示例
 

package/skills/crd/assets/cr-template.md

@@ -1,3 +1,17 @@
+# CRD 写作模板
+
+以下 ODC 声明仅约束写作，不带入 CRD；下方 Markdown 是正文骨架。新建时按规模裁剪，续谈沿用现有结构与编号。
+
+```formal
+RULE @cr_template:
+  MUST: ["只写协作边界、双方配合及可观察验收，已有契约与提议分清，不代设计接收方内部实现",
+         "沿用 CR 标识、版本及稳定 R/Q/RESP 编号，未知事实与时间如实注明",
+         "正文维护有依据的当前视图；往返记录始终在文末，只追加、更正引用旧号并保留历史",
+         "无问题写暂无、无答复写暂无答复，移除未使用的示意条目与模板说明"]
+  MUST_NOT: [fabricated_replies_or_commitments, "将已回复当已接受或将文档完成当验收完成"]
+```
+
+````markdown
 # CR：<协作主题>
 
 | 项目 | 内容 |
@@ -64,3 +78,4 @@
 **未答项与下一步**：<待谁回答/确认什么；有明确时间约定才填写。>
 
 <!-- 后续 RESP-02、RESP-03 等追加于此，保留已有记录。生成实际 CR 时移除模板说明和未使用的示意条目。 -->
+````

package/skills/crd-respond/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: crd-respond
 argument-hint: "<接收方收到的 CRD 路径/链接/内容> [本方项目/仓库] [需求ID/范围] [仅评估/仅答复] [计划输出路径]"
-description: 跨项目 CRD 接收方使用：评估需求与长期方案、答复或续接澄清；提出方起草及整合回复用 crd，非 Kubernetes CRD 或直接实施。基于最新代码在原文末答复，需改代码用 dev-plan。
+description: 跨项目 CRD 接收方使用：评估需求与长期方案、答复澄清或回告实现结果；提出方用 crd，非 Kubernetes CRD 或代码实施。需改码时生成带来源 CR 与完成回写约定的开发计划。
+when_to_use: "用户会说「评估一下对方这个需求」「在 CRD 末尾回一段」「继续答复他们的追问」「计划完成了，回写对应 CR」这类接收方请求时。"
 ---
 
 # crd-respond · 接收方评估并答复 CRD
@@ -25,6 +26,7 @@ description: 跨项目 CRD 接收方使用：评估需求与长期方案、答
 - **评估或拟答复（默认）**：执行第 1–7 节，基于本方最新代码判断目标与方案，需改码时按授权生成计划。
 - **仅原样追加本方已拟好的答复，或收录提出方实际澄清/确认**：读完整 CRD，核对来源、角色、版本和关联编号，按第 5、7 节追加与回读；保留原意、条件和发言归属，只写必要标识。不重新调查代码、重评方案、代拟新立场或生成计划；模板仅用来源/关联、正文、未答项与下一步，不伪造评估与代码基线。无明确确认仍标草案，收到澄清不等于此前方案已获接受。
 - **续接提出方修订或返回的 CRD**：仍走接收方入口，先核对上次返还基线、收到版本与本地稿，保留双方增量和历史；正文实质变化或冲突明确归属、保持待确认，不按文件时间覆盖。只要求收录时仅收录；要求重新评估时只重开受新证据/决定影响的判断，再追加本轮答复。
+- **对应请求完成后的实现结果回告**：按第 1 节定位来源与最新版本，读取关联计划、相关实现/验收记录及必要代码证据，按第 6 节「实现结果回告」和第 5、7 节追加、回读。不重做方案评估、不生成新计划、不实施代码；只读要求仍优先。
 
 ## 1. 锚定收到的文档与最新代码
 
@@ -98,12 +100,21 @@ description: 跨项目 CRD 接收方使用：评估需求与长期方案、答
 - 推荐/已确认方案、原目标与验收、接受/不接受范围、双方责任和依赖；
 - 本方必需代码增量、非目标、兼容/迁移、风险与验证判据，以及未决项、解除条件和确认来源。
 
-计划的「需求来源」定位到 CRD 与对应 R/RESP（有关联 PRD/期次再如实补充，不编造期次），保留原需求 ID 的文档语境。内部实施设计进入计划，对外答复保留必要契约与判断，不替对方写内部开发计划。输出路径、重名处理与状态遵守 `dev-plan`，无用户代号时可用 `<CR标识>-respond`；已有文件先核对，不擅自覆盖。
+计划的「需求来源」必须显式记录**来源 CR（即原 CRD）的标识、可定位路径/链接、版本与对应 R/Q/RESP**；缺失版本如实注明，无编号用稳定章节定位，不补造。存在工作副本时区分原来源和实际回写文件，有关联 PRD/期次再如实补充，不把 CR 来源简化为「用户需求，无 PRD」。保留原需求 ID 的文档语境，在既有需求/验证映射中明确本计划承接的请求或子范围、检查与收口里程碑，避免单计划完成被误记为整份 CR 完成。
+
+把**对应请求实现并通过约定检查后回写来源 CR**的规则带入计划顶部实施协议：回写位置、按请求核对范围与证据、文末追加实现结果、查重及不可写时的恢复办法均须自包含，不能只留在本技能或依赖实施者再次加载技能。内部实施设计进入计划，对外答复保留必要契约与判断，不替对方写内部开发计划。输出路径、重名处理与状态遵守 `dev-plan`，无用户代号时可用 `<CR标识>-respond`；已有文件先核对，不擅自覆盖。
 
 - **先查已有承接计划**：范围、方案、验收和依赖已覆盖且基线仍适用时，引用真实计划与当前状态，不重复生成。未覆盖增量按独立范围生成新计划；修订已有计划需有用户授权，不擅改其历史进度。
 - **需要修改，但关键确认未完成**：仍调用 `dev-plan`，推荐方案明确为待确认提议，计划标 `Blocked`，写清阻塞；不能跳过计划，也不能把外部未接受的契约写成 `Ready`。独立已确定部分可单独规划，未决部分显式排除并跟进，不宣称覆盖整个 CRD。
 - **代码动作待定**：不包装成已确定改码需求；先保存答复与澄清问题。**无需修改**：说明无需新计划，不制造空计划。
-- 生成后回读计划，核对目标、ID、范围、取舍、验收及基线与答复一致，再把实际计划链接/状态与需求去向填入**尚未定稿的本轮答复**。计划失败时本轮答复如实记录失败与恢复入口，原有答复不覆盖。任何状态都不触发代码实施或发送 CRD。
+- 生成后回读计划，核对目标、ID、范围、取舍、验收及基线与答复一致，来源 CR 与完成回写规则齐备，再把实际计划链接/状态与需求去向填入**尚未定稿的本轮答复**。复用已有计划也核对这两项；缺失时按既有修订授权补齐，未授权修订则明确交接缺口，不冒称已有闭环。计划失败时本轮答复如实记录失败与恢复入口，原有答复不覆盖。任何状态都不触发代码实施或发送 CRD。
+
+### 实现结果回告
+
+- 以来源 CR 的最新有效请求、关联计划承接范围、当前实现及适用的检查证据逐项核对。只有对应请求的实现与约定验证均完成，才回告该范围已实现；一个计划只覆盖部分验收或请求分散在多计划时，写清本次已完成部分与剩余项，不因计划全部完成关闭整条请求或整份 CR。代码存在、计划打勾或 `Ready` 都不能替代验证。
+- 在实际回写文件末尾追加新的 RESP，引用被更新的旧 RESP 与 R/章节，说明实现行为、计划/里程碑、代码版本、验证结果、使用条件和剩余配合；明确旧「未实现」判断在何种范围内被本轮结果取代。保留原文与历史，不重写旧答复；本方实现、发布生效与提出方验收分别陈述，未发布/未集成/未获对方验收如实保留，不代对方确认。
+- 沿用第 5 节的编号、查重与第 7 节的并发复核。同一请求范围、实现版本与验证结论已有实质等价回告时不重复追加或更新时间；有变化只追加受影响范围。只复用可共享证据，内部敏感细节留在本地记录。
+- 来源缺失、目标不唯一或无法保真写回时，保存可追加答复与明确缺口，在计划相关记录和下一步保留待回写位置、原因与恢复动作；原来源只读时按第 1 节使用工作副本，明确未更新原件。回读成功后在对应里程碑记录保存 CR/RESP 链接。未回写不宣称闭环完成，也不因回告自动发送、发布或改平台状态。
 
 ## 7. 回读、核对与交付
 
@@ -112,9 +123,9 @@ description: 跨项目 CRD 接收方使用：评估需求与长期方案、答
 - 当前代表接收方，未代提出方改需求或确认方案；评估模式下所有在范围内的需求均有目标/方案判断、证据、立场和本方代码动作，未知、未答、不接受部分与冲突未丢失。仅收录/原样追加时核对与来源一致，不要求制造新评估结论。
 - 评估模式下对「可持续、通用、精心设计」有具体证据与后果，而非口号；备选保持目标或显式提出验收变更，未暗增产品范围。
 - 原正文与历史未被重写，RESP/Q 无碰撞且引用可达，新答复在文末，重复输入未重复追加；草案、确认、承诺、交付未混用。
-- 评估模式需改码的每项已按授权去往真实计划、现有承接或明确生成受阻；未决依赖按计划就绪门处理；没有假链接或空计划。仅收录/原样追加不因消息内容触发计划；未运行的验证没有写成通过。
+- 评估模式需改码的每项已按授权去往真实计划、现有承接或明确生成受阻；计划记录来源 CR、承接范围与顶部完成回写约定；未决依赖按计划就绪门处理；没有假链接或空计划。仅收录/原样追加不因消息内容触发计划；未运行的验证没有写成通过。实现结果回告只更新证据覆盖的请求范围，未实现余项和待回写缺口仍可追踪。
 
-最终给出：完整 CRD 路径与新增 RESP、关键立场、本方是否需改代码、计划路径/状态（或无需/待定/受阻）、仍待谁确认什么。仅收录/原样追加时给实际记录与未答项，明确未重新评估、未生成计划，不把已有立场当本次新结论。没有发送就明确「文档已保存，未发送」。有计划时给可直接复制的下一步 `review-dev-plan <实际计划路径>`（按当前客户端用 `$` 或 `/`），不自行评审或开始实施；仅评估时只交付评估内容与未落盘说明。
+最终给出：完整 CRD 路径与新增 RESP、关键立场、本方是否需改代码、计划路径/状态（或无需/待定/受阻）、仍待谁确认什么。仅收录/原样追加时给实际记录与未答项，明确未重新评估、未生成计划，不把已有立场当本次新结论。没有发送就明确「文档已保存，未发送」。评估模式有计划时给可直接复制的下一步 `review-dev-plan <实际计划路径>`（按当前客户端用 `$` 或 `/`），不自行评审或开始实施；实现结果回告则交付实际 CR/RESP、完成范围、证据与余项，复用既有实施/评审阶段的下一步，不退回计划评审；仅评估时只交付评估内容与未落盘说明。
 
 ## 项目状态回写
 
@@ -131,4 +142,5 @@ CRD 答复不是新的 PRD、开发计划或代码评审类型；作为相关对
 使用 $crd-respond 作为接收方账号项目，把本方已拟好的这段答复原样追加到原 CRD，不重新评估或生成计划。
 使用 $crd-respond 作为接收方账号项目，收录提出方订单项目对 Q-02 的澄清，保留其发言归属。
 使用 $crd-respond 作为接收方，核对提出方返回的修订 CRD 和本地增量，基于新证据重新评估受影响条目并追加答复。
+使用 $crd-respond docs/cr/CR-user-query.md，作为接收方核对关联计划的实现与验证证据，回告对应请求的完成范围和剩余配合。
 ```

package/skills/crd-respond/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "CRD 接收方评估与答复"
-  short_description: "接收方评估跨项目需求与长期方案，在原 CRD 文末答复或续接澄清；需改本方代码时生成计划"
-  default_prompt: "使用 $crd-respond 代表 CRD 接收方处理完整文档；若实际是提出方则交回 crd，不因收到文件或追加回复而切换角色。评估时核实本方最新工作树，分别判断目标和指定方案，以可持续性、通用性、精心设计及实际约束比较长期备选，在原文末追加有证据且保留历史的答复；需改本方代码时实际调用 dev-plan 生成并核验计划，未决契约标 Blocked。仅原样追加本方已拟答复或收录提出方澄清时保留来源与原意，不重评或生成计划。仅评估/仅答复遵守边界，不实施，不发送。"
+  short_description: "接收方评估与答复 CRD、回告实现结果；需改码时生成带来源 CR 与完成回写约定的计划"
+  default_prompt: "使用 $crd-respond 代表 CRD 接收方处理完整文档；若实际是提出方则交回 crd，不因收到文件或追加回复而切换角色。评估时核实本方最新工作树，分别判断目标和指定方案，以可持续性、通用性、精心设计及实际约束比较长期备选，在原文末追加有证据且保留历史的答复；需改本方代码时实际调用 dev-plan，核验来源 CR、承接范围与计划顶部完成回写约定，未决契约标 Blocked。实现结果回告按请求与适用证据追加新 RESP，保留旧答复及未完成余项，不把实现冒充发布或对方验收，不重开规划。仅原样追加本方已拟答复或收录提出方澄清时保留来源与原意，不重评或生成计划。仅评估/仅答复遵守边界，不实施，不发送。"

package/skills/crd-respond/assets/response-template.md

@@ -45,8 +45,15 @@
 #### 开发计划与下一步
 
 - 计划：<真实相对链接、Ready/Proposed/Blocked、承接的 R-ID；无需新计划/用户限定仅答复/动作待定/生成受阻则写明>
+- 完成回告：<来源 CR 与实际回写文件、对应请求/子范围及收口检查；计划顶部已写入验证完成后追加实现结果的约定；未实现部分不提前标完成>
 - 关键前置：<待谁确认什么、怎样解除；替代契约未接受时不能标 Ready>
 - 双方配合与验收：<可观察的目标、异常/兼容判据及由谁验证，提议与确认分开>
 - 下一步：<有计划时 review-dev-plan 的实际路径；无计划时明确澄清/对方行动；不开始实施、不发送 CRD、不编造排期>
 
 <!-- 实际答复移除写作指引与占位。接收方仅原样追加/收录时，标题和发言方沿实际来源，只用来源/关联、正文、未答项与下一步，删去未执行的评估/代码基线/计划段落。只追加此轮，不改原需求、Q&A 或既有历史；必要时在文末先建“往返答复记录”节。对外版本保留完整原文及答复，敏感内部证据不外发。 -->
+
+<!-- 实现结果回告时标题改为“实现结果回告”，沿用来源、关联、基线与确认边界，正文只保留下表及剩余配合/下一步，不重填方案评估或规划段落。 -->
+
+| 原请求/子范围与旧 RESP | 本方实现结果 | 计划/里程碑与版本 | 验证结果与证据 | 剩余范围、发布/集成及对方验收 |
+| --- | --- | --- | --- | --- |
+| <来源 CR 的 R-ID/章节及被更新的 RESP> | <已实现的具体行为；部分完成写清边界，本轮取代的旧判断> | <真实计划链接、里程碑及验证适用版本> | <实际检查与结果；未运行/失败如实写明> | <未覆盖请求、使用条件、待谁配合；不把本方实现写成对方已验收> |

package/skills/crd-respond/evals/scenarios.md

@@ -12,6 +12,7 @@
 | “我是提出方订单项目，把账号项目发来的回复收录到原 CRD。” | crd | 因「收到回复」选 crd-respond、代接收方拟答复 |
 | “作为提出方，请回答接收方对 R-01 的反问。” | crd | 因「答复」切换接收方技能 |
 | “作为接收方，收录提出方对 Q-02 的澄清。” | crd-respond，仅收录 | 把提出方发言冒充本方、重评或生成计划 |
+| “作为接收方，这份计划已做完，把对应 CR 的实现结果补上。” | crd-respond，实现结果回告 | 因「计划」重开 dev-plan、直接把整份 CR 标完成 |
 | “我是提出方，对方返回稿和本地都有修改，请整合三份版本。” | crd | 用接收方评估代替提出方版本整合 |
 | “我是接收方，提出方修订 CRD 后又返回了，请保留本地增量并重评受影响条目。” | crd-respond | 因「返回稿」选 crd，覆盖增量或全盘重做 |
 | “将这段回复原样追加到 CRD。”无其他角色上下文 | 先核实提出方/接收方角色 | 不问归属就按动作固定选 crd 或 crd-respond |
@@ -32,6 +33,12 @@
 | 现有原 CRD 含 RESP-01 和 Q-01，本次更正旧判断；原件正文不可改 | 保留字节级原文前缀，递增 RESP，新问题不碰撞、引用旧判断与依据；不冒称双方达成一致/已发送 | 重写正文或历史、复制整份文档到答复块、编号冲突 |
 | 同一 CRD/相关代码/决定连续调用两次，已有适用承接计划 | 第二次核对后不重复 RESP/计划、不更新时间；链接实际承接范围与状态 | 每次生成新答复/计划，或无关 HEAD 变化导致重复记账 |
 | 计划文件已存在但未覆盖新增需求 | 只规划未覆盖增量，遵守 dev-plan 重名保护，不覆盖历史进度 | 无授权修订旧计划、复制完成记录、只因文件名相似判已承接 |
+| CR 无 PRD，本轮 RESP 承接 R-01 与 R-02 的部分验收；另有只读原来源和可写工作副本 | 实际计划顶部保留 CR 标识/版本、原来源/回写文件及 R/Q/RESP，既有映射定位子范围、检查与收口里程碑；顶部实施合同带齐完成回写动作 | 来源被简化成「用户需求，无 PRD」、只在答复中记录来源、把实施规则藏在技能里 |
+| 全新实施上下文只读生成的计划、仓库与记录，不加载规划/答复技能；对应请求的实现及约定检查已完成，另有无关里程碑未完 | 按计划合同在本次进度回写时追加实现结果 RESP，引用旧「未实现」答复、对应请求、版本及验证证据，在记录保存回告链接 | 等整份计划完成才回告、要求重新加载技能或只更新计划进度 |
+| 一个 CR 有多个请求，单计划已完成但只覆盖 R-01 的部分验收；另一承接计划未完成 | 只回告已有证据覆盖的子范围，明确剩余请求/验收与后续配合，保留历史；不声称整条请求、整份 CR、发布或对方验收完成 | 按计划完成率关闭 CR，或把单测通过冒充真实集成 |
+| 旧计划仅打勾完成但缺相关验证记录，或要求的真实检查失败/未运行 | 核对实际实现和适用证据，明确缺口，不回告请求已实现且验证完成，不伪造证据 | 用 Ready/勾选/文件存在推导请求已满足 |
+| 完成回告连续运行两次，第二次仅有无关 HEAD 变化 | 第二次不新增 RESP、不改时间；有实质实现/验证变化时仅追加受影响范围 | 重复完成通知、改写旧未实现答复、仅因 HEAD 变化刷一轮 |
+| 回告时来源被移动、目标有多个候选、只有只读链接，或原文有并发新增答复 | 可唯一保真回写时重读并保留并发增量；否则保存可追加内容，在计划记录与下一步留恢复动作，工作副本与原件明确区分；只读请求不落盘 | 猜路径、覆盖他人答复、声称远程原件已更新、吞掉待回写事项 |
 | dev-plan 未安装，或计划校验失败 | 保存完整答复、明确生成受阻与恢复输入，不伪造链接/状态、不擅自安装 | 宣称计划已生成，或缩写任务清单冒充 dev-plan 计划 |
 | 接收方要求原样追加其已拟答复，内容提到“本方需改码”；另一变体为收录提出方澄清 | 只读完整 CRD 与消息来源，字节级保留原文前缀、递增 RESP、保留消息原意与归属，不重评、不调查代码、不生成计划 | 转给 crd、因消息提到改码自动调用 dev-plan、代拟立场、篡改原意 |
 | 提出方误点 crd-respond 要求答复接收方反问；接收方误点 crd 要求评估需求 | 从材料核实实际角色并读取正确技能后交回相应流程，不继续错误角色动作 | 因显式技能名代另一方作答、直接拒绝不交接或无限互相转派 |

package/skills/create-verification-skill/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: create-verification-skill
 description: "为指定应用或场景创建、维护验证 skill 时使用；不用于只写测试计划、一次性验收或只读咨询。生成可按范围执行的 verify-*，验证真实入口并保存证据，可供 agi-mode 复用。"
+when_to_use: "用户会说「给这个应用做个验证 skill」「把验收命令固化成可复跑的验证」时。"
 ---
 
 # Create Verification Skill

package/skills/debugging/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: debugging
 description: Use for bugs, test failures or unexpected behavior. Investigate and verify the root cause before proposing or implementing fixes.
+when_to_use: 'Reports like "this test fails", "the app crashes on save", or "it only breaks sometimes".'
 license: MIT
 ---
 

package/skills/design-md/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: design-md
 description: 用于从现有仓库、网站或明确设计决策创建、更新、校验或导出 DESIGN.md；不用于寻找新风格、页面实现或组件重构。提炼有证据的设计规则，保留既定规范并报告偏差。
+when_to_use: "用户会说「把设计规范整理成 DESIGN.md」「这份 DESIGN.md 和现在的界面还对得上吗」「更新一下设计规范」时。"
 ---
 
 # design-md · 可追溯的项目设计规范