@cr1992/agentkit 1.1.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/docs/worktree/review-lifecycle.md +7 -0
  3. package/domains/worktree/worktree-doctor.mjs +8 -2
  4. package/manage-worktrees/SKILL.md +10 -10
  5. package/orchestrate-subagents/SKILL.md +15 -15
  6. package/package.json +1 -1
  7. package/run-agent-verify-loop/SKILL.md +4 -4
  8. package/shell-manifest.json +1 -1
  9. package/verify-agent-output/SKILL.md +3 -3
package/CHANGELOG.md CHANGED
@@ -4,6 +4,22 @@
4
4
 
5
5
  ## Unreleased
6
6
 
7
+ ## 1.1.1 - 2026-09-08
8
+
9
+ - 修复 `doctor` 对已回收 record 仍生成需要活树才能收敛的 metadata finding。`stack_parent`、
10
+ `history_operation` 和 `review_refresh` 三个分支缺少 `worktree_state` 过滤，对已删除目录报
11
+ `STACK_PARENT_ADVANCED` 等提示，其补救动作（managed rebase/retarget、`rebase --continue`、
12
+ `refresh-review`）在回收后都无法执行，噪声永远清不掉；其中 error 级的还会按「任何 error 都暂停
13
+ `spawn/adopt`」把后续派工钉死。生命周期与 watcher 两个收集器早已是这个口径，本次补齐 metadata。
14
+ - `manage-worktrees` 补齐 `--no-watch` 的使用判据：只用于确定不会合入，或武装失败原因为永久性
15
+ （否则 pending 会积一条清不掉的 `AUTO_RECLAIM_NOT_ARMED`）。明确禁止因 watcher 活不过会话或
16
+ 为压后台进程数而关闭——前者是 `watch-service` 的职责，后者不成立（`disabled` 持久且不重试）。
17
+ - `watch-service status` 进入强制流程表的「恢复/盘点」行，不再只以表外散文形式存在。
18
+ - 四个 SKILL.md 对 `docs/<域>/` 的引用从相对链接改为 `agentkit docs <域> <主题>` 命令。宿主把 Skill
19
+ 基目录报成安装路径（常为软链），Read 工具按词法折叠 `..`，原 `../docs/...` 链接在安装态全部不可达，
20
+ agent 只剩摘要表。`validate-skills` 新增安装态检查：SKILL.md 相对链接越出 Skill 目录即报错，
21
+ `agentkit docs` 引用的主题必须真实存在。
22
+
7
23
  ## 1.1.0 - 2026-09-07
8
24
 
9
25
  - 修复从待回收 worktree 自身执行 `reclaim` 时，目录删除后误判本地分支已不存在的问题；未完成的
package/docs/worktree/review-lifecycle.md CHANGED
@@ -17,6 +17,13 @@ agentkit worktree touch <selector> --status ready_for_review
17
17
  则持久登记 `disabled`，与启动失败严格区分。`doctor` 对 pending、缺失 intent 和显式退出分别报告
18
18
  `AUTO_RECLAIM_NOT_ARMED`、`AUTO_RECLAIM_INTENT_MISSING` 与 `AUTO_RECLAIM_DISABLED`。
19
19
 
20
+ `--no-watch` 只用于两种情况：change request 确定不会合入（与 `unwatch` 同一判据）；或该树的合入在结构上
21
+ 无法被 watcher 观测且原因是永久的（例如仓库没有可刷新的远端 target），此时留在 pending 只会积一条永远清不
22
+ 掉的 `AUTO_RECLAIM_NOT_ARMED`（error），按强制流程会挡住后续 `spawn/adopt`。除此之外一律不要关：watcher
23
+ 活不过当前会话是 `watch-service` 要解决的问题，不是关 watcher 的理由；也不能拿它临时压后台进程数——
24
+ `disabled` 是持久策略，`resume-all` 不重试，没有“解除节流”这一步。dirty、未 push、网络等**可恢复**原因
25
+ 导致的武装失败，留在 pending 等重试，不要转成 `disabled`。
26
+
20
27
  进程级 watcher 只保证当前宿主允许后台进程存活期间的即时回收。需要跨 Agent 会话或机器重启：
