# dsh-web-relay 主 agent 粗粒度能力注册表
# 本表只登记“文档 / Skill / 工具 / 机制”等粗粒度能力入口。
# 细粒度经验/lesson 请使用 docs/main-agent-lesson-schema-v0.1.md 的规范。
# category: project | workflow | platform | tool
# status: active | deprecated

- id: auto-iteration-modeling
  name: 自动迭代版本建模
  category: workflow
  scope: auto-iteration-only
  source: docs/auto-iteration-modeling.md
  skill: skills/auto-iteration-modeling/SKILL.md
  trigger: 用户要求自动迭代 N 个版本
  conflicts:
    - manual-development
  verification:
    - file-exists: docs/auto-iteration-modeling.md
    - file-exists: skills/auto-iteration-modeling/SKILL.md
    - content-contains:
        file: skills/auto-iteration-modeling/SKILL.md
        text: "Step 0"
  lastVerified: 2026-09-06
  status: approved
  version: 1

- id: main-agent-runbook
  name: 主 agent 执行手册
  category: workflow
  scope: dsh-web-relay-handoff
  source: docs/main-agent-runbook-v0.1.md
  skill: skills/dsh-web-relay-main-agent/SKILL.md
  trigger: 收到 dsh-web-relay handoff 或需要执行插件任务
  conflicts: []
  verification:
    - file-exists: docs/main-agent-runbook-v0.1.md
    - content-contains:
        file: docs/main-agent-runbook-v0.1.md
        text: "全局执行纪律"
  lastVerified: 2026-09-06
  status: approved
  version: 1

- id: main-agent-lesson-schema
  name: 主 agent 语境能力沉淀库 Schema
  category: workflow
  scope: capability-persistence
  source: docs/main-agent-lesson-schema-v0.1.md
  skill: null
  trigger: 主 agent 收口自检、能力沉淀、lesson 入库
  conflicts: []
  verification:
    - file-exists: docs/main-agent-lesson-schema-v0.1.md
    - content-contains:
        file: docs/main-agent-lesson-schema-v0.1.md
        text: "条目 Schema"
    - file-exists: docs/main-agent-lessons.json
  lastVerified: 2026-09-06
  status: approved
  version: 1

- id: capability-persistence-design
  name: 能力持久化及能力验证设计
  category: workflow
  scope: capability-persistence
  source: docs/capability-persistence-design.md
  skill: null
  trigger: 实施能力注册表、验证脚本、文档同步机制
  conflicts: []
  verification:
    - file-exists: docs/capability-persistence-design.md
    - content-contains:
        file: docs/capability-persistence-design.md
        text: "文档同步与更新机制"
  lastVerified: 2026-09-06
  status: approved
  version: 1


- id: agent-tool-troubleshooting
  name: 工具/会话能力排障
  category: platform
  scope: tool-troubleshooting
  source: skills/agent-tool-troubleshooting/SKILL.md
  skill: skills/agent-tool-troubleshooting/SKILL.md
  trigger: 当前会话没有 shell / bash 不可用 / 工具缺失
  conflicts: []
  verification:
    - file-exists: skills/agent-tool-troubleshooting/SKILL.md
    - content-contains:
        file: skills/agent-tool-troubleshooting/SKILL.md
        text: "standard"
  lastVerified: 2026-09-06
  status: approved
  version: 1

- id: main-agent-auto-iteration-execution
  name: 主 agent 自动版本迭代执行能力（协议 v1.8→v1.9 考古沉淀）
  category: workflow
  scope: auto-iteration-execution
  source: docs/main-agent-auto-iteration-capabilities.md
  skill: skills/dsh-web-relay-main-agent/SKILL.md
  trigger: 自动迭代 N 个版本的执行阶段（实施/回写/提审/发布/收口）
  conflicts:
    - manual-development
  verification:
    - file-exists: docs/main-agent-auto-iteration-capabilities.md
    - content-contains:
        file: docs/main-agent-auto-iteration-capabilities.md
        text: "能力清单"
    - file-exists: skills/dsh-web-relay-main-agent/SKILL.md
  lastVerified: 2026-09-06
  status: approved
  version: 1

