@winspan/claude-forge 9.2.0 → 9.12.0

package/DEVELOPMENT.md

@@ -24,13 +24,17 @@ src/
 │   │   ├── base.ts / rows.ts     连接 + 行映射工具
 │   │   ├── maintenance.ts        清理/压缩
 │   │   └── performance-indexes.sql  附加索引
-│   ├── ai/                     ClaudeProvider 封装（用于 classifier、distiller、skill-upgrade）
 │   ├── queue/                  通用 SQLite 队列工具
-│   ├── utils/                  logger / git / path / time / lru-cache / forge-resume-block 等
+│   ├── diagnostics/            自检 / 健康诊断工具
+│   ├── governance/            治理协议注入（inject-global 等）
+│   ├── utils/                  logger / git / path / time / lru-cache / forge-resume-block /
+│   │                            claude-cli-spawn（headless `claude` 子进程）等
 │   ├── config.ts               ConfigManager（~/.claude-forge/config.yaml）
 │   ├── constants.ts            FORGE_PATHS、各类阈值常量
 │   ├── event-fields.ts         hook 事件字段统一抽取
 │   └── types.ts                ForgeEvent / HookResult 等核心类型契约
+│   （注：曾经的 core/ai/ ClaudeProvider 目录已整组删除，spec 0902 起所有 LLM
+│    调用收敛为 `child_process.spawn('claude', ...)` headless 子进程）
 │
 ├── daemon/                     后台守护进程
 │   ├── index.ts                  入口：socket server + 生命周期 + 同步任务
@@ -40,15 +44,37 @@ src/
 │   ├── event-parser.ts           hook 原始 JSON → ForgeEvent
 │   ├── hook-sync.ts              启动时把 dist/hooks/ 同步到 ~/.claude/hooks/
 │   ├── skill-sync.ts             启动时把 dist/skills/distilled/ 同步到 ~/.claude/skills/
+│   ├── agent-sync.ts             启动时把 templates/agents/ 同步到 ~/.claude/agents/
+│   ├── config-store.ts           daemon 运行期配置缓存
 │   ├── launchd-installer.ts      macOS launchd 安装
 │   ├── launchd/                  launchd plist 模板
-│   ├── handlers/
-│   │   ├── user-prompt.ts          UserPromptSubmit：分类 + skill 推荐 + agent 路由
+│   ├── templates/agents/         canonical agent .md 源（build → dist，sync → ~/.claude/agents/）
+│   ├── handlers/                 （5 个 hook handler）
+│   │   ├── user-prompt.ts          UserPromptSubmit：分类 + skill 推荐 + agent 路由 + KB 注入
+│   │   ├── pre-tool-use.ts         PreToolUse：规则引擎，按 tool_intercept 规则 deny/warn/allow
 │   │   ├── post-tool-use.ts        PostToolUse：观察，按需注入提示
 │   │   ├── stop.ts                 Stop：写 session 摘要、distill 决策
 │   │   └── history-exporter.ts     导出完整历史到 .claude-forge/history/
