你的 Claude Code 每次会话都会变得更聪明。
自我纠正记忆 + 持久化的 FTS5 索引 wiki + 自动研究循环，全部存储于同一个 SQLite 存储中。
纠正 Claude 一次 — 它就不会再犯同样的错误。构建一个主题的 wiki — 它会在一夜之间自我成长。
41 项技能 • 8 个 agents • 23 个命令 • 覆盖 24 个事件的 37 个 hook 脚本
兼容 Claude Code、Cursor，以及通过 skills add 兼容的 32+ agents。
## 问题所在
你用同样的方式纠正了 Claude 50 次。每次新会话你都要解释一遍规范。上下文被压缩，经验随之消失，错误不断重复。你在三个不同的会话中研究同一个主题，因为这些答案没有持久化存储的地方。
**每个 Claude Code 用户都会遇到这个瓶颈。**
## 解决方案
Pro Workflow 在每次会话底层放置了一个统一的 SQLite 存储。
- **自我纠正记忆** — 每次纠正都会变成一条规则，支持 FTS5 搜索，并在会话开始时自动加载。
- **知识平面** — 持久化的研究 wiki 存储在磁盘上 + FTS5 影子索引，可从任何会话查询，可通过自动研究循环选择性扩充。
- **质量关卡** — 由 LLM 驱动的 hooks，确定性的 git/密钥防护，感知压缩的状态，成本追踪。
经过 50 次会话后，你几乎不需要再纠正什么。经过一周的自动研究，你关于某个主题的 wiki 将比你最初精心整理的列表还要密集。
```
Session 1: You → "Don't mock the database in tests"
Claude → Proposes rule → You approve → Saved to SQLite
Session 2: SessionStart loads all learnings + lists your wikis
UserPromptSubmit auto-injects top wiki hits when relevant
Claude writes integration tests, cites the right wiki page
Session 50: Correction rate near zero. Wiki has 200 cited claims.
```
## 安装
Pro Workflow 发布在两个地方：Claude Code 插件市场（原生），以及 skills add（跨 agent 安装程序）。其他 agent 目前还没有一等公民插件 — skills add 会将技能包安装到每个 agent 的原生技能目录中。
### Claude Code (原生)
```
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow
```
### Cursor, Codex, Copilot CLI, Droid, Gemini CLI, OpenCode 及其他 26+ 工具 (通过 skills add)
skills add 会将 41 项技能 + 23 个命令安装到每个 agent 的原生技能目录中。
```
npx skills add rohitg00/pro-workflow
```
注意事项：
- 使用 `rohitg00/pro-workflow`（GitHub 格式），不要只用纯名称 — `skills add` 通过 `owner/repo` 解析提供商，而不是市场 slug。
兼容以下 agents：`cursor`, `codex`, `gemini-cli`, `opencode`, `github-copilot`, `droid` (factory), `antigravity`, `amp`, `clawdbot`, `cline`, `codebuddy`, `commandcode`, `continue`, `crush`, `goose`, `kilo`, `kiro-cli`, `mcpjam`, `mux`, `neovate`, `openhands`, `pi`, `qoder`, `qwen`, `roo`, `trae`, `universal`, `vercel`, `windsurf`, `zencoder`。
名单说明 (2026)：`windsurf` 重新发布为 Devin Desktop，它使用 Agent Client Protocol (ACP) 通信；对于普通消费者，`gemini-cli` 已被 Antigravity CLI 取代。上面的适配器名称仍然有效，但会指向当前产品。MCP 在此列表中的所有 agent 上都可以使用相同的设置工作。有关互操作性的全貌，请参见 [`references/modern-workflows-2026.md`](references/modern-workflows-2026.md)。
安装后，运行 `skills sync` 以将技能注册到目标 agent 的配置中。
手动安装 (任何 agent，任何操作系统)
如果这两种路径都不适合你的环境配置，请直接克隆并复制该资源包。根据你的 agent 技能目录调整目标路径（例如 `~/.cursor/rules/`、`~/.gemini/extensions/` 等）。
```
git clone https://github.com/rohitg00/pro-workflow.git /tmp/pw
cd /tmp/pw && npm install && npm run build
cp -r /tmp/pw/templates/split-claude-md/* ./.claude/
cp -r /tmp/pw/skills ~/.claude/skills/
cp -r /tmp/pw/commands ~/.claude/commands/
cp /tmp/pw/hooks/hooks.json ~/.claude/hooks.json
```
### 首次运行冒烟测试
```
/doctor # confirms SQLite store, hooks, skills load
/wrap-up # runs the end-of-session ritual (no-op on fresh install)
```
如果 `/doctor` 报告 `KB: missing`，请运行 `cd ~/.claude/plugins/*/pro-workflow && npm install && npm run build` — SQLite 组件需要一个少数市场会跳过的构建步骤。
## 首先输入什么
安装后，你将拥有 **41 项技能**和 **23 个斜杠命令**。你不需要记住它们；agent 会根据你的提示选择正确的技能。以下五个命令涵盖了 80% 的日常使用：
| 何时使用 | 命令 | 作用 |
|---|---|---|
| **重复的错误纠正** | `/learn-rule` | 将纠正捕获为规则。在未来的每次 `SessionStart` 时加载。 |
| **编码会话结束时** | `/wrap-up` | 审计更改，持久化经验，编写交接文档。 |
| **研究某个主题时** | `/wiki init
` | 启动一个持久化的 FTS5 wiki。以后当你提到该主题时会自动注入。 |
| **遇到困难 bug 时** | `/develop` | 包含验证关卡的 研究 → 计划 → 实现 阶段。 |
| **提交 PR 前** | `/smart-commit` | 质量关卡，暂存区审查，约定式提交信息。 |
完整列表：[`commands/`](./commands) · [`skills/`](./skills) · 任何会话中的 [`/list`](./commands/list.md)。
## 60 秒教程
```
# 自纠正（现有）
/learn-rule # capture a correction
/wrap-up # end session, persist learnings, audit changes
/insights # heatmaps, trends, productivity
# Knowledge plane（v3.3，新增）
/wiki init agent-memory --title "Agent Memory" --flavor research
/wiki page agent-memory wiki/concepts/episodic-memory.md --type concept
/wiki ask "what is episodic memory" --wiki agent-memory
# 自动研究（有预算上限，opt-in）
/wiki seed agent-memory "memory consolidation in agents"
/wiki research agent-memory --max-pages 5 --budget-usd 0.50
# 混合检索（BM25 + vector RRF，可选）
/wiki embed agent-memory # OPENAI_API_KEY or VOYAGE_API_KEY
/wiki hybrid "consolidation patterns" --wiki agent-memory
# Multi-LLM 审议（记录保留为 wiki 页面）
/wiki council "should we adopt episodic memory?" --wiki agent-memory
# 可视化浏览 wiki（单文件 HTML，可 S3 共享）
/wiki view agent-memory
open ~/.pro-workflow/wikis/agent-memory/derived/viewer.html
# 任意自动循环的 Kill switch
touch ~/.pro-workflow/STOP
```
当提示提到被索引的主题时，`UserPromptSubmit` 会自动加载排名前 3 的 wiki 命中结果。`SessionStart` 会列出已注册的 wiki 和最近的学习经验。
## v3.3 中的新特性
在自我纠正记忆之上构建的持久化知识平面。
| 技能 | 用途 |
|-------|---------|
| **wiki-builder** | 持久化的 FTS5 索引研究 wiki。9 种风格：research, paper, domain, product, person, organization, project, codebase, incident。具有路径遍历防护。 |
| **wiki-query** | 带有片段的 BM25 检索。`ask`、`related`、`show`。在 `UserPromptSubmit` 时自动注入。 |
| **wiki-research-loop** | 预算限制的 BFS。可插拔的来源获取器（web/arXiv/GitHub + 自定义）。收敛检测、紧急停止开关、原子种子声明、try/finally 状态防护。 |
| **llm-council** | 与提供商无关的 3 阶段审议（Anthropic/OpenAI/OpenRouter/Fireworks/自定义）。使用 `Promise.allSettled`，因此单个提供商失败不会中止运行。记录将作为 wiki 页面持久化保存。 |
| **survey-generator** | 与提供商无关的文献综述。输出目标 = wiki markdown 页面。参考文献验证（唯一性 + 章节论文引用），引用 ID 与 `sources.md` 行对齐。 |
| **wiki-viewer** | 用于任何 wiki 的单文件 HTML 查看器：页面 + 来源 + 种子 + 链接图 + 浏览器内搜索 + “复制为种子” CTA。支持 S3 分享。应用了来自 [Thariq Shihipar 的 HTML 作为输出理论](https://x.com/trq212/status/2034017024445244382) 的经验。 |
此外：`/wiki` 命令（现在带有 `view`）、`learn-rule` 的 `Wiki: ` 作用域、schema 新增（`wikis`、`wiki_pages` + FTS5、`wiki_sources`、`wiki_claims`、`wiki_seeds`、`wiki_embeddings`、`learnings_wiki`）、响应式文件监视器种子入队、cron-tick 驱动程序、扩展了 KB + 提供商部分的 `/doctor`。
## 对比
| 功能 | Pro Workflow | [Superpowers](https://github.com/obra/superpowers) | [ECC](https://github.com/affaan-m/everything-claude-code) | [gstack](https://github.com/garrytan/gstack) | [GSD](https://github.com/gsd-build/get-shit-done) |
|---------|:-----------:|:-----------:|:---:|:------:|:---:|
| 自我纠正记忆 (SQLite + FTS5) | **是** | 否 | 否 | 否 | 否 |
| 持久化研究 wiki (FTS5) | **是** | 否 | 否 | 否 | 否 |
| 自动研究循环 (预算限制的 BFS) | **是** | 否 | 否 | 否 | 否 |
| 混合检索 (BM25 + 向量 + RRF) | **是** | 否 | 否 | 否 | 否 |
| 多提供商 LLM council | **是** | 否 | 否 | 否 | 否 |
| LLM 驱动的 hooks (`type: "prompt"`) | **是** | 否 | 否 | 否 | 否 |
| 权限拒绝分析 | **是** | 否 | 否 | 否 | 否 |
| 感知压缩的状态保存 | **是** | 否 | 否 | 否 | 否 |
| 成本追踪和预算警报 | **是** | 否 | 否 | 否 | 否 |
| MCP 开销审计 | **是** | 否 | 否 | 否 | 否 |
| 跨 agent (通过 skills add 支持 32+ agents) | **是** | 否 | 部分 | 否 | 否 |
| 技能 | 34 | 14 | 140+ | 18+ | 0 |
| Agents | 8 | 5 | 36 | 0 | 18 |
| 命令 | 22 | 3 | 60+ | 5+ | 57 |
| Hook 事件 | 24 | 8 | 18 | 0 | 0 |
## 包含内容
### 41 项技能
**知识平面 (v3.3 新增)**
| 技能 | 作用 |
|-------|--------------|
| **wiki-builder** | 构建 + 注册 FTS5 索引的研究 wiki |
| **wiki-query** | BM25 检索，片段，相关内容，展示 |
| **wiki-research-loop** | 对 web/arXiv/GitHub 获取器进行预算限制的 BFS |
| **llm-council** | 与提供商无关的 3 阶段多 LLM 审议 |
| **survey-generator** | 文献综述产出物，输出到 wiki 页面 |
| **wiki-viewer** | 单文件 HTML 查看器（页面、来源、种子、链接图、搜索） |
**质量关卡与可观测性**
| 技能 | 作用 |
|-------|--------------|
| **smart-commit** | 质量关卡，暂存区审查，约定式提交 |
| **llm-gate** | AI 驱动的提交和密钥 hooks (`type: "prompt"`) |
| **permission-tuner** | 分析拒绝，生成允许/拒绝规则 |
| **compact-guard** | 通过压缩周期保持状态 |
| **cost-tracker** | 具备预算基准的会话成本感知 |
| **mcp-audit** | MCP 服务器 token 开销分析 |
| **token-efficiency** | 反盲目顺从 + 工具调用预算 + 先读后写 |
| **safe-mode** | 针对破坏性操作的防护栏 |
| **insights** | 会话分析，纠正趋势，生产力 |
| **thoroughness-scoring** | 评估实现的完整性 |
| **deslop** | 从 diff 中移除 AI 生成的劣质代码 |
**记忆与学习**
| 技能 | 作用 |
|-------|--------------|
| **pro-workflow** | 核心 8 种模式 |
| **learn-rule** | 捕获纠正（现支持 wiki 作用域） |
| **replay-learnings** | 为当前任务展现过往经验 |
| **wrap-up** | 会话结束的例行流程 |
| **session-handoff** | 为下一次会话准备恢复文档 |
**编排与工程循环**
| 技能 | 作用 |
|-------|--------------|
| **orchestrate** | 多阶段 研究 → 计划 → 实现 → 审查 |
| **agent-teams** | 多实例协调，共享任务列表 |
| **batch-orchestration** | 用于大型变更的并行 worktree agents |
| **parallel-worktrees** | 零空耗的 Git worktree 设置 |
| **context-engineering** | 写入/选择/压缩/隔离 框架 |
| **context-optimizer** | Token 管理，上下文预算，MCP 审计 |
| **auto-setup** | 自动检测项目类型，配置质量关卡 |
| **file-watcher** | 基于配置和依赖变更的响应式工作流 |
| **bug-capture** | 将缺陷捕获为持久化问题而不泄露路径 |
| **module-map** | 针对陌生代码库区域的一屏地图 |
|plan-interrogate** | 通过遍历决策树来压力测试计划 |
| **sprint-status** | 追踪多会话进度 |
### 8 个 agents
| Agent | 用途 |
|-------|---------|
| **planner** | 分解复杂任务（只读，需批准） |
| **reviewer** | 代码审查和安全审计（基于检查清单） |
| **scout** | 置信度门槛探索（后台，worktree 隔离） |
| **orchestrator** | 多阶段功能开发 |
| **debugger** | 系统化、假设驱动的 bug 调查 |
| **context-engineer** | 上下文窗口分析（轻量级，只读） |
| **permission-analyst** | 拒绝模式分析，规则优化建议 |
| **cost-analyst** | Token 使用分析，识别昂贵操作 |
### 23 个命令
| 命令 | 作用 |
|---------|--------------|
| `/wiki` | 知识平面入口：init, page, ask, hybrid, seed, research, council, survey, embed, status |
| `/develop` | 带有验证关卡的多阶段功能构建 |
| `/commit` | 带有质量关卡的智能提交 |
| `/wrap-up` | 会话结束检查清单和学习捕获 |
| `/learn-rule` / `/learn` | 提取纠正或学习 Claude Code 最佳实践 |
| `/doctor` | 安装健康检查（现包含 wiki KB + council 提供商） |
| `/insights` | 会话分析和纠正热力图 |
| `/replay` | 为当前任务展现过往经验 |
| `/handoff` | 会话交接文档 |
| `/search` / `/list` | 搜索并列出已存储的经验 |
| `/deslop` | 移除 AI 生成的劣质代码 |
| `/context-optimizer` | 审计并优化上下文窗口使用 |
| `/parallel` | 为并行会话设置 git worktrees |
| `/safe-mode` | 切换破坏性操作的防护栏 |
| `/sprint-status` | 追踪多会话进度 |
| `/auto-setup` | 自动检测项目类型，配置质量关卡 |
| `/compact-guard` | 带有状态保存的受保护压缩 |
| `/cost-tracker` | 追踪会话成本和优化建议 |
| `/mcp-audit` | 审计 MCP 服务器的 token 开销 |
| `/permission-tuner` | 根据拒绝模式生成允许/拒绝规则 |
### 覆盖 24 个事件的 37 个 hook 脚本
`SessionStart`, `SessionEnd`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `Stop`, `PreCompact`, `PostCompact`, `SubagentStart`, `SubagentStop`, `TaskCreated`, `TaskCompleted`, `PermissionRequest`, `PermissionDenied`, `PostToolUseFailure`, `TeammateIdle`, `StopFailure`, `FileChanged`, `ConfigChange`, `Notification`, `Setup`, `WorktreeCreate`, `WorktreeRemove`, `CwdChanged`。
精选的高杠杆 hooks：
| Hook | 脚本 | 效果 |
|------|--------|--------|
| `SessionStart` | `session-start.js` | 加载经验；列出已注册的 wiki |
| `UserPromptSubmit` | `prompt-submit.js` | 当提示匹配索引时自动注入排名前 3 的 wiki 命中结果 |
| `Stop` | `learn-capture.js` | 自动捕获 `[LEARN]` 块（现可解析 `Wiki: `） |
| `FileChanged` | `file-changed.js` | wiki 树内的编辑会将 verify-seeds 加入队列 |
| `PreToolUse(Bash)` | `commit-validate.js`, `git-blast-radius.js`, `pre-push-check.js` | 约定式提交 + 破坏性操作 + 推送防护栏 |
| `PreToolUse(Write)` | `secret-scan.js` | LLM 驱动的密钥检测 |
| `PreCompact` / `PostCompact` | `pre-compact.js`, `post-compact.js` | 保存并重新注入关键的上下文摘要 |
### 参考指南
| 指南 | 涵盖内容 |
|-------|----------------|
| [`modern-workflows-2026.md`](references/modern-workflows-2026.md) | 多 agent 编排，Agent Teams，检查点，ACP/MCP 互操作性，技能-命令合并 |
| [`../references/models-2026.md`](references/models-2026.md) | 当前模型层级，工作量路由，任务预算 |
| [`settings-guide.md`](references/settings-guide.md) | 设置键，权限模式，层级结构 |
| [`cli-cheatsheet.md`](references/cli-cheatsheet.md) | CLI 参数，键盘快捷键，斜杠命令 |
| [`orchestration-patterns.md`](references/orchestration-patterns.md) | 命令 → Agent → 技能架构，agent 团队 |
| [`context-engineering.md`](references/context-engineering.md) | 写入/选择/压缩/隔离，记忆分类法，压缩 |
| [`agent-teams.md`](references/agent-teams.md) | 设置，分解，团队 vs 子 agent |
| [`context-loading.md`](references/context-loading.md) | CLAUDE.md 加载，agent 记忆，技能发现 |
| [`cross-agent-workflows.md`](references/cross-agent-workflows.md) | Claude Code + Cursor 协同，skills add 跨 agent |
| [`decision-framework.md`](references/decision-framework.md) | 何时使用哪种模式 |
| [`daily-habits.md`](references/daily-habits.md) | 会话习惯，调试技巧，反模式 |
| [`new-features.md`](references/new-features.md) | 检查点，远程会话，agent 和 prompt hooks |
| [`claude-code-resources.md`](references/claude-code-resources.md) | 官方文档地图和资源索引 |
## 工作原理
### `/develop` 流程
计划前先研究。实现前先计划。提交前先审查。每个阶段之间都设有验证关卡。
### 架构
命令 → Agent → 技能，构建在单一的 SQLite 存储之上。知识平面 (v3.3) 与学习规则插入到同一个存储中。
### 存储
```
~/.pro-workflow/
├── data.db # learnings, sessions, wikis (registry), wiki_pages (+FTS5),
│ # wiki_sources, wiki_claims, wiki_seeds, wiki_embeddings,
│ # learnings_wiki
├── wikis// # global-scope wikis (default location)
├── council// # llm-council transcripts
├── fetchers/ # user-supplied custom source fetchers
├── tick.log # cron-driven research-tick log
└── STOP # touch this file to halt every research loop
```
项目作用域的 wiki 位于 `/.claude/wikis//`，并且可被提交。
## 模式
| 模式 | 作用 |
|---------|--------------|
| **自我纠正循环** | Claude 自动从纠正中学习 |
| **知识平面** | 基于 SQLite 存储的 Wiki + 自动研究循环 |
| **多阶段开发** | 带有关卡的研究 → 计划 → 实现 → 审查 |
| **并行 Worktrees** | 原生 `claude -w` 实现零空耗 |
| **收尾例行流程** | 带有目的地结束会话，捕获学习经验 |
| **拆分记忆** | 针对复杂项目的模块化 CLAUDE.md |
| **80/20 审查** | 在检查点进行批量审查 |
| **上下文工程** | 用于 Token 管理的 写入/选择/压缩/隔离 |
| **Agent 团队** | 带有共享任务列表的多实例协调 |
| **批量编排** | 用于大规模变更的并行 worktree agents |
| **LLM 关卡** | 在破坏性操作前进行 AI 驱动的验证 |
| **权限调整** | 拒绝模式分析以减少提示疲劳 |
| **Token 效率** | 反盲目顺从 + 工具调用预算 + 先读后写 |
| **多 LLM Council** | 针对高风险决策的、与提供商无关的 3 阶段审议 |
## 跨 agent 支持
通过 [skills add](https://skills.sh) 兼容 32+ AI 编码 agents：
```
npx skills add rohitg00/pro-workflow
```
已支持：Claude Code, Cursor, Codex CLI, Gemini CLI, Windsurf, OpenCode, Kiro, Amp, Goose, Roo，以及其他 27 个工具。
## 配置
### 设置
请参阅 [`settings.example.json`](settings.example.json) 获取可用于生产环境的配置：权限规则、输出样式、自动压缩、自定义旋转动词。
### MCP
请参阅 [`mcp-config.example.json`](mcp-config.example.json)：
- **context7** — 实时文档查找
- **playwright** — 浏览器自动化（最高效的 token 使用）
- **GitHub** — PR、issues、代码搜索
规则：从三个 MCP 开始，仅在满足具体需求时才增加。
### 知识平面环境变量
| 环境变量 | 何时使用 |
|-----|------|
| `WIKI_ROOT` | 覆盖默认的 `~/.pro-workflow/wikis` |
| `OPENAI_API_KEY` / `VOYAGE_API_KEY` | 启用混合检索 (embeddings) |
| `ANTHROPIC_API_KEY` / `OPENAI_API_KEY` / `OPENROUTER_API_KEY` / `FIREWORKS_API_KEY` / `LLM_COUNCIL_BASE_URL`+`LLM_COUNCIL_API_KEY` | 选择 council 提供商（按先后顺序匹配） |
| `WIKI_LOOP_BUDGET_USD` / `WIKI_LOOP_MAX_PAGES` / `WIKI_LOOP_MAX_DEPTH` | 单次运行的循环覆盖参数 |
| `GH_TOKEN` / `GITHUB_TOKEN` | 提升 GitHub-fetcher 的速率限制 |
## 结构
```
pro-workflow/
├── skills/ # 41 skills
├── agents/ # 8 agents
├── commands/ # 23 slash commands
├── scripts/ # 37 hook scripts (24 events)
├── references/ # workflow, model, and skill reference guides
├── docs/ # GitHub Pages infographic
├── rules/ # rule packs (Cursor + universal)
├── contexts/ # context modes
├── templates/ # split CLAUDE.md + AGENTS.md
├── src/ # TypeScript source (SQLite + embeddings)
└── config.json
```
## 社区技巧
## 理念
1. **复利式改进** — 微小的纠正带来巨大的收益。
2. **信任但要核实** — 让 AI 工作，在检查点进行审查。
3. **零空耗** — 并行会话保持动力。
4. **记忆是宝贵的** — 你的和 Claude 的都是如此。
5. **持久化胜过临时性** — 如果下次会话还需要它，就把它写到磁盘上。
6. **编排，而不是微观管理** — 将模式连接在一起，让 agents 执行。
## 相关项目
| 项目 | 描述 |
|---------|-------------|
| [everything-claude-code](https://github.com/affaan-m/everything-claude-code) | 140+ 技能，36 个 agents — 综合性集合 |
| [claude-code-best-practice](https://github.com/shanraisshan/claude-code-best-practice) | 精选技巧、对比、社区最佳实践 |
| [skills](https://skills.sh) | 为 32+ agents 添加技能的注册表和 CLI |
| [awesome-claude-code-toolkit](https://github.com/rohitg00/awesome-claude-code-toolkit) | 850+ 文件，135 个 agents，176 个插件 — 精选目录 |
## Star 历史
If pro-workflow saves you time, star the repo so others can find it.
Documentation •
Skills Registry •
Report Issues •
Reference Guides