@winspan/claude-forge 8.54.4 → 9.12.0

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
 
 ---
 
@@ -24,7 +24,7 @@ daemon 以 Unix socket 形式与 Claude Code 的 Hook 脚本通信。每次 `Use
 Agent 还可以通过 MCP 工具 `skill_invoke` 按需获取 Skill 的完整方法论内容（需先运行 `cf mcp register`）。
 
 ### 4. Web 管理后台
-`claude-forge daemon start` 默认在 `http://127.0.0.1:<port>`（默认端口 `3721`，可在 `~/.claude-forge/config.yaml` 的 `web.port` 修改）开放一个 React 管理后台，覆盖：会话浏览、事件流、执行追踪、Agent/Skill 编辑、AI 配置、实时 SSE 日志。
+`claude-forge daemon start` 默认在 `http://127.0.0.1:<port>`（默认端口 `3721`，可在 `~/.claude-forge/config.yaml` 的 `web.port` 修改）开放一个 React 管理后台，覆盖：会话浏览、事件流、执行追踪、Agent/Skill 编辑、实时 SSE 日志。（AI Provider 配置面在 spec `0902` 子 spec D R-C 永久下线，AI 流程改走本地 `claude` CLI 订阅）。
 
 ### 5. 长跑稳定性
 - **自动同步**：daemon 启动时自动将内置 hook 脚本同步到 `~/.claude/hooks/`、将内置 skill 同步到 `~/.claude/skills/`，防止 npm 升级后用户副本陈旧
@@ -53,19 +53,18 @@ npm install -g @winspan/claude-forge
 # 2. 初始化（把 hook 脚本装到 ~/.claude/hooks/）
 cf init
 
-# 3. 配置 AI Provider（可选）
-cf config
-
-# 4. 启动 daemon
+# 3. 启动 daemon
+#    （AI Provider 配置已下线 — 见 spec 0902 子 spec D R-C，
+#     AI 流程走本地 `claude` CLI 订阅，不再需要 daemon 持 API key）
 cf daemon start
 
-# 5. 打开管理后台（默认 3721，可在 ~/.claude-forge/config.yaml 修改 web.port）
+# 4. 打开管理后台（默认 3721，可在 ~/.claude-forge/config.yaml 修改 web.port）
 open http://127.0.0.1:3721
 
-# 5.5（可选）注册 MCP 服务器（让 Agent 能动态调用 Skill）
+# 4.5（可选）注册 MCP 服务器（让 Agent 能动态调用 Skill）
 cf mcp register
 