- id: v3-shadow-sandbox
  name: 影子试错沙盒（V3.0 机制）
  category: project
  scope: high-risk-execution
  source: docs/main-agent-auto-iteration-capabilities.md
  skill: null
  trigger: 高风险/重构改动需要隔离验证或回滚基线时（/shadow create/merge/destroy）
  conflicts: []
  verification:
    - file-exists: docs/main-agent-auto-iteration-capabilities.md
    - content-contains:
        file: docs/main-agent-auto-iteration-capabilities.md
        text: "影子试错沙盒（Shadow Trial Sandbox）"
  lastVerified: 2026-09-06
  status: approved
  version: 1

- id: v3-prompt-case-library
  name: Prompt 自主进化案例库（V3.1 机制）
  category: project
  scope: review-reflection
  source: docs/main-agent-auto-iteration-capabilities.md
  skill: null
  trigger: finalize 收口 / 审核 Prompt 需注入历史打回案例（Top-K≤3）
  conflicts: []
  verification:
    - file-exists: docs/main-agent-auto-iteration-capabilities.md
    - content-contains:
        file: docs/main-agent-auto-iteration-capabilities.md
        text: "Prompt 自主进化案例库（Prompt-case-library，轻量反思）"
  lastVerified: 2026-09-06
  status: approved
  version: 1

- id: v3-swarm-review
  name: Swarm 双角色盲审（V3.2 机制）
  category: project
  scope: review-upgrade
  source: docs/main-agent-auto-iteration-capabilities.md
  skill: null
  trigger: importance:high 步骤需要 Security-Auditor + Refactoring-Architect 双角色盲审
  conflicts: []
  verification:
    - file-exists: docs/main-agent-auto-iteration-capabilities.md
    - content-contains:
        file: docs/main-agent-auto-iteration-capabilities.md
        text: "Swarm 双角色盲审（Security-Auditor + Refactoring-Architect）"
  lastVerified: 2026-09-06
  status: approved
  version: 1

- id: architect-breakthrough-gate
  name: Architect 突破度三阶评估（协议机制）
  category: project
  scope: planning-gate
  source: docs/main-agent-auto-iteration-capabilities.md
  skill: null
  trigger: planning/restructure 需要突破度（Incremental/Structural/Paradigm）校验
  conflicts: []
  verification:
    - file-exists: docs/main-agent-auto-iteration-capabilities.md
    - content-contains:
        file: docs/main-agent-auto-iteration-capabilities.md
        text: "Architect 突破度三阶评估（Incremental/Structural/Paradigm）"
  lastVerified: 2026-09-06
  status: approved
  version: 1

- id: v3-external-channels
  name: 外部 AI 通道接入机制（web-gemini 栈 + Claude API）
  category: project
  scope: channel-integration
  source: docs/main-agent-auto-iteration-capabilities.md
  skill: null
  trigger: 接入/维护外部 AI 通道、通道故障排障、reviewChannel 配置
  conflicts: []
  verification:
    - file-exists: docs/main-agent-auto-iteration-capabilities.md
    - content-contains:
        file: docs/main-agent-auto-iteration-capabilities.md
        text: "web-gemini 通道栈（Web-Gemini Channel Stack）"
    - content-contains:
        file: docs/main-agent-auto-iteration-capabilities.md
        text: "Claude API 通道"
  lastVerified: 2026-09-06
  status: approved
  version: 1

- id: v3-replay-notify-console
  name: 回放/通知/通道治理机制（Trace Replay + Webhook + reviewChannel + 截断治理）
  category: project
  scope: observability-notify
  source: docs/main-agent-auto-iteration-capabilities.md
  skill: null
  trigger: 离线还原轨迹、熔断/降级/打回通知、审核通道选择、防盲审治理
  conflicts: []
  verification:
    - file-exists: docs/main-agent-auto-iteration-capabilities.md
    - content-contains:
        file: docs/main-agent-auto-iteration-capabilities.md
        text: "Trace Replay 离线沙盒"
    - content-contains:
        file: docs/main-agent-auto-iteration-capabilities.md
        text: "reviewChannel 通道选择器"
  lastVerified: 2026-09-06
  status: approved
  version: 1

- id: v4-host-restart-resume
  name: 宿主重启续跑机制（cross-restart resume + watchdog 托管运维）
  category: platform
  scope: host-ops-resume
  source: docs/OPS-RESTART-RESUME.md
  skill: null
  trigger: 宿主重启后任务续跑检测/唤醒/熔断、watchdog 托管排障、/admin/resume-scan 手动触发
  conflicts: []
  verification:
    - file-exists: docs/OPS-RESTART-RESUME.md
    - content-contains:
        file: docs/OPS-RESTART-RESUME.md
        text: "bootId"
    - content-contains:
        file: docs/OPS-RESTART-RESUME.md
        text: "重启续跑熔断"
    - file-exists: docs/AUTO-ITERATION-ANALYSIS.md
  lastVerified: 2026-09-06
  status: approved
  version: 1