21
28
 
22
29
  ```bash
package/domains/worktree/worktree-doctor.mjs CHANGED
@@ -39,7 +39,14 @@ export function createCommands(deps) {
39
39
  } = deps;
40
40
 
41
41
  function collectDoctorRecordMetadataFindings(loaded, listing, recordsById, record, findings) {
42
- if (record.storage_class === 'ephemeral' && record.worktree_state !== 'reclaimed') findings.push({ code: 'EPHEMERAL_WORKTREE', severity: 'warning', worktree_id: record.worktree_id, path: record.path });
42
+ // 本收集器的每条 finding 都要求一棵活树才能收敛：commit+push、rebase --continue、
43
+ // refresh-review --continue/--abort、managed rebase 或 retarget、补记 base_reason。
44
+ // record 一旦 reclaimed，目录已经删除，这些提示既没有补救动作也永远不会消失；其中 error 级的
45
+ // （MANAGED_HISTORY_OPERATION_PENDING / REVIEW_REFRESH_PENDING / STACK_PARENT_*）还会按
46
+ // SKILL 的「任何 error 都暂停 spawn/adopt」把后续派工钉死。生命周期与 watcher 两个收集器
47
+ // 已经是这个口径，这里补齐；archived 更早一步在调用方 continue，所以只需排除 reclaimed。
48
+ if (record.worktree_state === 'reclaimed') return;
49
+ if (record.storage_class === 'ephemeral') findings.push({ code: 'EPHEMERAL_WORKTREE', severity: 'warning', worktree_id: record.worktree_id, path: record.path });
43
50
  if (record.history_operation) {
44
51
  findings.push({
45
52
  code: 'MANAGED_HISTORY_OPERATION_PENDING',
@@ -103,7 +110,6 @@ export function createCommands(deps) {
103
110
  }
104
111
  }
105
112
  if (
106
- record.worktree_state !== 'reclaimed' &&
107
113
  loaded.profile.default_base &&
108
114
  record.base_ref &&
109
115
  record.base_ref !== loaded.profile.default_base
package/manage-worktrees/SKILL.md CHANGED
@@ -23,7 +23,7 @@ metadata:
23
23
  下文多行示例采用 POSIX 续行语法；PowerShell/cmd 保留相同 argv 即可。不要把 `python3`、`bash`、
24
24
  `~` 展开或 `/tmp` 视为跨平台常量。
25
25
 
26
- 不要假设目标仓库有同名脚本。仓库可以通过根目录 `.worktree-trace.json` 提供 Profile，但 portable core 不执行 Profile 中的任意 shell command。配置 schema 和项目适配边界见 [Profile 配置](../docs/worktree/profile.md)。
26
+ 不要假设目标仓库有同名脚本。仓库可以通过根目录 `.worktree-trace.json` 提供 Profile，但 portable core 不执行 Profile 中的任意 shell command。配置 schema 和项目适配边界见 Profile 配置（`agentkit docs worktree profile`）。
27
27
 
28
28
  所有命令都必须从**目标 Git 仓库的任意 worktree 内**执行：manager 以当前工作目录解析 repository
29
29
  identity、primary worktree 和 Profile。
@@ -58,18 +58,18 @@ manager 的 trace/common-dir 状态只应由受信 operator/controller 与 runti
58
58
 
59
59
  | 阶段 | 最小命令面 | 硬门禁与按需文档 |
60
60
  |---|---|---|
61
- | 恢复/盘点 | `resume-all` → `list` → `doctor` | `list/doctor` 只读；`UNTRACKED` 不等于无人使用；`EPHEMERAL` 优先 commit+push；任何 error 都暂停 `spawn/adopt` |
61
+ | 恢复/盘点 | `watch-service status` → `resume-all` → `list` → `doctor` | 常驻服务未安装时只报告并建议 `watch-service install`，不得用 `--no-watch` 顶替；`list/doctor` 只读；`UNTRACKED` 不等于无人使用；`EPHEMERAL` 优先 commit+push；任何 error 都暂停 `spawn/adopt` |
62
62
  | 碰撞扫描 | `scan --target <paths>` | `COLLIDE`、范围不确定或重做昂贵时隔离；`CLEAR` 仅在 owner 明确且改动小时共享；低置信后缀匹配先人工核对路径基准 |
63
- | 交付身份 | 选择复用/并存/替代 | branch、MR 或目录名不同不能单独证明独立交付；同一 agent 有存量树或需要替代时读[交付身份](../docs/worktree/delivery-identity.md) |
64
- | 创建/接管 | `spawn <semantic-slug>` / `adopt <path>` | 使用真实 agent-id，不猜身份；task 至少两个 lowercase 语义分词；base、root、堆叠、rebase/retarget 读[创建与堆叠](../docs/worktree/spawn-and-stack.md) |
65
- | 更新/交接 | `touch` / `handoff` / `refresh-review` | `ready_for_review` 默认武装冻结 HEAD；handoff 只接受 clean、已 push 边界，禁止 stash 搬运；读[评审生命周期](../docs/worktree/review-lifecycle.md) |
63
+ | 交付身份 | 选择复用/并存/替代 | branch、MR 或目录名不同不能单独证明独立交付；同一 agent 有存量树或需要替代时读交付身份（`agentkit docs worktree delivery-identity`） |
64
+ | 创建/接管 | `spawn <semantic-slug>` / `adopt <path>` | 使用真实 agent-id，不猜身份；task 至少两个 lowercase 语义分词；base、root、堆叠、rebase/retarget 读创建与堆叠（`agentkit docs worktree spawn-and-stack`） |
65
+ | 更新/交接 | `touch` / `handoff` / `refresh-review` | `ready_for_review` 默认武装冻结 HEAD；handoff 只接受 clean、已 push 边界，禁止 stash 搬运；读评审生命周期（`agentkit docs worktree review-lifecycle`） |
66
66
  | 审计/提交 | `audit` / `submit` | portable core 不决定 MR/PR 或直推策略；先服从目标仓规则，再原子登记 change request 与 watcher target |
67
- | 批量集成 | `plan-batch` → `batch-integrate` → `batch-step` → `batch-result` | 同仓同 target：≥3 默认聚合，2 个仅在碰撞时；只合成冻结 SHA，不代跑门禁；合同/顺序/target 变化即重规划；读[批量集成](../docs/worktree/batch-integration.md) |
68
- | 回收 | `reclaim` / `archive` | 必须有远端/其他 ref 可达证明或明确 archive evidence；dirty、stash、submodule、权限或 branch-tip 异常一律 `KEEP`；替代树默认先归档，`--discard` 需人工明确授权；读[回收与看护](../docs/worktree/reclaim-and-watch.md) |
67
+ | 批量集成 | `plan-batch` → `batch-integrate` → `batch-step` → `batch-result` | 同仓同 target：≥3 默认聚合，2 个仅在碰撞时；只合成冻结 SHA，不代跑门禁；合同/顺序/target 变化即重规划；读批量集成（`agentkit docs worktree batch-integration`） |
68
+ | 回收 | `reclaim` / `archive` | 必须有远端/其他 ref 可达证明或明确 archive evidence；dirty、stash、submodule、权限或 branch-tip 异常一律 `KEEP`；替代树默认先归档，`--discard` 需人工明确授权；读回收与看护（`agentkit docs worktree reclaim-and-watch`） |
69
69
 
70
- `resume-all` 只提供当次恢复。需要跨 Agent 会话、注销或重启后仍自动恢复 watcher 时，先检查
71
- `agentkit worktree watch-service status`；macOS 可由用户一次性显式执行 `watch-service install`。
72
- 未安装常驻维护器时不得把进程级 watcher 描述成跨会话保证。
70
+ `resume-all` 只提供当次恢复。跨 Agent 会话、注销或重启后仍要自动恢复 watcher，靠的是常驻维护器：
71
+ macOS 由用户一次性显式执行 `watch-service install`。未安装时不得把进程级 watcher 描述成跨会话保证，
72
+ 也不得因此改用 `--no-watch`（判据见评审生命周期）——那只会把待回收的树变成无人看护。
73
73
 
74
74
  不得按目录年龄、名称或“看起来干净”删除。禁止 `rm -rf`、`git worktree remove --force`、`branch -D`
75
75
  和 feature owner 手工 rebase。watcher 的 `merge-tree` 结果只是目标前进后的只读成本预判，不保证逐
package/orchestrate-subagents/SKILL.md CHANGED
@@ -38,7 +38,7 @@ controller 始终拥有闭环对象、完成标准、任务图、依赖/barrier
38
38
 
39
39
  派生后维护“活跃 Agent”“本批已完成”，存在并行时再维护“工作进展”；在派发、批次收口、用户询问
40
40
  和最终答复时更新，无活跃 worker 明示为 0，不虚构百分比。字段与状态变换见
41
- [编排运行时](../docs/orchestrate/orchestration-runtime.md)「派发台账的三张表」。台账也是回收清单：收口前
41
+ 编排运行时（`agentkit docs orchestrate orchestration-runtime`）「派发台账的三张表」。台账也是回收清单：收口前
42
42
  确认没有孤儿 worker/worktree/运行时资源。任务图与台账只写仓库外会话状态；完整档用 mechanical
43
43
  ledger，轻量档用单一 JSON 快照，闭环后清理。
44
44
 
@@ -48,7 +48,7 @@ ledger，轻量档用单一 JSON 快照，闭环后清理。
48
48
  只有 `allowed` 可用。输入已随合同完整提供、节点不依赖额外宿主能力时 requirements 可为空，
49
49
  此时记 `not_required` 及依据即可。同机、本地或过去恒过都不构成豁免。探针只在比 controller 自做或
50
50
  缩小节点更便宜时派发，并计入 worker 与 Token 预算。能力键前缀、binding 与复用规则、反应矩阵见
51
- [编排运行时](../docs/orchestrate/orchestration-runtime.md)「Worker 有效能力预检」。
51
+ 编排运行时（`agentkit docs orchestrate orchestration-runtime`）「Worker 有效能力预检」。
52
52
 
53
53
  ### 显式轻量档
54
54
 
@@ -59,7 +59,7 @@ ledger，轻量档用单一 JSON 快照，闭环后清理。
59
59
  轻量档仍冻结每个节点的目标、范围、事实/假设、输出合同、验收、证据和停止条件，并在仓库外维护
60
60
  单一 JSON 快照；它只记录事实，不伪造 journal。资格失效时停止新派发，把现状和产物收养进完整 ledger。
61
61
  Reflection 使用 `agentkit orchestrate reflection record/propose`，通用 Skill 缺口不得写入宿主能力缓存。
62
- 快照 schema、收养步骤和 Reflection 约束见 [编排运行时](../docs/orchestrate/orchestration-runtime.md)。
62
+ 快照 schema、收养步骤和 Reflection 约束见 编排运行时（`agentkit docs orchestrate orchestration-runtime`）。
63
63
 
64
64
  ### 完整档机械台账工具
65
65
 
@@ -68,7 +68,7 @@ review-view / diff` 固定公共 Task Contract，再以仓库外 state root 初
68
68
  脚本不直接派发 Agent，controller 把宿主回执写入 `dispatch-record`。节点必须选择