-│   └── services/
-│       └── task-segmenter.ts       UserPromptSubmit 按时间窗划分任务段
+│   ├── rules/                    （5 个，PreToolUse 规则引擎）
+│   │   ├── defaults.ts             默认 tool_intercept 规则（edit/write-multi-file-hard 等 deny）
+│   │   ├── registry.ts             规则注册与首个匹配查找
+│   │   ├── workflow-defaults.ts    workflow 推荐 / Task spawn 匹配规则
+│   │   ├── whitelist.ts            白名单 / 项目级关闭
+│   │   └── types.ts                ToolInterceptRule / RuleContext 类型
+│   └── services/                 （约 20 个后台服务）
+│       ├── spec-gate.ts            SpecGate：spec/decision 批准短路
+│       ├── spec-approval.ts        bare「批准 / approve <token>」批准解析
+│       ├── context-injector.ts     上下文注入
+│       ├── kb-injector.ts          知识库注入
+│       ├── task-segmenter.ts       UserPromptSubmit 按时间窗划分任务段
+│       ├── task-boundary-classifier.ts  任务边界分类
+│       ├── violation-reporter.ts   主线程合规违规汇总
+│       ├── decision-hint.ts        [DECISION HINT] mint
+│       ├── outcome-classifier.ts / outcome-classification-service.ts / outcome-nudge.ts  决策结果回填
+│       ├── experience-extractor.ts / feedback-aggregator.ts  经验/反馈聚合
+│       ├── intercept-revive.ts / intercept-rollback-guard.ts / intercept-timeout-sweeper.ts  拦截治理
+│       ├── idle-session-sweeper.ts / idle-task-budget.ts / event-ttl-sweep.ts  GC / 预算
+│       └── heartbeat-writer.ts     心跳写盘
 │
 ├── skills/                     Skill 推荐与方法论分发
 │   ├── registry.ts               扫描 ~/.claude/skills/ + src/skills/distilled/，提供 match()（keyword-only since spec 0902 D R-B）
@@ -62,15 +88,22 @@ src/
 ├── web/                        Web 管理后台
 │   ├── server.ts                 Express 服务器 + 路由注册
 │   ├── auth-middleware.ts        本地 token 校验
-│   ├── ssrf-guard.ts             SSRF 防护
-│   ├── routes/                   每个 API 模块独立文件（sessions / events / tasks / skills / ai / patch ...）
+│   ├── routes/                   每个 API 模块独立文件（sessions / events / tasks / skills /
+│   │                            decisions / knowledge / patch / health / diagnostics / drift /
+│   │                            insights / pipeline / reports / rules / trace / violations ...）
 │   ├── analytics/                趋势/统计计算
+│   ├── services/                 路由共享服务层
 │   └── static/                   React 前端构建产物的最终落点（dist/web/static/）
+│   （注：曾经的 ssrf-guard.ts 与 routes/ai.ts 已删除）
 │
 ├── cli/
 │   ├── index.ts                  CLI 入口（commander）
 │   ├── init/                     `cf init`：安装 hook 脚本
-│   └── commands/                 子命令：daemon / config / skills / claudemd / status / logs / stats / menu / trace / mcp / executions / template
+│   └── commands/                 27 个子命令：daemon / config / skills / claudemd / status /
+│                                 logs / stats / menu / trace / mcp / executions / template /
+│                                 init / decisions / governance / knowledge / spec / doctor /
+│                                 fix / entropy / agents / bypass / insights / insights-goal-check /
+│                                 project / admin / violations
 │
 ├── claudemd/                   CLAUDE.md 生成与维护
 │   ├── tech-detector.ts          项目技术栈识别
@@ -92,13 +125,22 @@ src/
 ├── mcp/                        MCP server（暴露 skill_invoke / skill_list / pipeline_suggest 给 agent）
 │   └── server.ts
 │
-├── knowledge/                  v9.0 项目知识库系统
+├── knowledge/                  项目知识库系统（27 src）
+│   ├── builder.ts                KB page 构建（分析 src/ → .forge-knowledge/，每 page 一次 claude spawn）
+│   ├── cli-provider.ts           CliKnowledgeProvider：经 claude-cli-spawn headless 生成 KB
 │   ├── repo-map.ts               仓库结构快照生成
-│   ├── builder.ts                知识条目构建（分析 src/ → .forge-knowledge/）
-│   ├── query.ts                  语义/关键词查询接口
+│   ├── module-hash.ts            模块内容 hash（增量 rebuild 判定）
+│   ├── cross-module.ts           跨模块 page 生成
+│   ├── query.ts                  关键词查询接口
+│   ├── audit-applier.ts          KB 审计修订应用
+│   ├── project-detector.ts       项目类型探测（选择 adapter）
 │   ├── git-hooks.ts              Git hooks 集成（commit 后自动 rebuild）
 │   ├── validator.ts              KB 完整性校验