- id: v4-autonomous-autoiteration-validation
  name: 完全自主三方协作 AutoIteration 实证（面板化 + 运维 SOP + 效果分析）
  category: workflow
  scope: autonomous-iteration-validation
  source: docs/AUTO-ITERATION-ANALYSIS.md
  skill: null
  trigger: 复盘自主迭代效果、自主协作摩擦点、AutoIteration 版间门推进验证
  conflicts: []
  verification:
    - file-exists: docs/AUTO-ITERATION-ANALYSIS.md
    - content-contains:
        file: docs/AUTO-ITERATION-ANALYSIS.md
        text: "版间门"
    - content-contains:
        file: docs/AUTO-ITERATION-ANALYSIS.md
        text: "重启账目"
    - file-exists: docs/OPS-RESTART-RESUME.md
  lastVerified: 2026-09-06
  status: approved
  version: 1

- id: cc-hybrid-claude-code
  name: Claude Code 混合架构（WSL 订阅 headless 实现/审方 + 降级 + 协议化 v2.0）
  category: platform
  scope: hybrid-execution
  source: docs/CC-HYBRID.md
  skill: null
  trigger: 混合架构派发实现/审方任务给 Claude Code（D:\cc-tasks 目录契约 + runner/cc-watchdog）、cc 不可用降级回主 agent 单一架构、审核降级链 claude-code 通道排障
  conflicts: []
  verification:
    - file-exists: docs/CC-HYBRID.md
    - content-contains:
        file: docs/CC-HYBRID.md
        text: "降级策略"
    - content-contains:
        file: docs/CC-HYBRID.md
        text: "refs 共享引用污染"
    - content-contains:
        file: docs/CC-HYBRID.md
        text: "混合架构特性演进验收协议"
    - content-contains:
        file: docs/CC-HYBRID.md
        text: "v4.9 协议化"
    - file-exists: lib/cc-task-schema.mjs
    - file-exists: lib/cc-channel.js
  lastVerified: 2026-09-07
  status: approved
  version: 2

- id: protocol-v2-evolution
  name: 协议 v2.0 演进（claude-code 降级链 + alternatives 裁决 + 并发审核批）
  category: project
  scope: protocol-evolution
  source: lib/index.js
  skill: null
  trigger: v4.9+ 协议语义查询/实现（审核降级链 v2.0 顺序、alternatives 裁决端点、batchStepIds 并发语义、429 退避、审核上下文 tailClip 尾部截断）
  conflicts: []
  verification:
    - file-exists: lib/cc-channel.js
    - file-exists: lib/alternatives-compare.js
    - content-contains:
        file: lib/index.js
        text: "全角色降级链 v2.0"
    - content-contains:
        file: lib/index.js
        text: "alternatives 裁决管道（v2.0"
    - content-contains:
        file: lib/index.js
        text: "批量并发审核 v2.0"
    - content-contains:
        file: lib/index.js
        text: "tailClip"
    - file-exists: test/cc-channel.test.js
    - file-exists: test/alternatives-compare.test.js
  lastVerified: 2026-09-07
  status: approved
  version: 2

- id: cc-task-schema-v2
  name: cc-task-schema v2 任务契约严格校验（validateTask/validateResult + CLI + 三重门控 + watchdog 恢复）
  category: tool
  scope: cc-task-contract
  source: docs/task-schema-v2.md
  skill: null
  trigger: 派发 Claude Code 任务（task.json 契约）、校验 cc 任务产物（done.flag 根/result.json/review.md）、watchdog/runner 侧门控排障、REJECT 隔离复检（.invalid/）、watchdog 崩溃重启恢复、v2 校验结果可视化（POST /steps/v2-check）
  conflicts: []
  verification:
    - file-exists: docs/task-schema-v2.md
    - content-contains:
        file: docs/task-schema-v2.md
        text: "watchdog 崩溃/重启恢复"
    - content-contains:
        file: docs/task-schema-v2.md
        text: "REJECT 隔离复检闭环"
    - file-exists: lib/task-schema-v2.mjs
    - content-contains:
        file: lib/task-schema-v2.mjs
        text: "classifyTaskRecovery"
    - file-exists: scripts/task-schema-cli.mjs
    - content-contains:
        file: lib/cc-channel.js
        text: "outputDir"
    - file-exists: test/task-schema-v2.test.mjs
    - file-exists: test/cc-recovery.test.mjs
    - content-contains:
        file: docs/main-agent-lessons.json
        text: "L-2026-0909-038"
  lastVerified: 2026-09-09
  status: approved
  version: 1