69
69
  `worker_self_check`、`controller_recheck`、`independent_evidence`，只读 critic/scout 用
70
70
  `not_applicable`；依赖/barrier 未通过不派下游。命令、schema、`--expected-revision`、state root 信任
71
- 边界和批级熔断见 [编排运行时](../docs/orchestrate/orchestration-runtime.md)。
71
+ 边界和批级熔断见 编排运行时（`agentkit docs orchestrate orchestration-runtime`）。
72
72
  Reflection 只记证据化观察，Improvement Proposal 永远保持 `proposed`，不能改变当前运行。
73
73
 
74
74
  ## 1. 先过闸门
@@ -81,7 +81,7 @@ Reflection 只记证据化观察，Improvement Proposal 永远保持 `proposed`
81
81
 
82
82
  规模来自真正独立且单个上下文装不下的工作块，不来自话题数；删掉不影响答案的节点。常规盘点/审计
83
83
  一轮总 Agent 数 `≤10`。扫描与核验配比、
84
- 合并判据与各档规模见 [任务类型剧本](../docs/orchestrate/task-playbooks.md)。
84
+ 合并判据与各档规模见 任务类型剧本（`agentkit docs orchestrate task-playbooks`）。
85
85
 
86
86
  ## 3. 派发前决定环境
87
87
 