-# 6. （可选）查看架构图
+# 5. （可选）查看架构图
 open docs/architecture/diagrams/overview.drawio  # macOS 用 drawio desktop / web 打开
 ```
 
@@ -78,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 config` | AI Provider 配置（API key、base_url、model） |
+| `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 +98,8 @@ open docs/architecture/diagrams/overview.drawio  # macOS 用 drawio desktop / we
 | `cf trace <commit>` | 查看 commit 关联的 session |
 | `cf executions {list,show}` | 浏览历史执行记录 |
 | `cf mcp` | MCP 配置 |
-| `cf claudemd` | 生成/更新项目 CLAUDE.md |
+| `cf claudemd` | 生成/更新项目 CLAUDE.md（通过 `claude` CLI 子进程 + `claudemd-writer` agent，**不再读 `ANTHROPIC_API_KEY`**） |
+| `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` | 交互式菜单（推荐入口） |
 
@@ -106,28 +113,166 @@ open docs/architecture/diagrams/overview.drawio  # macOS 用 drawio desktop / we
 
 主要页面：
 
-- `/dashboard` — 总览
-- `/sessions` — 会话列表 + 详情
+- `/health` — 整体健康度（默认入口）
 - `/tasks` — 任务列表 + 详情
-- `/events` — Hook 事件流
-- `/skills` — 在线查看 `~/.claude/skills/*.md`
-- `/ai-config` — 切换 AI Provider / 测试连接
-- `/reports` — 周报与统计
+- `/context` — Knowledge / Skills / Agents 浏览（旧 `/skills` `/knowledge` redirect 进来）
+- `/violations` — 治理违规记录
+- `/settings` — 主题 / 关于（**AI 配置面已在 spec `0902` 子 spec D R-C 删除**）
+
+> 老 v2/v3 URL（`/sessions` `/events` `/dashboard` `/pipeline` `/resources` `/skills` `/knowledge`）会自动 redirect 到新位置。`/ai-config` 老 URL 在 R-C 永久下线，落 NotFound。
 
 所有列表支持搜索 + JSON/CSV 导出。
 
 ---
 
+## Skill Distillation
+
+claude-forge 内置 **12 个开箱即用的 distilled skill**（已蒸馏自上游优秀开源 skill 仓库），首次 `cf daemon start` 时自动同步到 `~/.claude/skills/`，无需任何配置。
+
+```bash
+# 查看本机已安装的 distilled skills
+ls ~/.claude/skills/distilled-*.md
+
+# 同步触发（通常 daemon 启动时已经做了，无需手动）
+cf daemon restart
+
+# 列出所有 skill（distilled + user-owned）
+cf skills list
+
+# 调用某个 distilled skill 看完整方法论
+cf skills invoke distilled-systematic-debugging
+```
+
+### 自己蒸馏额外的 skill
+
+蒸馏入口已收敛到 **Web 仪表盘**：打开 `http://127.0.0.1:3721/context?tab=distill` →
+点【开始蒸馏】。daemon 通过本地 `claude` CLI 子进程跑（`child_process.spawn` +
+`-p --agent skill-distiller --bare --output-format stream-json`），**走你已经
+付费的 Claude Code 订阅 / OAuth keychain**，daemon 自身不持
+`ANTHROPIC_API_KEY`。
+
+**前置条件**：本机已安装 `claude` CLI（`brew install claude` 或
+`npm i -g @anthropic-ai/claude-code`）。Web 仪表盘顶部会自动检测并显示
+binary 路径（`claude CLI: ✓ /opt/homebrew/bin/claude`）。未安装时按钮会被
+disable + 显示安装提示。
+
+蒸馏流程（单次按钮点击发生的事情）：
+
+1. daemon spawn `claude -p --agent skill-distiller …`
+2. agent 读 upstream skill markdown → 按 D1-D5 维度自评分（0-5）
+3. 评分 < 3 → 输出 `---SKIP---` envelope（含 score + rationale，UI 显示为 skipped）
+4. 评分 ≥ 3 → 输出 `---SKILL---` envelope（含通用化 markdown body）
+5. daemon `parseSkillBlock()` 提取 body → `project-anchor-guard` 自查 → 写入
+   `src/skills/distilled/distilled-xxx.md` + NOTICE 归因
+
+> 设计 spec：[`docs/design/2026-05-28/1851-distill-via-claude-cli-shellout-spec.md`](docs/design/2026-05-28/1851-distill-via-claude-cli-shellout-spec.md)
+
+### 自定义 / 覆盖建议
+
+- **不要直接编辑 `~/.claude/skills/distilled-*.md`** —— daemon 重启时若 hash 不一致会跳过覆盖（保护你的改动），但版本升级时新 skill 不会自动应用，需手动 diff
+- **要做项目级自定义**：另存为 `my-<name>.md` 或 `team-<name>.md`，`my-*` 前缀不在内置 sourceSet 内，永不被覆盖
+- 想完全替换某个 distilled skill：删掉它然后 `cf daemon restart`，会按当前最新版本重新生成
+
+更多细节见 [DEVELOPMENT.md § Skill 蒸馏](./DEVELOPMENT.md#skill-蒸馏) 与 [§ skill-distiller agent 使用说明](./DEVELOPMENT.md#skill-distiller-agent-使用说明)。
+
+---
+
+## CLAUDE.md 生成（`cf claudemd init/update`）
+
+`cf claudemd init` / `cf claudemd update` 现在通过本地 `claude` CLI 子进程跑 ——
+daemon spawn `claude -p --agent claudemd-writer --bare`，agent 读取项目技术栈 +
+目录树 + persona + 已有 conventions（由 host 通过 stdin 注入），输出包在
+`---CLAUDEMD---...---END---` envelope 内的 markdown body。
+
+**前置条件**：本机已安装 `claude` CLI（`brew install claude` 或
+`npm i -g @anthropic-ai/claude-code`）—— 与 Skill Distillation 相同的 install hint。
+
+**不再依赖** `ANTHROPIC_API_KEY` —— 走你已经付费的 Claude Code 订阅 / OAuth
+keychain，daemon 自身不持 API key。
+
+更多细节见 [DEVELOPMENT.md § CLAUDE.md 生成与维护](./DEVELOPMENT.md#claudemd-生成与维护)
+与 [§ claudemd-writer agent 使用说明](./DEVELOPMENT.md#claudemd-writer-agent-使用说明)。
+
+> 设计 spec：[`docs/design/2026-05-29/0902-ai-config-removal-master-spec.md`](docs/design/2026-05-29/0902-ai-config-removal-master-spec.md) 子 spec A
+
+---
+
+## 项目知识库（`cf knowledge`）
+
+`cf knowledge init` / `cf knowledge build` / `cf knowledge update` 现在通过本地
+`claude` CLI 子进程跑 —— host 起 `claude -p --agent knowledge-builder --bare`
+子进程，agent 每个 KB page 输出一个 `---KB---...---END---` envelope，host 解析
+后写入 `.forge-knowledge/modules/*.md` + `.forge-knowledge/<cross-module>.md` +
+`.meta.json` + `repo-map.json`。
+
+**前置条件**：本机已安装 `claude` CLI（`brew install claude` 或
+`npm i -g @anthropic-ai/claude-code`）—— 与 Skill Distillation / CLAUDE.md
+生成相同的 install hint。
+
+**不再依赖** `ANTHROPIC_API_KEY` —— 走你已经付费的 Claude Code 订阅 / OAuth
+keychain，daemon 自身不持 API key。
+
+```bash
+# 首次构建（含 git hook 安装）
+cf knowledge init
+
+# 增量更新（基于 git diff）
+cf knowledge update
+
+# 查询（纯本地 keyword + repo-map，不需要 claude CLI）
+cf knowledge query "daemon socket"
+```
+
+**注意**：`cf knowledge query --strategy rerank`（AI 重排序）已在 Spec 2 Stage
+B（commit `797326f8`）下线 —— 现在仅 keyword + repo-map 检索。
+
+更多细节见 [DEVELOPMENT.md § knowledge-builder agent 使用说明](./DEVELOPMENT.md#knowledge-builder-agent-使用说明)。
+
+> 设计 spec：[`docs/design/2026-05-29/0902-ai-config-removal-master-spec.md`](docs/design/2026-05-29/0902-ai-config-removal-master-spec.md) 子 spec B
+
+---
+
+## AI 辅助 Patch 预览（Web `POST /api/patch/preview`）
+
+Web 仪表盘 / 外部脚本可以 `POST` 一段 `{ targetType, targetName, recommendation,
+rationale }` 到 `/api/patch/preview`，daemon 会通过本地 `claude` CLI 子进程跑
+`claude -p --agent patch-applier --bare`，agent 输出 PATCH（unified diff）或
+NOPATCH（连同 reason）envelope，host 解析后回 JSON。
+
+**前置条件**：本机已安装 `claude` CLI（`brew install claude` 或
+`npm i -g @anthropic-ai/claude-code`）—— 与 Skill Distillation / CLAUDE.md
+生成 / 项目知识库相同的 install hint。
+
+**不再依赖** `ANTHROPIC_API_KEY` —— 走你已经付费的 Claude Code 订阅 / OAuth
+keychain，daemon 自身不持 API key。
+
+⚠️ **响应字段 BREAKING（R-A → R-B）**：R-A 阶段 `/api/patch/preview` 返回
+`{after, summary, risk}`；R-B 之后改为 discriminated union
+`{patch} | {noPatch, reason}`。HTTP 错误码也细分为 `499`（cancel）/
+`504`（timeout）/ `500`（missing / exit / unknown）。前端 / 脚本如果有调用
+该端点，必须按新 schema 适配。
+
+> 当前 `web/src/` 内置前端尚未集成 patch UI（`grep api/patch web/src` = 0
+> 命中）。如未来加 Web 前端 patch 预览界面，参照 spec C 「前端处理」段落。
+> `POST /api/patch/apply` 路径未变（始终是纯 fs write + backup，不走 LLM）。
+
+更多细节见 [DEVELOPMENT.md § patch-applier agent 使用说明](./DEVELOPMENT.md#patch-applier-agent-使用说明)。
+
+> 设计 spec：[`docs/design/2026-05-29/0902-ai-config-removal-master-spec.md`](docs/design/2026-05-29/0902-ai-config-removal-master-spec.md) 子 spec C
+
+---
+
 ## Project Map
 
 | 模块 | 一句话职责 |
 |---|---|
-| `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 通信 |
+| `src/knowledge/` | v9.3 项目知识库（cf knowledge build/update/query/audit/list/clean/rollback），含 5 跨模块页、3 个 MCP 工具（knowledge_query / knowledge_get_page / repo_map_lookup）。build 通过本地 `claude` CLI 子进程 + `knowledge-builder` agent（spec [`0902`](docs/design/2026-05-29/0902-ai-config-removal-master-spec.md) 子 spec B），不再读 `ANTHROPIC_API_KEY`。**注**：AI rerank 检索路径已在 Spec 2 Stage B（commit `797326f8`）下线，仅保留 keyword + repo-map 查询。 |
 
 ## 贡献
 

package/dist/catalogs/agents.json

@@ -0,0 +1,67 @@
+[
+  {
+    "name": "agent-retro-distiller",
+    "description": "",
+    "source_file": "src/daemon/templates/agents/agent-retro-distiller.md"
+  },
+  {
+    "name": "claudemd-writer",
+    "description": "",
+    "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": "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": "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": "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": "src/daemon/templates/agents/harness-debug-full.md"
+  },
+  {
+    "name": "knowledge-builder",
+    "description": "",
+    "source_file": "src/daemon/templates/agents/knowledge-builder.md"
+  },
+  {
+    "name": "patch-applier",
+    "description": "",
+    "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": "src/daemon/templates/agents/planner.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": "src/daemon/templates/agents/skill-distiller.md"
+  },
+  {
+    "name": "task-boundary-classifier",
+    "description": "",
+    "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": "src/daemon/templates/agents/verify-agent.md"
+  }
+]

package/dist/catalogs/skills.json

@@ -0,0 +1,306 @@
+[
+  {
+    "name": "distilled-api-design",
+    "description": "Distilled IT-universal skill: api-design (score 4.5/5)",
+    "source_file": "src/skills/distilled/distilled-api-design.md",
+    "keywords": [
+      "api",
+      "design",
+      "api design",
+      "api 设计",
+      "restful",
+      "openapi",
+      "接口设计",
+      "rest api",
+      "web api",
+      "http api",
+      "endpoint"
+    ]
+  },
+  {
+    "name": "distilled-architecture-decision",
+    "description": "Distilled IT-universal skill: architecture decision records (portable, hand-rewritten 2026-05-27)",
+    "source_file": "src/skills/distilled/distilled-architecture-decision.md",
+    "keywords": [
+      "architecture",
+      "adr",
+      "decision",
+      "design",
+      "record",
+      "architecture decision",
+      "架构决策",
+      "技术选型"
+    ]
+  },
+  {
+    "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": [
+      "skill creation",
+      "create skill",
+      "创建技能",
+      "skill development",
+      "distill skill"
+    ]
+  },
+  {
+    "name": "distilled-db-schema-design",
+    "description": "Distilled IT-universal skill: db-schema-design (score 4.5/5)",
+    "source_file": "src/skills/distilled/distilled-db-schema-design.md",
+    "keywords": [
+      "db",
+      "schema",
+      "design",
+      "database",
+      "数据库设计",
+      "migration",
+      "迁移",
+      "sql"
+    ]
+  },
+  {
+    "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": [
+      "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 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)",
+    "source_file": "src/skills/distilled/distilled-harness-engineering.md",
+    "keywords": [
+      "harness",
+      "engineering",
+      "legacy",
+      "遗留代码",
+      "特征测试",
+      "characterization",
+      "重构",
+      "refactor",
+      "改造",
+      "老代码"
+    ],
+    "spawn_agent": "safety-net-implementer"
+  },
+  {
+    "name": "distilled-karpathy-guidelines",
+    "description": "Karpathy 4 条 LLM 编程铁律 — moved as-is, not re-distilled (already a distillation of multica-ai/andrej-karpathy-skills)",
+    "source_file": "src/skills/distilled/distilled-karpathy-guidelines.md",
+    "keywords": [
+      "karpathy",
+      "guidelines",
+      "编程原则",
+      "编程铁律",
+      "simplicity",
+      "surgical",
+      "goal-driven",
+      "简洁优先",
+      "外科手术",
+      "目标可验证",
+      "行数预算",
+      "可验证判据",
+      "事前思考",
+      "think before coding"
+    ]
+  },
+  {
+    "name": "distilled-performance-optimization",
+    "description": "Distilled IT-universal skill: performance optimization workflow (portable, hand-rewritten 2026-05-27)",
+    "source_file": "src/skills/distilled/distilled-performance-optimization.md",
+    "keywords": [
+      "performance",
+      "optimization",
+      "profiling",
+      "latency",
+      "bottleneck",
+      "optimize",
+      "优化",
+      "瓶颈",
+      "慢",
+      "slow",
+      "timeout",
+      "超时",
+      "卡顿",
+      "性能"
+    ]
+  },
+  {
+    "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)",
+    "source_file": "src/skills/distilled/distilled-spec-driven-design.md",
+    "keywords": [
+      "spec",
+      "sdd",
+      "plan",
+      "design",
+      "requirements",
+      "acceptance",
+      "spec-driven",
+      "规格",
+      "需求文档",
+      "planning",
+      "规划",
+      "task plan",
+      "organize",
+      "组织任务",
+      "怎么做",
+      "方案",
+      "步骤",
+      "计划"
+    ],
+    "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 4.5/5)",
+    "source_file": "src/skills/distilled/distilled-systematic-debugging.md",
+    "keywords": [
+      "systematic",
+      "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)",
+    "source_file": "src/skills/distilled/distilled-verification-before-completion.md",
+    "keywords": [
+      "verification",
+      "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"
+    ]
+  }
+]