-│   └── prompt.ts                 agent prompt 注入工具
+│   ├── prompt.ts                 agent prompt 注入工具
+│   ├── constants.ts / types.ts   路径常量 + 类型
+│   ├── adapters/                 多语言项目适配器（typescript / js-vue / python / go /
+│   │                            java / kotlin / rust / monorepo）
+│   └── tools/                    MCP 工具：knowledge-query / knowledge-get-page / repo-map-lookup
 │
 └── templates/                  新项目初始化模板
 
@@ -149,7 +191,7 @@ npm run dev:daemon:stop
 cd web && npm install && npm run dev
 ```
 
-Daemon / CLI 都用系统 node（项目要求 Node 18+，实际跑在 24/26 上）。
+Daemon / CLI 都用系统 node（项目要求 Node 24+，实际跑在 24/26 上）。
 
 ---
 
@@ -193,9 +235,10 @@ Claude Code  ──hook payload(JSON via stdin)──►  src/hooks/*.sh
                                                       │
                                                       ▼
                               src/daemon/router.ts ──┬──► handlers/user-prompt.ts
+                                                     ├──► handlers/pre-tool-use.ts (规则引擎 deny/warn/allow)
                                                      ├──► handlers/post-tool-use.ts
                                                      ├──► handlers/stop.ts
-                                                     └──► (PreToolUse / Notification: 直接 allow)
+                                                     └──► (Notification: 直接 allow)
                                                       │
                                                       ▼
                               core/storage/* 持久化 + 返回 HookResult
@@ -207,7 +250,12 @@ Claude Code  ──hook payload(JSON via stdin)──►  src/hooks/*.sh
 要点：
 - daemon 必须在 100ms 内返回，超时则 Claude Code 视为放行
 - handler 抛错被 router 捕获，不会让 daemon 崩溃
-- `PreToolUse` 当前不做规则阻断，统一放行
+- `PreToolUse` **做规则阻断**：`handlers/pre-tool-use.ts` 跑 `rules/registry.ts`
+  规则引擎，命中 `rules/defaults.ts` 的 `tool_intercept` 规则（如
+  `edit-multi-file-hard` / `write-multi-file-hard` / `bash-grep-multi-file`）时
+  decision=`deny`（allow=false + hookSpecificOutput），warn 规则注入
+  additionalContext。每次决策落 `tool_intercepts` 表（事实表，写失败不阻断 tool）。
+  显式 bypass 标记（`forge:bypass=<reason>`）转 decision=`bypass` 放行
 - daemon 不主动推消息：任何延后的指令必须等下一次 UserPromptSubmit 注入
 
 ### Skill 系统
@@ -333,7 +381,7 @@ hook event ──► writeEvent()            ──┐
 - Schema 由 `src/core/storage/schema.sql` 初始化
 - 增量改动放 `src/core/storage/migrations/*.sql`（按文件名顺序执行）
 
-### 长跑稳定性（v8.53.6 加）
+### 长跑稳定性
 
 daemon 通过三个机制保证长时间运行不膨胀：
 
@@ -409,8 +457,8 @@ spawn general-purpose agent with prompt:
 ### decision-maker catalog 预生成
 
 Build 时 `scripts/dump-catalogs.ts` 会生成：
-- `dist/catalogs/agents.json` — 9 agents, ~3KB
-- `dist/catalogs/skills.json` — 12 skills, ~5KB
+- `dist/catalogs/agents.json` — 14 agents, ~3KB
+- `dist/catalogs/skills.json` — skills catalog, ~5KB
 
 这两个文件由 decision-maker Step 2-3 读取（`cat dist/catalogs/*.json`），
 替代原来的全读 3250 行 markdown，可减少 ~90% catalog token 消耗。
@@ -419,6 +467,19 @@ Build 时 `scripts/dump-catalogs.ts` 会生成：
 
 ---
 
+## task-boundary-classifier agent 使用说明
+
+`task-boundary-classifier` agent 定义在 `.claude/agents/task-boundary-classifier.md`
+（canonical 在 `src/daemon/templates/agents/`，agent-sync 启动时镜像到
+`~/.claude/agents/`）。它判断一段连续操作是否构成同一任务边界，供
+`src/daemon/services/task-boundary-classifier.ts` 在任务分段时调用。
+
+与其它 agent 一致：程序化调用走 `child_process.spawn('claude', ...)` headless
+子进程（不受 TUI restart 影响）；TUI 内手动 `subagent_type='task-boundary-classifier'`
+spawn 首次需 TUI restart（macOS Cmd+R）。
+
+---
+
 ## skill-distiller agent 使用说明
 
 `skill-distiller` agent 定义在 `.claude/agents/skill-distiller.md`（与

package/README.md

@@ -4,7 +4,7 @@
 
 Claude Forge 是一个在本地运行的守护进程，通过 Claude Code 的 Hook API 拦截 `UserPromptSubmit`、`PreToolUse`、`PostToolUse`、`Stop` 等事件，在其中做意图分类、Agent 路由、Skill 推荐、规则阻断、治理建议。
 
-**版本**: 见 `cf --version` · **Node**: >= 18 · **License**: MIT
+**版本**: 见 `cf --version` · **Node**: >= 18（实际跑 24/26）· **License**: MIT
 
 ---
 
@@ -77,13 +77,20 @@ open docs/architecture/diagrams/overview.drawio  # macOS 用 drawio desktop / we
 | 命令 | 说明 |
 |---|---|
 | `cf init` | 初始化 hook 脚本到 `~/.claude/hooks/` |
-| `cf daemon {start,stop,status}` | daemon 生命周期 |
+| `cf daemon {start,stop,status,restart}` | daemon 生命周期 |
+| `cf daemon {install,uninstall}` | 安装/卸载 macOS LaunchAgent（崩溃 auto-restart）|
+| `cf daemon ensure-running` | 心跳过期或 PID 死亡时强制重启 |
+| `cf daemon logs [--tail]` | 查看 daemon 日志 |
 | `cf config {show,path,edit,list,get,set}` | 配置管理 — runtime feature flags (forge_config 表) + YAML view/edit。**`ai.*` / `skill_matching.*` 字段已在 spec [`0902`](docs/design/2026-05-29/0902-ai-config-removal-master-spec.md) 子 spec D R-D 从 schema 中彻底删除**（AI 流程改走 `claude` CLI 子进程，不再读 `ANTHROPIC_API_KEY`）；老 `~/.claude-forge/config.yaml` 中的残留 `ai:` / `skill_matching:` 会被静默丢弃，daemon 启动时 warn 一次提示用户清理 |
 | `cf status` | 当前 daemon + Web + 存储概况 |
 | `cf logs [--tail]` | 查看 daemon 日志 |
 | `cf stats` | 近期 intent / 路由统计 |
-| `cf rules` | 查看/编辑治理规则（YAML） |
 | `cf agents` | 列出已注册 agent |
+| `cf decisions {register,update,outcome,...}` | 决策治理：注册 spec / 回填 options / 闭环 outcome（C1 统一批准子系统）|
+| `cf governance inject-global` | 把决策治理协议写入 `~/.claude/CLAUDE.md`（`--remove` 撤销）|
+| `cf spec register` | 注册 spec 文件等待批准（`cf decisions register` 的 thin alias）|
+| `cf doctor` | 环境/配置健康自检 |
+| `cf fix` | 一键修复常见环境/配置问题 |
 | `cf skills list` | 列出所有 skill（内置 + 用户层） |
 | `cf skills invoke <id>` | 调用指定 skill 并打印方法论 |
 | `cf skills sync` | 同步内置 skill 到 `~/.claude/skills/` |
@@ -92,7 +99,7 @@ open docs/architecture/diagrams/overview.drawio  # macOS 用 drawio desktop / we
 | `cf executions {list,show}` | 浏览历史执行记录 |
 | `cf mcp` | MCP 配置 |
 | `cf claudemd` | 生成/更新项目 CLAUDE.md（通过 `claude` CLI 子进程 + `claudemd-writer` agent，**不再读 `ANTHROPIC_API_KEY`**） |
-| `cf knowledge {init,build,update,query,list,audit,clean,rollback}` (alias: `cf kb`) | 项目知识库（`.forge-knowledge/`）。`init` / `build` / `update` 通过 `claude` CLI 子进程 + `knowledge-builder` agent，**不再读 `ANTHROPIC_API_KEY`**；query / list / audit / clean / rollback 纯本地 |
+| `cf knowledge {init,build,update,query,list,audit,clean,rollback,fix}` (alias: `cf kb`) | 项目知识库（`.forge-knowledge/`）。`init` / `build` / `update` / `fix` 通过 `claude` CLI 子进程 + `knowledge-builder` agent，**不再读 `ANTHROPIC_API_KEY`**；`fix` 是一次性维护入口（修补陈旧/缺失 KB page）；query / list / audit / clean / rollback 纯本地 |
 | `cf template` | 模板管理 |
 | `cf menu` | 交互式菜单（推荐入口） |
 
@@ -259,9 +266,9 @@ keychain，daemon 自身不持 API key。
 
 | 模块 | 一句话职责 |
 |---|---|
-| `src/core/` | 共享内核：SQLite 存储、AI provider、配置、类型契约 |
+| `src/core/` | 共享内核：SQLite 存储、配置、类型契约 |
 | `src/daemon/` | 守护进程：Unix socket server + hook 事件分发 + 服务编排 |
-| `src/skills/` | Skill 系统：内置 18 个 + 用户层 + AI 辅助升级 |
+| `src/skills/` | Skill 系统：内置 12 个 distilled + 用户层 + AI 辅助升级 |
 | `src/web/` | Express + SSE 后端 + React 仪表盘 |
 | `src/cli/` | claude-forge / cf 命令入口 |
 | `src/hooks/` | bash 脚本，与 daemon 通过 Unix socket 通信 |

package/dist/catalogs/agents.json

@@ -1,72 +1,67 @@
 [
+  {
+    "name": "agent-retro-distiller",
+    "description": "",
+    "source_file": "src/daemon/templates/agents/agent-retro-distiller.md"
+  },
   {
     "name": "claudemd-writer",
     "description": "",
-    "source_file": ".claude/agents/claudemd-writer.md"
+    "source_file": "src/daemon/templates/agents/claudemd-writer.md"
   },
   {
     "name": "coder",
     "description": "Standard BMAD implementation agent for spec-driven work in well-tested modules. Use when a spec exists at docs/design/**/*-spec.md AND the target module has >=50% test coverage (or is a brand new modu",
-    "source_file": ".claude/agents/coder.md"
+    "source_file": "src/daemon/templates/agents/coder.md"
   },
   {
     "name": "decision-maker",
     "description": "Lightweight decision agent for prompts the daemon flagged as decision-worthy. NOT a planner (no implementation plan) — produces a 1-page decision document covering Options + Recommendation + Open Ques",
-    "source_file": ".claude/agents/decision-maker.md"
+    "source_file": "src/daemon/templates/agents/decision-maker.md"
   },
   {
     "name": "doc-reviewer",
     "description": "Read-only code, spec, or document analysis. Returns a structured report. Use when user asks to review/analyze/compare/audit existing code or docs WITHOUT modifying anything. Triggers on \"review this\",",
-    "source_file": ".claude/agents/doc-reviewer.md"
+    "source_file": "src/daemon/templates/agents/doc-reviewer.md"
   },
   {
     "name": "harness-debug-full",
     "description": "Unknown or intermittent bug — reproduce, then find root cause, then fix, then verify. Use when symptoms are described but root cause is NOT known, or when behavior is intermittent / random / flaky / \"",
-    "source_file": ".claude/agents/harness-debug-full.md"
-  },
-  {
-    "name": "harness-hotfix",
-    "description": "Known-cause bug fixer with safety-net discipline. Use when the root cause of a bug is already identified AND the affected module has <50% test coverage. Triggers on \"修复 X bug\", \"hotfix\", \"urgent fix\",",
-    "source_file": ".claude/agents/harness-hotfix.md"
-  },
-  {
-    "name": "hybrid-feature-with-safety",
-    "description": "New feature that touches legacy low-coverage code. Use when adding new functionality that requires modifying files in modules with <50% test coverage. Triggers on \"新功能 + 改老代码\", \"add X to legacy module",
-    "source_file": ".claude/agents/hybrid-feature-with-safety.md"
+    "source_file": "src/daemon/templates/agents/harness-debug-full.md"
   },
   {
     "name": "knowledge-builder",
     "description": "",
-    "source_file": ".claude/agents/knowledge-builder.md"
+    "source_file": "src/daemon/templates/agents/knowledge-builder.md"
   },
   {
     "name": "patch-applier",
     "description": "",
-    "source_file": ".claude/agents/patch-applier.md"
+    "source_file": "src/daemon/templates/agents/patch-applier.md"
   },
   {
     "name": "planner",
     "description": "Spec writer for non-trivial work. Research current state, propose 2-3 options, recommend one, write spec to docs/design/, then STOP. Use for BMAD Phase 1. Triggers on \"write a spec\", \"plan this\", \"BMA",
-    "source_file": ".claude/agents/planner.md"
+    "source_file": "src/daemon/templates/agents/planner.md"
   },
   {
-    "name": "refactor-specialist",
-    "description": "Behavior-preserving restructure of low-coverage code. Use when user asks to refactor, restructure, clean up, simplify, or extract from a module with <50% test coverage. Triggers on \"重构\", \"refactor\", \"",
-    "source_file": ".claude/agents/refactor-specialist.md"
+    "name": "safety-net-implementer",
+    "description": "Safety-net implementation agent for low-coverage (<50%) modules — replaces harness-hotfix / refactor-specialist / hybrid-feature-with-safety. Three modes, one discipline. mode=hotfix for known-cause b",
+    "source_file": "src/daemon/templates/agents/safety-net-implementer.md"
   },
   {
     "name": "skill-distiller",
     "description": "",
-    "source_file": ".claude/agents/skill-distiller.md"
+    "source_file": "src/daemon/templates/agents/skill-distiller.md"
   },
   {
     "name": "task-boundary-classifier",
     "description": "",
-    "source_file": ".claude/agents/task-boundary-classifier.md"
+    "source_file": "src/daemon/templates/agents/task-boundary-classifier.md"
   },
   {
     "name": "verify-agent",
     "description": "Live runtime verifier. Runs the actual app/CLI/browser, drives the changed surface, probes edges, returns PASS/FAIL/BLOCKED/SKIP with evidence. Use after implementation and before commit. Triggers on ",
-    "source_file": ".claude/agents/verify-agent.md"
+    "source_file": "src/daemon/templates/agents/verify-agent.md"
   }
 ]