@@ -98,7 +98,7 @@ Reflection 只记证据化观察，Improvement Proposal 永远保持 `proposed`
98
98
 
99
99
  仓库 dirty、任务大或包含新文件本身都不足以要求隔离；先确认第二写入者、归属冲突或路径相交。
100
100
  裁决隔离后使用 `manage-worktrees`，它不改变任务图、权限或验收。不可用时必须先读
101
- [无 manage-worktrees 时的隔离下限](../docs/orchestrate/isolation-fallback.md)。
101
+ 无 manage-worktrees 时的隔离下限（`agentkit docs orchestrate isolation-fallback`）。
102
102
 
103
103
  共享树中 worker 不得切换分支，只按路径 stage / commit；禁止 `git add -A`、`git commit -am`、裸 `stash`、`reset --hard`、`checkout -- .` 和并发 merge，controller 是唯一 integrator。
104
104
 
@@ -107,7 +107,7 @@ Reflection 只记证据化观察，Improvement Proposal 永远保持 `proposed`
107
107
  2-3 个独立任务用宿主轻量并行；循环、条件、逐项管线或预算驱动才使用结构化编排。多 stage 默认逐条
108
108
  pipeline，只有跨条去重、聚合、比较或早退才设 barrier。截断、采样或不重试必须披露覆盖缺口。
