1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | pro-workflow |
| 作者/维护者 | rohitg00(个人开发者) |
| 来源链接 | https://github.com/rohitg00/pro-workflow |
| 许可证 | package.json 与 README 徽章均声明 MIT,但仓库未附正式 LICENSE 文件(数据来自 GitHub API 与仓库文件核查) |
| GitHub Stars | 2723(数据来自 GitHub API) |
| Forks | 266(数据来自 GitHub API) |
| 最新版本 | package.json 标注 v3.4.0;最近一次正式 GitHub Release 为 v3.3.0(2026-05-09) |
| 安装方式 | Claude Code 官方插件市场一条命令;跨 agent 用 npx skills add;或手动 clone 复制 |
2. 功能介绍与亮点
pro-workflow 围绕单一本地 SQLite 存储构建:41 个 SKILL.md、8 个 agent、23 个命令、覆盖 24 类事件的 hook 脚本。核心能力:
- 自我纠错循环:每次纠正都可固化为规则写入 SQLite,后续会话自动加载
- Pre-flight Discipline:编码前显式列出假设、拒绝无关的顺手改动
- 并行 Worktree 管理:原生支持隔离的并行编码会话
- 知识平面:基于 SQLite FTS5 的持久化 Wiki,可选“自动研究循环”按预算/深度上限抓取 Web/arXiv/GitHub 来源,随时可 kill-switch 中止
- 质量门禁:LLM 驱动的 hook(如提交信息校验)、确定性 git/secret 防护
运行时依赖极简(仅一个第三方包),源码开源可审计;核心功能全部免费,仅“多 LLM 议会”“混合向量检索”等进阶功能需自备第三方 API Key。
3. 适用场景
固定分类:元技能与 Agent 增强。适合长期高频使用编码 agent、厌倦反复纠正同一类错误的开发者;适合需要项目知识随时间自动沉淀的团队;也适合希望在提交前用 hook 自动拦截低质量改动的工程团队。
4. 跨 Agent 兼容性
- Claude Code:原生支持,官方插件市场一条命令安装,附带专属 hook/plugin manifest
- Codex / OpenClaw:README 声称可经第三方安装器
npx skills add装入 32+ agent 原生技能目录(含 Codex)——该安装器目前有一条未处理的公开 issue,指控其未经同意上传使用数据,详见第 10 章;OpenClaw 未在官方支持列表被点名,未验证 - Hermes Agent:官方文档未提及,未验证
5. 推荐理由
用单一本地 SQLite 把“纠错 → 固化成规则 → 自动加载”沉淀成可复利的自我改进闭环,并配套质量门禁 hook 与并行 worktree 工作流——同类持久记忆方案大多只解决记忆检索一个环节,pro-workflow 把范围扩展到完整开发工作流管理。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 仓库 2026-02-01 创建,半年内积累 2723 star / 266 fork;2026-07-27 仍有代码推送,issue 区持续有具体技术反馈与修复 |
| 可用性 | 8 | Claude Code 一条命令通过官方插件市场安装;核心的自纠错、wrap-up、Wiki 功能完全免费、无需 API Key;文档详尽(README + 独立 Mintlify 文档站) |
| 安全性 | 7 | 见下方检查清单 |
安全检查清单:
| 检查项 | 结果 |
|---|---|
| ①shell 执行 | 有(覆盖 24 类事件的 hook 脚本),均为本地开发工作流操作,权限与用途一一对应,源码开源可读 |
| ②联网外发 | 核心功能不联网;“Wiki 自动研究循环”是显式 opt-in 功能,抓取有预算/深度上限并可随时 kill-switch 中止 |
| ③API/凭据 | 仅进阶功能需自备 ANTHROPIC_API_KEY 等标准环境变量,不落盘明文存储 |
| ④可疑指令 | 未见提示注入或混淆代码迹象;运行时依赖极简(仅一个第三方包) |
| ⑤作者信誉 | 个人开发者,无造假迹象 |
| ⑥License | package.json 与 README 均声明 MIT,但仓库未附正式 LICENSE 文件 |
| ⑦维护 | 近期仍有代码提交与 issue 修复响应,活跃 |
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与 pro-workflow 的差异 |
|---|---|---|
| claude-mem(thedotmack) | 本地优先的持久记忆系统,自动压缩上下文并跨会话检索注入 | 聚焦记忆检索单一环节;pro-workflow 把记忆做成 41 个技能之一,额外覆盖并行 worktree、质量门禁 hook、Wiki 自动研究等完整开发流程 |
| self-learning-skills(Kulaxyz) | 零成本一条命令安装,把摸索出的成功路径固化为可复用技能 | 产出物是“技能”;pro-workflow 产出物是“规则 + Wiki 知识页”,且额外提供质量门禁与并行会话管理 |
| supermemory(supermemoryai) | 开源、活跃维护的 AI agent 记忆与个性化上下文基础设施,面向多产品接入 | 定位为通用记忆基础设施服务;pro-workflow 是绑定 Claude Code 工作流的一体化本地系统,无需接入外部服务 |
8. 用户评价
该技能目前在第三方平台尚无经查证的具名用户评价。可查证的第三方互动仅有一次:项目曾被提交给社区列表 awesome-claude-code 收录,因未走官方网页表单流程被自动回复要求重新提交,与质量评价无关。
9. 安装使用方式
- Claude Code(推荐):
/plugin marketplace add rohitg00/pro-workflow→/plugin install pro-workflow@pro-workflow;装完运行/doctor确认加载正常,再/wrap-up冒烟测试 - 跨 agent(Cursor/Codex/Gemini CLI 等 32+):
npx skills add rohitg00/pro-workflow后执行skills sync注册(风险见第 10 章) - 手动安装:
git clone→npm install && npm run build→ 复制skills/、commands/、hooks/hooks.json到对应 agent 的技能目录 - 常用命令:
/learn-rule捕获纠错规则、/wrap-up结束会话并持久化学习、/wiki init <slug>建 Wiki、/smart-commit提交前质量门禁
10. 注意事项
- 仓库未附正式 LICENSE 文件,MIT 许可证效力建议使用前自行核实
- 部分 marketplace 分发渠道跳过了 SQLite 组件构建,若
/doctor报告KB: missing,需手动npm install && npm run build - 跨 agent 推荐的
npx skills add依赖第三方 CLIvercel-labs/skills,该 CLI 有一条未处理的公开 issue 指控其未经同意上传使用数据,Claude Code 原生插件市场安装不受影响 - 进阶功能依赖自备第三方 API Key,不属于开箱即用范围
- 最近一次正式 Release 为 2026-05-09(v3.3.0),晚于 package.json 标注的 v3.4.0