package/dist/catalogs/skills.json

@@ -10,7 +10,11 @@
       "api 设计",
       "restful",
       "openapi",
-      "接口设计"
+      "接口设计",
+      "rest api",
+      "web api",
+      "http api",
+      "endpoint"
     ]
   },
   {
@@ -28,13 +32,51 @@
       "技术选型"
     ]
   },
+  {
+    "name": "distilled-brainstorming",
+    "description": "Distilled IT-universal skill: brainstorming (score 3.5/5)",
+    "source_file": "src/skills/distilled/distilled-brainstorming.md",
+    "keywords": [
+      "brainstorming"
+    ]
+  },
+  {
+    "name": "distilled-brand-guidelines",
+    "description": "Distilled IT-universal skill: brand-guidelines (score 3/5)",
+    "source_file": "src/skills/distilled/distilled-brand-guidelines.md",
+    "keywords": [
+      "brand",
+      "guidelines"
+    ]
+  },
+  {
+    "name": "distilled-canvas-design",
+    "description": "Distilled IT-universal skill: canvas-design (score 3.5/5)",
+    "source_file": "src/skills/distilled/distilled-canvas-design.md",
+    "keywords": [
+      "canvas",
+      "design"
+    ]
+  },
+  {
+    "name": "distilled-claude-api",
+    "description": "Distilled IT-universal skill: claude-api (score 4/5)",
+    "source_file": "src/skills/distilled/distilled-claude-api.md",
+    "keywords": [
+      "claude",
+      "api"
+    ]
+  },
   {
     "name": "distilled-creator",
     "description": "Distilled IT-universal skill: skill-creator (score 3.5/5)",
     "source_file": "src/skills/distilled/distilled-creator.md",
     "keywords": [
-      "creator",
-      "skill"
+      "skill creation",
+      "create skill",
+      "创建技能",
+      "skill development",
+      "distill skill"
     ]
   },
   {
@@ -53,24 +95,60 @@
     ]
   },
   {
-    "name": "distilled-defi-amm-security",
-    "description": "Distilled IT-universal skill: defi-amm-security (score 3.5/5)",
-    "source_file": "src/skills/distilled/distilled-defi-amm-security.md",
+    "name": "distilled-dispatching-parallel-agents",
+    "description": "Distilled IT-universal skill: dispatching-parallel-agents (score 3.5/5)",
+    "source_file": "src/skills/distilled/distilled-dispatching-parallel-agents.md",
+    "keywords": [
+      "dispatching",
+      "parallel",
+      "agents"
+    ]
+  },
+  {
+    "name": "distilled-doc-coauthoring",
+    "description": "Distilled IT-universal skill: doc-coauthoring (score 4.5/5)",
+    "source_file": "src/skills/distilled/distilled-doc-coauthoring.md",
     "keywords": [
-      "defi",
-      "amm",
-      "security"
+      "doc",
+      "coauthoring"
+    ]
+  },
+  {
+    "name": "distilled-docx",
+    "description": "Distilled IT-universal skill: docx (score 3/5)",
+    "source_file": "src/skills/distilled/distilled-docx.md",
+    "keywords": [
+      "docx"
     ]
   },
   {
     "name": "distilled-executing-plans",
-    "description": "Distilled IT-universal skill: executing-plans (score 4/5)",
+    "description": "Distilled IT-universal skill: executing-plans (score 3/5)",
     "source_file": "src/skills/distilled/distilled-executing-plans.md",
     "keywords": [
       "executing",
       "plans"
     ]
   },
