Pro Workflow
让编码助手通过持久记忆、研究维基和质量关卡减少重复纠正。
- Star 数
- ★ 2.9k
- 最近更新
- 1 个月前
- 主语言
- JavaScript
- FA 评分
- 50/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude CodeOpenAI API · Claude API（部分支持）
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 使用 Claude Code 反复被同一代码规范或测试要求纠正的开发者，可用
/learn-rule保存规则，并在后续会话自动载入。 - 不适合
- 不使用 Claude Code 或 Cursor 等受支持代理的团队
- 不愿运行 npm 构建步骤或维护 SQLite 存储的用户
- 源码审查
- 50/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Pro Workflow 是面向 Claude Code 的工作流插件与跨代理技能包，核心是一个保存学习规则、会话和维基数据的 SQLite 存储。它提供 41 个技能、8 个专用代理、23 个斜杠命令，以及覆盖 24 类事件的 37 个钩子脚本。其知识平面可创建带 FTS5 索引的持久化维基，支持 BM25 检索、可选向量检索、预算上限的研究循环和多模型评议。工作流以命令、代理和技能分层运行，包含开发、提交、会话收尾、上下文管理及工作树并行协作。原生插件安装面向 Claude Code；Cursor、Codex 等工具可通过 skills add 安装技能和命令包。
/learn-rule 将用户修正保存为可检索规则，SessionStart 通过 session-start.js 载入学习记录并列出已注册维基。/wiki init 创建维基，/wiki page 写入页面，/wiki ask 执行 BM25 查询；prompt-submit.js 会在 UserPromptSubmit 时按提示词注入排名靠前的维基命中。可选的 /wiki embed 使用 OPENAI_API_KEY 或 VOYAGE_API_KEY 建立嵌入，/wiki hybrid 结合 BM25、向量和 RRF；/wiki research 以预算和页数上限运行 web、arXiv、GitHub 或自定义抓取器的 BFS。/wiki council 使用 Anthropic、OpenAI、OpenRouter、Fireworks 或自定义端点进行三阶段评议，并将记录持久化为维基页面；失败的单个供应商不会中止整次运行。/develop 按 Research → Plan → Implement → Review 推进并设置验证关卡，/smart-commit、秘密扫描、破坏性 Git 操作防护和 PreCompact/PostCompact 钩子则覆盖提交与上下文压缩环节。
- 使用 Claude Code 反复被同一代码规范或测试要求纠正的开发者，可用
/learn-rule保存规则，并在后续会话自动载入。 - 需要长期研究某个技术主题的工程师，可用
/wiki init、/wiki seed和/wiki research --max-pages 5 --budget-usd 0.50建立有检索功能的本地知识库。 - 准备实现复杂功能的团队，可用
/develop让研究、规划、实现和审查按顺序经过验证关卡。 - 需要同时处理多个互不冲突改动的 Git 用户，可使用
/parallel、parallel-worktrees和batch-orchestration组织工作树中的并行任务。 - 在提交或推送前需要审查变更、检查机密信息并生成 conventional commit 的开发者，可使用
/commit或/smart-commit。
如何安装或部署这个 Agent？
Claude Code 原生安装：
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflowCursor、Codex、Copilot CLI、Gemini CLI 等已列出的代理可运行：
npx skills add rohitg00/pro-workflow随后运行 skills sync，将技能注册到目标代理配置。首次可运行 /doctor 检查 SQLite、钩子和技能是否加载，再运行 /wrap-up。手动安装路径需要克隆仓库，并执行 npm install && npm run build 后复制技能、命令、模板和钩子配置；因此需要 Node.js 与 npm。
如何使用这个 Agent？
先运行 /doctor。当需要保存纠正时使用 /learn-rule；结束会话时运行 /wrap-up。研究主题可依次执行 /wiki init <slug>、/wiki page <slug> <path> --type concept 与 /wiki ask "<问题>" --wiki <slug>。自动研究是选择性功能，可用 /wiki seed <slug> "<主题>" 后运行 /wiki research <slug> --max-pages 5 --budget-usd 0.50；创建 ~/.pro-workflow/STOP 可停止所有研究循环。混合检索需设置 OPENAI_API_KEY 或 VOYAGE_API_KEY，多模型评议需设置一个受支持的供应商凭证或自定义端点凭证。
这个 Agent 有哪些优点和局限？
- 将学习规则、会话数据和维基索引集中在同一 SQLite 存储中，并使用 FTS5 支持跨会话检索。
- 知识平面不仅能手动建页和查询，还提供预算受限的 BFS 研究循环、可选嵌入检索和可分享的单文件 HTML 维基查看器。
/develop将研究、计划、实现和审查串成有验证关卡的流程，配合提交、秘密扫描、压缩保护等钩子覆盖具体开发环节。- 原生支持 Claude Code，同时明确提供
skills add路径给 Codex、Cursor 和其他列出的代理。
- 原生插件和大量事件钩子围绕 Claude Code 设计；其他代理依赖 skills add 写入各自的原生技能目录，功能一致性需要自行验证。
- SQLite 组件需要构建；文档明确指出部分插件市场会跳过该步骤，
/doctor若显示KB: missing时需要执行 npm 构建。 - 自动研究、嵌入和多模型评议会引入网络、API 凭证及可能的模型费用；研究循环虽可设美元预算，具体费用仍取决于供应商。
- README 同时出现 41 项技能与对比表中的 34 项技能等不同统计口径，采用前应以实际安装内容核对清单。
这个 Agent 与同类方案有什么区别？
仓库的对比表将 Pro Workflow 与 Superpowers、everything-claude-code（ECC）、gstack 和 Get Shit Done（GSD）并列。表中将其差异定位为 SQLite+FTS5 自纠正记忆、持久研究维基、预算受限自动研究、混合检索、多供应商评议及 LLM 钩子；同时列出的技能、代理和命令数量并不完全相同。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Pro Workflow 当前 | 50 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 2.9k | 1 个月前 | JavaScript | Codex · Claude Code |
| Elephant-Goldfish Model (EGM) | 75 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 12k | 今天 | Python | Codex · Claude Code |
| Keep the Why | 75 · 表现良好 | Agent 插件 / 技能免费 | ★ 234 | 今天 | JavaScript | Codex · Claude Code |
| Ouroboros 自演进代理 | 48 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 1.6k | 今天 | Python | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示有权限管理（permission-tuner、safe-mode、allow/deny规则），但未提供默认最小权限配置或具体权限边界。用户确认机制存在（approval-gated agents、用户批准规则），但未明确所有外部操作均需确认。数据流透明度部分：有数据流描述（SQLite存储、hooks），但未详细说明数据流向和外部API调用。敏感数据处理：有secret-scan和secret检测，但未说明密钥存储和传输安全。依赖安全：仅一个运行时依赖better-sqlite3，但未提供漏洞扫描或锁定文件。外部影响：有commit-validate、pre-push-check等防护，但未全面覆盖所有外部操作。回滚：有compact-guard和状态保存，但未提供数据回滚机制。来源归属：有作者和仓库信息，但发布者未验证。
自一致性：README和package.json版本一致（v3.4.0），技能和命令数量一致（41 skills, 23 commands），但部分数字在比较表中不一致（如skills 34 vs 41）。依赖可用性：依赖better-sqlite3在npm上可用，但未验证版本兼容性。失败消息：有/doctor健康检查，但未提供详细的错误处理文档。
受众和场景：明确面向Claude Code用户，支持多种场景（自纠正、知识库、研究）。能力边界：列出了技能和命令，但未明确每个技能的限制。触发精度：技能描述作为触发，但未提供触发示例。环境适配：支持多种代理和操作系统，但未提供详细的配置指南。
信息架构：有清晰的目录结构（skills, commands, hooks等）。安装说明：提供了多种安装方式（marketplace, skills add, manual）。命名稳定性：命令和技能命名一致，但版本更新可能改变。示例和FAQ：有60秒教程和社区技巧，但无FAQ。已知限制：未明确列出。许可证：MIT许可证，但未提供LICENSE文件内容。版本和变更日志：有版本号，但无CHANGELOG。维护责任：有作者信息，但未明确维护承诺。
输出可用性：输出为markdown、HTML等，可直接使用。边际价值：提供了自纠正记忆和知识库，相比其他工具具有独特价值。成本效益：有成本跟踪和预算控制，但未提供性能基准。
声明可追溯：README中的声明未提供具体证据（如测试结果）。跨来源佐证：未提供第三方验证。事实与推断分离：部分声明（如'50 sessions'）未区分事实和推断。
- 发布者未验证，安装前请审查代码。
- 依赖better-sqlite3需构建，部分市场可能跳过构建步骤。
- 自动研究循环可能产生外部网络请求，注意预算和隐私。
- 权限规则生成可能降低安全性，请谨慎使用。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v3.4.0 pro-workflow v3.4.0
发布说明摘录
What's Changed - docs(infographic): redesign around one session for v3.4 (#119) - feat(hooks): add optional System 1 classifier layer (Laya/Jev) (#115) - fix(hooks): read documented payload fields and stop echoing stdin (#118) - fix(hooks): stop commit-validate blocking non-commit heredocs (#114) - chore: update model lineup, Codex mapping, and plugin version (#116) - docs(permissions): teach auto mode, autoMode config, and denial triage (#117) - fix(hooks): use regex matchers and drop unknown description keys (#112) - feat: modernize for 2026 models, workflows, and skill set (#80) …在 GitHub 查看 ↗ -
v3.3.0 pro-workflow v3.3.0
发布说明摘录
What's Changed - chore(release): bump plugin manifests to 3.3.0 - docs(v3.3): rework README + infographic for the knowledge plane era (#54) - feat(v3.3.0): wiki knowledge base + auto-research loop + multi-LLM council (#53) - deps: bump typescript from 6.0.2 to 6.0.3 (#49) - feat(hooks/rules/skills): deterministic hooks, git blast-radius guard, design rules (#48) - feat: token efficiency system — 40-60% output reduction (#40) - feat: pre-flight discipline rule (karpathy principles) (#46) - Update GitHub Sponsors username in FUNDING.yml …在 GitHub 查看 ↗ -
v3.2.0 v3.2.0 — Advanced Hooks, LLM Gates & 7 New Skills
发布说明摘录
What's New in v3.2.0 LLM-Powered Hooks (First in any Claude Code plugin) - Prompt hooks (type: "prompt") — AI-powered quality gates using Haiku - Commit message validation — Conventional commits format enforced by LLM - Secret detection — File writes scanned for hardcoded API keys and tokens - if conditionals — Precise hook filtering without spawning processes 7 New Skills (17 → 24) | Skill | What It Does | |-------|-------------| | permission-tuner | Analyze denial patterns, generate optimized allow/deny rules | …在 GitHub 查看 ↗
常见问题
自动研究会不会无限运行或超出预算？
/wiki research 支持 --budget-usd、页数和深度限制，并包含收敛检测。创建 ~/.pro-workflow/STOP 会停止所有研究循环。需要哪些 API 密钥？
OPENAI_API_KEY 或 VOYAGE_API_KEY；评议可使用 ANTHROPIC_API_KEY、OPENAI_API_KEY、OPENROUTER_API_KEY、FIREWORKS_API_KEY，或自定义端点凭证。一个评议模型供应商失败时会怎样？
llm-council 使用 Promise.allSettled，因此单个供应商失败不会让整次评议中止。它会改动哪些本地数据？
~/.pro-workflow/，包括 data.db、维基目录、评议记录、抓取器目录和停止文件；项目范围维基可保存在 <project>/.claude/wikis/<slug>/ 并提交到版本库。是否能直接用于 Codex？
npx skills add rohitg00/pro-workflow 支持的代理，安装后还需运行 skills sync。Claude Code 是唯一明确提供原生插件安装方式的平台。