- id: host-self-restart-resume
  name: 无介入重启续跑与回合闭环（kill 后台 job + 同步 probe 查盘 + sessionId 自动唤醒 + 心跳兜底 + 回合自检纪律）
  category: platform
  scope: host-ops-resume
  source: bin/watchdog.mjs
  skill: skills/dsh-web-relay-main-agent/SKILL.md
  trigger: 主 agent 需重启宿主（有常驻 watchdog → kill-host 后台 job；无常驻 → restart-now）、重启后续跑自检（/health-check bootId+resumed）、无介入续跑（expr 落盘 DSH_SESSION_ID → 自动注入唤醒）、回合结束自检（禁止预告式结尾）、审核上下文 tailClip 截断注意
  conflicts: []
  verification:
    - file-exists: bin/watchdog.mjs
    - content-contains:
        file: bin/watchdog.mjs
        text: "kill-host"
    - content-contains:
        file: skills/dsh-web-relay-main-agent/SKILL.md
        text: "宿主重启与续跑自检"
    - content-contains:
        file: skills/dsh-web-relay-main-agent/SKILL.md
        text: "037 修正"
    - content-contains:
        file: docs/OPS-RESTART-RESUME.md
        text: "bootId"
    - content-contains:
        file: docs/main-agent-runbook-v0.1.md
        text: "重启/续跑/回合闭环纪律"
    - content-contains:
        file: docs/main-agent-lessons.json
        text: "L-2026-0907-037"
    - content-contains:
        file: bin/watchdog.mjs
        text: "request-restart"
    - content-contains:
        file: skills/dsh-web-relay-main-agent/SKILL.md
        text: "request-restart"
    - content-contains:
        file: docs/main-agent-lessons.json
        text: "L-2026-0910-043"
  lastVerified: 2026-09-07
  status: approved
  version: 2

- id: hybrid-default-controls
  name: 混合架构默认化治理（场景路由分流 + 降级率审计 + 双通道交叉校验）
  category: workflow
  scope: hybrid-default-policy
  source: docs/CC-HYBRID.md
  skill: null
  trigger: 判断某类任务该不该派给 Claude Code（混合架构条件默认）、审核是否被静默降级、importance=high 步骤是否需要两条外部通道交叉校验
  conflicts: []
  verification:
    - content-contains:
        file: docs/CC-HYBRID.md
        text: "默认化判定规则"
    - file-exists: lib/triage-route.js
    - content-contains:
        file: lib/triage-route.js
        text: "decideHybridRoute"
    - file-exists: lib/review-audit.js
    - content-contains:
        file: lib/review-audit.js
        text: "auditReviewSources"
    - file-exists: lib/cross-check.js
    - content-contains:
        file: lib/cross-check.js
        text: "crossCheckVerdicts"
    - file-exists: test/triage-route.test.js
    - file-exists: test/review-audit.test.js
    - file-exists: test/cross-check.test.js
    - content-contains:
        file: docs/main-agent-lessons.json
        text: "L-2026-0910-042"
  lastVerified: 2026-09-10
  status: approved
  version: 1

- id: harness-line-compatibility
  name: dsh 版本线兼容矩阵（本插件可用 dsh 版本的单一事实来源）
  category: platform
  scope: harness-compat
  source: docs/COMPATIBILITY.md
  skill: null
  trigger: 升级/切换 dsh 版本前确认插件可用性；boot 出现 "did not activate" / "waiting for service: apiProxy"；判断该回 rc.7 还是给新线装 dsh-apiproxy-shim
  conflicts: []
  verification:
    - file-exists: docs/COMPATIBILITY.md
    - content-contains:
        file: docs/COMPATIBILITY.md
        text: "兼容矩阵"
    - content-contains:
        file: docs/COMPATIBILITY.md
        text: "0.1.5+"
    - content-contains:
        file: docs/COMPATIBILITY.md
        text: "apiProxyAvailable"
    - content-contains:
        file: package.json
        text: harnessLine
    - content-contains:
        file: lib/index.js
        text: "docs/COMPATIBILITY.md"
  lastVerified: 2026-09-13
  status: approved
  version: 1