109
109
  barrier、critic 面板与 loop-until-dry 的具体用法见
110
- [编排运行时](../docs/orchestrate/orchestration-runtime.md)「编排原语选择」。具体 API 服从宿主编排工具说明。
110
+ 编排运行时（`agentkit docs orchestrate orchestration-runtime`）「编排原语选择」。具体 API 服从宿主编排工具说明。
111
111
 
112
112
  ## 5. 派发可验收的任务契约
113
113
 
@@ -118,17 +118,17 @@ stop_conditions`；写任务再冻结权限、精确仓库/workdir/branch 和 wr
118
118
  controller 圆场。
119
119
 
120
120
  派发写 worker、完整档、独立 Evidence 或失败后重派前，必须读取
121
- [节点派发合同](../docs/orchestrate/dispatch-contract.md) 并使用完整 envelope。轻量只读节点可只使用上述最小合同。
121
+ 节点派发合同（`agentkit docs orchestrate dispatch-contract`） 并使用完整 envelope。轻量只读节点可只使用上述最小合同。
122
122
 
123
123
  ## 6. 控制运行态与升级
124
124
 
125
125
  用户可见台账只用 `运行中 / 阻塞 / 待验收`；`partial` 由 controller 决定继续、转阻塞或停止后判
126
126
  未通过。只有 controller 能给出 `通过 / 未通过 / 取消`。台账术语不进用户汇报，对外说法见
127
- [面向用户的汇报词表](../docs/orchestrate/user-facing-reporting.md)。
127
+ 面向用户的汇报词表（`agentkit docs orchestrate user-facing-reporting`）。
128
128
 
129
129
  只在结论交付、需要输入、scope/写入冲突、预算将尽、新依赖、失败或置信不足时介入；“等待中”不是
130
130
  状态包。能力故障、业务失败、中断与 contract gap 分开处理，不按失败次数机械升档。失败、重派、中断
131
- 或 controller 接手时读取[失败路由与恢复](../docs/orchestrate/failure-routing-and-recovery.md)。合同失真、
131
+ 或 controller 接手时读取失败路由与恢复（`agentkit docs orchestrate failure-routing-and-recovery`）。合同失真、
132
132
  新授权、不可逆动作、资源/结论冲突或重试耗尽必须升级，不得自行扩 scope。
133
133
 
134
134
  ## 7. 验证、收敛与停止
@@ -139,7 +139,7 @@ controller 圆场。
139
139
  复核记录；`independent_evidence` 绑定唯一 Artifact 与标准 Evidence；只读 critic/scout 用
140
140
  `not_applicable`，附一份 report 即收口。失败、不可判定、安全阻塞、
141
141
  human gate 或错绑 Evidence 均不能通过。节点专属验收合同只能用 `agentkit contract project` 从公共
142
- 合同切出 acceptance 子集；完整门禁见 [编排运行时](../docs/orchestrate/orchestration-runtime.md)「合同投影」。
142
+ 合同切出 acceptance 子集；完整门禁见 编排运行时（`agentkit docs orchestrate orchestration-runtime`）「合同投影」。
143
143
 
144
144
  快速演进分支的迭代期只读 review 最多算 `controller_recheck`；到 RC/合入候选才冻结唯一 Artifact，
145
145
  运行 `verify-agent-output` 生成 `independent_evidence`。
@@ -153,7 +153,7 @@ human gate 或错绑 Evidence 均不能通过。节点专属验收合同只能
153
153
  独立 reviewer 是高成本资源，不与 worker 1:1 配对。对同一 Artifact 默认只允许一次 primary review；
154
154
  第二次必须由 `undecidable`、证据冲突或协议歧义触发，使用不同 lens 且可能改变处置。smoke 未通过、
155
155
  同 lens 重复、输入超出预算或已有 `blocked_safety` 时不派。考虑任何 critic/reviewer 时必须读取
156
- [Reviewer 数量与 Token 预算](../docs/orchestrate/review-budget.md)，冻结 `extensions.review_policy`，并在派发前运行
156
+ Reviewer 数量与 Token 预算（`agentkit docs orchestrate review-budget`），冻结 `extensions.review_policy`，并在派发前运行
157
157
  `agentkit orchestrate review-budget evaluate`。提高 reviewer 数量或输入上限属于 re-contract。
158
158
 
159
159
  最终答复前用 `闭环项 / 标准 / 证据 / 结果` 审计：闭环对象与外部状态已重查；必要节点已验收且活跃
@@ -163,11 +163,11 @@ human gate 或错绑 Evidence 均不能通过。节点专属验收合同只能
163
163
  ## 8. 模型路由与宿主自适配
164
164
 
165
165
  controller 持续掌握目标、任务图、re-plan、失败分类和最终验收；worker 不自选模型或下一次配置。
166
- 派发、首次建 tier、失败后调档或切模型时读[模型路由](../docs/orchestrate/model-routing-config.md)，按任务类型
167
- 选档再读[任务剧本](../docs/orchestrate/task-playbooks.md)：使用本地配置中最低可靠 tier，model/effort 只取
166
+ 派发、首次建 tier、失败后调档或切模型时读模型路由（`agentkit docs orchestrate model-routing-config`），按任务类型
167
+ 选档再读任务剧本（`agentkit docs orchestrate task-playbooks`）：使用本地配置中最低可靠 tier，model/effort 只取
168
168
  用户配置与实时 schema，每次保存精确配置、attempt lineage、理由和预算；扩大授权或显著增费先确认。
169
169
 
170
170
  `agents/openai.yaml` 和缓存都不是能力证明。runtime/path/tool 要求先做有效能力预检；能力快照的创建、
171
- 刷新和复用读[宿主能力缓存](../docs/orchestrate/host-capability-cache.md)。实时 schema 优先，unknown 不能被
171
+ 刷新和复用读宿主能力缓存（`agentkit docs orchestrate host-capability-cache`）。实时 schema 优先，unknown 不能被
172
172
  缓存补成 allowed，缓存不能扩大授权。`protocol_version`、`runtime_version`、`content_digest` 分别表示
173
173
  协议兼容性、实现版本和精确安装内容，不得互相替代。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cr1992/agentkit",
3
- "version": "1.1.0",
3
+ "version": "1.1.1",
4
4
  "description": "Agent engineering toolkit: orchestration, git worktree isolation, independent verification and bounded verify loops.",
5
5
  "license": "MIT",
6
6
  "repository": {
package/run-agent-verify-loop/SKILL.md CHANGED
@@ -51,8 +51,8 @@ verification run，消费其标准 Evidence Package。Loop 不执行或复制完
51
51
  - runtime 只生成 `embedded_verification_record`，不能导出、转换或冒充 Evidence Package；
52
52
  - 无独立 reviewer 时停止，不用实现者自审产生 pass。
53
53
 
54
- 进入 embedded L1 前读取 [内嵌 review 适配器](../docs/loop/embedded-review-adapter.md)。
55
- verifier 行为语义以 [验收协议](../docs/verify/verification-protocol.md) 为唯一真源；独立安装本 Skill
54
+ 进入 embedded L1 前读取 内嵌 review 适配器（`agentkit docs loop embedded-review-adapter`）。
55
+ verifier 行为语义以 验收协议（`agentkit docs verify verification-protocol`） 为唯一真源；独立安装本 Skill
56
56
  时，adapter 只携带绑定和最低输入要求，不重定义 verdict。
57
57
 
58
58
  ## Runtime 流程
@@ -79,8 +79,8 @@ run-embedded-l0 → 新上下文 reviewer → record-embedded-review
79
79
  ```
