Pro Workflow
让编码助手通过持久记忆、研究维基和质量关卡减少重复纠正。
按维度查看评分与理由
证据显示有权限管理(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需构建,部分市场可能跳过构建步骤。
- 自动研究循环可能产生外部网络请求,注意预算和隐私。
- 权限规则生成可能降低安全性,请谨慎使用。
这个 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 有哪些优点和局限?
- 将学习规则、会话数据和维基索引集中在同一 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?
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 与同类方案有什么区别?
仓库的对比表将 Pro Workflow 与 Superpowers、everything-claude-code(ECC)、gstack 和 Get Shit Done(GSD)并列。表中将其差异定位为 SQLite+FTS5 自纠正记忆、持久研究维基、预算受限自动研究、混合检索、多供应商评议及 LLM 钩子;同时列出的技能、代理和命令数量并不完全相同。
常见问题
自动研究会不会无限运行或超出预算?
/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 是唯一明确提供原生插件安装方式的平台。