+  {
+    "name": "distilled-finishing-a-development-branch",
+    "description": "Distilled IT-universal skill: finishing-a-development-branch (score 4/5)",
+    "source_file": "src/skills/distilled/distilled-finishing-a-development-branch.md",
+    "keywords": [
+      "finishing",
+      "development",
+      "branch"
+    ]
+  },
+  {
+    "name": "distilled-frontend-design",
+    "description": "Distilled IT-universal skill: frontend-design (score 4.5/5)",
+    "source_file": "src/skills/distilled/distilled-frontend-design.md",
+    "keywords": [
+      "frontend",
+      "design"
+    ]
+  },
   {
     "name": "distilled-harness-engineering",
     "description": "Distilled IT-universal skill: harness-engineering (score 5/5)",
@@ -87,7 +165,7 @@
       "改造",
       "老代码"
     ],
-    "spawn_agent": "refactor-specialist"
+    "spawn_agent": "safety-net-implementer"
   },
   {
     "name": "distilled-karpathy-guidelines",
@@ -131,6 +209,16 @@
       "性能"
     ]
   },
+  {
+    "name": "distilled-receiving-code-review",
+    "description": "Distilled IT-universal skill: receiving-code-review (score 4/5)",
+    "source_file": "src/skills/distilled/distilled-receiving-code-review.md",
+    "keywords": [
+      "receiving",
+      "code",
+      "review"
+    ]
+  },
   {
     "name": "distilled-spec-driven-design",
     "description": "Distilled IT-universal skill: spec-driven design + file-based planning (portable, hand-rewritten 2026-05-27)",
@@ -157,30 +245,45 @@
     ],
     "spawn_agent": "planner"
   },