80
80
 
81
81
  所有状态写命令可带 `--expected-revision <n>`；revision 不匹配时拒绝写入。详细状态迁移见
82
- [Loop 状态机](../docs/loop/loop-state-machine.md)，恢复和熔断见
83
- [恢复与熔断](../docs/loop/recovery-and-fuses.md)。只有发生复制/移动、journal 恢复、
82
+ Loop 状态机（`agentkit docs loop loop-state-machine`），恢复和熔断见
83
+ 恢复与熔断（`agentkit docs loop recovery-and-fuses`）。只有发生复制/移动、journal 恢复、
84
84
  reflection 或提案时才使用 `adopt-root / record-reflection / convergence-report / propose-improvement --help`。
85
85
 
86
86
  ## 决策规则
package/shell-manifest.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "schema_version": 1,
3
3
  "package_name": "@cr1992/agentkit",
4
- "package_version": "1.1.0",
4
+ "package_version": "1.1.1",
5
5
  "cli": {
6
6
  "command": "agentkit",
7
7
  "entry": "bin/agentkit.mjs"
package/verify-agent-output/SKILL.md CHANGED
@@ -31,8 +31,8 @@ controller 必须先提供：
31
31
  4. clean workdir，`HEAD == artifact_sha`；
32
32
  5. 新上下文 reviewer，或由用户中继的第二会话。只有当前实现者上下文时停止，不得伪造独立验收。
33
33
 
34
- 详细 envelope 与字段规则见 [Evidence schema](../docs/verify/evidence-schema.md)。进入 L1 前必须完整读取
35
- [验收协议](../docs/verify/verification-protocol.md)。
34
+ 详细 envelope 与字段规则见 Evidence schema（`agentkit docs verify evidence-schema`）。进入 L1 前必须完整读取
35
+ 验收协议（`agentkit docs verify verification-protocol`）。
36
36
 
37
37
  ## 标准流程
38
38
 
@@ -56,7 +56,7 @@ agentkit verify validate --run <run-dir>
56
56
  ```
57
57
 
58
58
  所有子命令支持 `--help`；写命令支持 `--expected-revision`。尚未准备输入、happy path 失败或需要完整
59
- 诊断时，先读 [输入准备与诊断命令](../docs/verify/input-preparation.md)。readiness/preflight 失败属于环境
59
+ 诊断时，先读 输入准备与诊断命令（`agentkit docs verify input-preparation`）。readiness/preflight 失败属于环境
60
60
  前提，不得记录为 Artifact verdict。
61
61
 
62
62
  ## 状态与裁决