+  {
+    "name": "distilled-subagent-driven-development",
+    "description": "Distilled IT-universal skill: subagent-driven-development (score 3.5/5)",
+    "source_file": "src/skills/distilled/distilled-subagent-driven-development.md",
+    "keywords": [
+      "subagent",
+      "driven",
+      "development"
+    ]
+  },
   {
     "name": "distilled-systematic-debugging",
-    "description": "Distilled IT-universal skill: systematic-debugging (score 5/5)",
+    "description": "Distilled IT-universal skill: systematic-debugging (score 4.5/5)",
     "source_file": "src/skills/distilled/distilled-systematic-debugging.md",
     "keywords": [
       "systematic",
-      "debugging",
-      "debug",
-      "调试",
-      "bug",
-      "修复",
-      "fix",
-      "hotfix",
-      "报错",
-      "异常",
-      "error",
-      "不工作",
-      "失败",
-      "failed",
-      "crash",
-      "问题"
+      "debugging"
     ],
     "spawn_agent": "harness-debug-full"
   },
+  {
+    "name": "distilled-test-driven-development",
+    "description": "Distilled IT-universal skill: test-driven-development (score 3.5/5)",
+    "source_file": "src/skills/distilled/distilled-test-driven-development.md",
+    "keywords": [
+      "test",
+      "driven",
+      "development"
+    ]
+  },
+  {
+    "name": "distilled-using-superpowers",
+    "description": "Distilled IT-universal skill: using-superpowers (score 4.5/5)",
+    "source_file": "src/skills/distilled/distilled-using-superpowers.md",
+    "keywords": [
+      "using",
+      "superpowers"
+    ]
+  },
   {
     "name": "distilled-verification-before-completion",
     "description": "Distilled IT-universal skill: verification-before-completion (score 5/5)",
@@ -190,5 +293,14 @@
       "before",
       "completion"
     ]
+  },
+  {
+    "name": "distilled-writing-skills",
+    "description": "Distilled IT-universal skill: writing-skills (score 4/5)",
+    "source_file": "src/skills/distilled/distilled-writing-skills.md",
+    "keywords": [
+      "writing",
+      "skills"
+    ]
   }
 ]

package/dist/claudemd/templates/swarm-protocol.md

@@ -35,7 +35,7 @@
 2. **搜索 / 查代码**：任何 grep / find / git diff / 跨文件查找（单文件已知路径的 Read 除外）
    → spawn `Explore` 或 `doc-reviewer`；主线程不自己查。
 3. **实施**：用户批准后，实质改动（Edit/Write / 多文件 / 新功能 / 重构 / bugfix）
-   → spawn `coder` / `refactor-specialist` / `hybrid-feature-with-safety` 等；主线程不自己动手。
+   → spawn `coder` / `safety-net-implementer`（mode=hotfix|refactor|hybrid-feature）等；主线程不自己动手。
 4. **验证**：实施后 spawn `verify-agent` 验证。
 
 **并行优先（要效率）**：工作可拆分 / 相互独立时，在一条消息里 batch spawn 多个 agent