PopKit是一个模块化插件系统，为Claude Code提供23个命令、38个技能和22个专业代理，通过晨间例行检查、智能下一步推荐、分阶段功能开发等特性，将AI编码从"工具使用"提升为"工作流驱动"。

PopKit：为Claude Code打造的AI驱动开发工作流自动化套件\n\n## 项目概述\n\nPopKit是一个专为Claude Code设计的AI驱动开发工作流自动化系统。与大多数AI编码助手仅仅提供"一个提示框让你自己摸索"不同，PopKit构建了一套完整的工作流体系，将AI能力组织成可预测、可重复的软件开发流程。这个项目由jrc1883开发，采用模块化插件架构，包含23个命令、38个技能和22个专业代理，旨在让开发者从"使用AI工具"跃迁到"用AI构建软件"。\n\n## 核心理念：从工具到工作流\n\n### AI辅助开发的痛点\n\n当前大多数AI编码助手面临一个根本性问题：它们提供了强大的能力，但没有告诉用户如何有效使用。开发者拿到的是一个空白的提示框和一句"请描述你的需求"，然后就被丢进了一个没有导航的迷宫。这种"工具导向"而非"工作流导向"的设计，导致AI的潜力远未被充分发挥。\n\n### PopKit的解决方案\n\nPopKit的核心理念是将AI能力嵌入到结构化的开发工作流中。它不提供零散的工具，而是提供：\n\n- 晨间例行检查：在写代码前自动检查项目健康状态\n- 智能下一步推荐：基于git状态、测试失败和待解决问题给出行动建议\n- 分阶段功能开发：引导开发者按七个阶段完成功能实现\n- 会话捕获：保存开发上下文，让第二天能无缝接续\n\n这种设计哲学可以用一句话概括：不是"给你一个人工智能"，而是"告诉你如何用人工智能构建软件"。\n\n## 双层架构设计\n\n### 工作流命令层（/popkit-）\n\nPopKit故意暴露两个使用层次。第一层是面向用户的工作流命令，以/popkit-为前缀。这些命令提供跨命令、技能和钩子的高级编排，是大多数用户的默认入口。\n\n例如，/popkit-dev:next内部调用pop-next-action技能，但额外添加了模式处理、报告生成和命令级指导。这种封装让用户体验更加流畅，同时保持底层能力的可访问性。\n\n### 直接技能层（/pop）\n\n第二层是直接技能层，以/pop-为前缀。这些是低级别的原语，供高级用户进行针对性或高级调用。当用户需要绕过工作流的预设逻辑，直接访问某个特定能力时，可以使用这一层。\n\n这种双层设计既保证了新用户的易用性，又为高级用户保留了灵活性，是一种深思熟虑的架构决策。\n\n## 晨间例行：项目健康检查\n\n### 启动前的全面体检\n\n每个工作日开始时，PopKit可以运行晨间例行检查：\n\n\n/popkit-dev:routine morning\n\n\n这个命令会生成一份详细的项目健康报告，包括：\n\n- 会话恢复状态：显示上次工作的内容和时长\n- 就绪评分：一个0-100的分数，评估当前是否适合开始编码\n- Git状态：检查是否有未提交的更改\n- 测试结果：显示测试通过情况\n- CI状态：检查主分支的持续集成状态\n- 依赖更新：提示可用的依赖更新\n- 类型检查：扫描TypeScript错误\n\n### 就绪评分的价值\n\n"就绪评分"（Ready to Code Score）是PopKit的一个创新概念。87分意味着项目状态良好，可以开始编码；45分则意味着有重要问题需要先解决。这种量化的健康指标帮助开发者在做决策前获得全面的上下文信息，避免在问题状态下盲目推进。\n\n## 智能下一步：决策辅助\n\n### 告别"该做什么"的困惑\n\n当开发者不确定接下来该做什么时，可以运行：\n\n\n/popkit-dev:next\n\n\nPopKit会分析多个数据源，给出优先排序的行动建议：\n\n1. 合并建议：如果分支落后主分支太多，建议先合并\n2. 错误修复：列出TypeScript错误和具体位置\n3. 继续进行中任务：基于GitHub issues推荐继续开发\n4. 代码审查提醒：提示等待审查的PR\n\n每个建议都附带一个分数，表示优先级。这种基于数据的决策辅助消除了" staring at your terminal wondering what to do"（盯着终端不知道该做什么）的常见困境。\n\n### 多维度分析\n\nPopKit的分析不仅基于单一数据源，而是综合了：\n\n- Git状态（分支、提交、差异）\n- 测试结果（失败测试的位置和影响）\n- GitHub issues（开放问题和标签）\n- TypeScript错误（类型系统的反馈）\n\n这种多维度分析确保推荐既全面又准确。\n\n## 分阶段功能开发\n\n### 七阶段开发流程\n\nPopKit将功能开发分解为七个明确的阶段：\n\n1. 发现（Discovery）：明确我们要构建什么\n2. 探索（Exploration）：了解代码库中存在的模式\n3. 提问（Questions）：在编码前澄清需求\n4. 架构（Architecture）：确定代码结构\n5. 实现（Implementation）：分阶段编写代码\n6. 审查（Review）：检查构建的内容\n7. 总结（Summary）：记录变更内容\n\n每个阶段都有检查点，用户批准后才进入下一阶段。这种设计防止了AI"一股脑生成代码"的常见问题，确保开发过程是可控和可审查的。\n\n### 命令式启动\n\n要开始一个新功能，只需运行：\n\n\n/popkit-dev:dev \"Add password reset via email\"\n\n\nPopKit会引导用户逐步完成上述七个阶段，在每个阶段提供相关的上下文和建议。这种引导式开发特别适合复杂功能或在不熟悉的代码库中工作。\n\n## 夜间例行：上下文保存\n\n### 结束工作日的仪式\n\n一天工作结束时，运行夜间例行：\n\n\n/popkit-dev:routine nightly\n\n\n这会生成一份"睡眠评分"（Sleep Score），评估当天工作的收尾质量：\n\n- 所有更改是否已提交\n- 分支是否已推送到远程\n- 测试是否通过\n- 是否有未提交的stash\n- 会话分支是否干净\n\n### 会话捕获\n\n夜间例行还会捕获当前会话的上下文：\n\n- 已完成工作：简要描述当天实现的内容\n- 下一步计划：记录明天要继续的任务\n- 依赖状态：提示可用的安全更新\n\n这些捕获的上下文会在第二天的晨间例行中自动恢复，实现无缝的工作接续。\n\n## 混合智能策略\n\n### 程序化与AI的结合\n\nPopKit采用一种务实的混合策略：\n\n| 方面 | 方法 | 原因 |\n|------|------|------|\n| Git操作 | 程序化脚本 | 精确、可重复 |\n| 类型检查 | 基于规则（tsc） | 标准化、可靠 |\n| 状态管理 | 显式JSON | 透明、可调试 |\n| 架构决策 | AI判断 | 需要推理和权衡 |\n| 代码审查 | AI辅助 | 需要模式识别 |\n| 任务优先级 | AI推荐 | 需要综合判断 |\n\n这种区分让AI专注于它真正擅长的事情（判断、推理、综合），而将可程序化的事情交给脚本处理。结果是更低的token使用量、更可重复的工作流，以及更聚焦的AI能力应用。\n\n## 工作树管理：并行开发\n\n### 多特性同时开发\n\n对于需要同时处理多个功能的场景，PopKit提供了工作树管理功能：\n\n\n/popkit-dev:worktree list\n\n\nPopKit在git工作树之上添加了批量操作和健康分析：\n\n- update-all：一次性拉取所有工作树的最新更改\n- analyze：获取关于陈旧工作树、未提交更改的建议\n- init：根据分支模式自动创建工作树\n\n这消除了手动管理工作树的繁琐，让并行开发变得更加流畅。\n\n## 模块化插件系统\n\n### 按需安装\n\nPopKit采用模块化设计，用户可以根据需要安装不同的插件：\n\n| 插件 | 功能 |\n|------|------|\n| popkit-core | 项目设置、Power Mode（多代理）、会话管理 |\n| popkit-dev | Git工作流、工作树、例行检查、/next推荐 |\n| popkit-ops | 质量评估、安全扫描、调试、部署管道 |\n| popkit-research | 知识捕获、研究笔记、文档同步 |\n\n### 安装方式\n\n安装非常简单：\n\nbash\n# 添加市场\n/plugin marketplace add jrc1883/popkit-claude\n\n# 安装所需插件\n/plugin install popkit-core@popkit-claude\n/plugin install popkit-dev@popkit-claude\n\n\n这种模块化设计让用户可以从小规模开始，随着需求增长逐步扩展功能。\n\n## MCP服务器支持\n\n### 跨客户端兼容\n\nPopKit提供MCP（Model Context Protocol）服务器实现，使其可以与Cursor、Codex CLI、Copilot等任何MCP客户端配合使用：\n\nbash\npip install popkit-mcp\npopkit-mcp --transport stdio\n\n\n对于VS Code Insiders用户，还提供了便捷的安装徽章，一键配置MCP服务器。\n\n### 完整安装选项\n\n用户可以根据需要选择安装范围：\n\nbash\n# 仅MCP服务器\npip install popkit-mcp\n\n# 完整安装（CLI + 共享工具 + MCP服务器）\npip install popkit[full]\n\n# 单独组件\npip install popkit-shared # 仅核心工具\npip install popkit-cli # 仅CLI\npip install popkit[mcp] # 核心 + CLI + MCP\n\n\n## 技术栈与要求\n\n### 系统要求\n\n- Claude Code 2.1.33+（测试至2.1.80）\n- Python 3.11+\n- Git\n- GitHub CLI (gh)（用于GitHub集成）\n\n### 版本状态\n\n当前版本：1.0.0-beta.12\n状态：公开测试版——核心功能稳定，持续改进中\n\n### 许可证\n\n采用PolyForm Noncommercial 1.0.0许可证，对个人、教育和非商业用途免费。\n\n## 总结与展望\n\nPopKit代表了AI辅助开发的一个重要演进方向：从提供工具到提供工作流。它认识到AI编码助手的价值不仅在于生成代码的能力，更在于将AI能力整合到结构化的、可重复的开发流程中。\n\n对于个人开发者，PopKit提供了日常工作的节奏和结构；对于团队，它提供了可共享的开发实践和上下文管理机制。随着AI在软件开发中扮演越来越重要的角色，像PopKit这样的工作流自动化工具将成为提升生产力的关键基础设施。\n\n项目的模块化设计和MCP支持也展示了良好的架构前瞻性，使其能够适应不断变化的AI工具生态。对于已经在使用Claude Code的开发者，PopKit值得认真考虑作为提升开发效率的下一个步骤。

PopKit：为Claude Code打造的AI驱动开发工作流自动化套件\n\n项目概述\n\nPopKit是一个专为Claude Code设计的AI驱动开发工作流自动化系统。与大多数AI编码助手仅仅提供"一个提示框让你自己摸索"不同，PopKit构建了一套完整的工作流体系，将AI能力组织成可预测、可重复的软件开发流程。这个项目由jrc1883开发，采用模块化插件架构，包含23个命令、38个技能和22个专业代理，旨在让开发者从"使用AI工具"跃迁到"用AI构建软件"。\n\n核心理念：从工具到工作流\n\nAI辅助开发的痛点\n\n当前大多数AI编码助手面临一个根本性问题：它们提供了强大的能力，但没有告诉用户如何有效使用。开发者拿到的是一个空白的提示框和一句"请描述你的需求"，然后就被丢进了一个没有导航的迷宫。这种"工具导向"而非"工作流导向"的设计，导致AI的潜力远未被充分发挥。\n\nPopKit的解决方案\n\nPopKit的核心理念是将AI能力嵌入到结构化的开发工作流中。它不提供零散的工具，而是提供：\n\n- 晨间例行检查：在写代码前自动检查项目健康状态\n- 智能下一步推荐：基于git状态、测试失败和待解决问题给出行动建议\n- 分阶段功能开发：引导开发者按七个阶段完成功能实现\n- 会话捕获：保存开发上下文，让第二天能无缝接续\n\n这种设计哲学可以用一句话概括：不是"给你一个人工智能"，而是"告诉你如何用人工智能构建软件"。\n\n双层架构设计\n\n工作流命令层（/popkit-）\n\nPopKit故意暴露两个使用层次。第一层是面向用户的工作流命令，以/popkit-为前缀。这些命令提供跨命令、技能和钩子的高级编排，是大多数用户的默认入口。\n\n例如，/popkit-dev:next内部调用pop-next-action技能，但额外添加了模式处理、报告生成和命令级指导。这种封装让用户体验更加流畅，同时保持底层能力的可访问性。\n\n直接技能层（/pop）\n\n第二层是直接技能层，以/pop-为前缀。这些是低级别的原语，供高级用户进行针对性或高级调用。当用户需要绕过工作流的预设逻辑，直接访问某个特定能力时，可以使用这一层。\n\n这种双层设计既保证了新用户的易用性，又为高级用户保留了灵活性，是一种深思熟虑的架构决策。\n\n晨间例行：项目健康检查\n\n启动前的全面体检\n\n每个工作日开始时，PopKit可以运行晨间例行检查：\n\n\n/popkit-dev:routine morning\n\n\n这个命令会生成一份详细的项目健康报告，包括：\n\n- 会话恢复状态：显示上次工作的内容和时长\n- 就绪评分：一个0-100的分数，评估当前是否适合开始编码\n- Git状态：检查是否有未提交的更改\n- 测试结果：显示测试通过情况\n- CI状态：检查主分支的持续集成状态\n- 依赖更新：提示可用的依赖更新\n- 类型检查：扫描TypeScript错误\n\n就绪评分的价值\n\n"就绪评分"（Ready to Code Score）是PopKit的一个创新概念。87分意味着项目状态良好，可以开始编码；45分则意味着有重要问题需要先解决。这种量化的健康指标帮助开发者在做决策前获得全面的上下文信息，避免在问题状态下盲目推进。\n\n智能下一步：决策辅助\n\n告别"该做什么"的困惑\n\n当开发者不确定接下来该做什么时，可以运行：\n\n\n/popkit-dev:next\n\n\nPopKit会分析多个数据源，给出优先排序的行动建议：\n\n1. 合并建议：如果分支落后主分支太多，建议先合并\n2. 错误修复：列出TypeScript错误和具体位置\n3. 继续进行中任务：基于GitHub issues推荐继续开发\n4. 代码审查提醒：提示等待审查的PR\n\n每个建议都附带一个分数，表示优先级。这种基于数据的决策辅助消除了" staring at your terminal wondering what to do"（盯着终端不知道该做什么）的常见困境。\n\n多维度分析\n\nPopKit的分析不仅基于单一数据源，而是综合了：\n\n- Git状态（分支、提交、差异）\n- 测试结果（失败测试的位置和影响）\n- GitHub issues（开放问题和标签）\n- TypeScript错误（类型系统的反馈）\n\n这种多维度分析确保推荐既全面又准确。\n\n分阶段功能开发\n\n七阶段开发流程\n\nPopKit将功能开发分解为七个明确的阶段：\n\n1. 发现（Discovery）：明确我们要构建什么\n2. 探索（Exploration）：了解代码库中存在的模式\n3. 提问（Questions）：在编码前澄清需求\n4. 架构（Architecture）：确定代码结构\n5. 实现（Implementation）：分阶段编写代码\n6. 审查（Review）：检查构建的内容\n7. 总结（Summary）：记录变更内容\n\n每个阶段都有检查点，用户批准后才进入下一阶段。这种设计防止了AI"一股脑生成代码"的常见问题，确保开发过程是可控和可审查的。\n\n命令式启动\n\n要开始一个新功能，只需运行：\n\n\n/popkit-dev:dev \"Add password reset via email\"\n\n\nPopKit会引导用户逐步完成上述七个阶段，在每个阶段提供相关的上下文和建议。这种引导式开发特别适合复杂功能或在不熟悉的代码库中工作。\n\n夜间例行：上下文保存\n\n结束工作日的仪式\n\n一天工作结束时，运行夜间例行：\n\n\n/popkit-dev:routine nightly\n\n\n这会生成一份"睡眠评分"（Sleep Score），评估当天工作的收尾质量：\n\n- 所有更改是否已提交\n- 分支是否已推送到远程\n- 测试是否通过\n- 是否有未提交的stash\n- 会话分支是否干净\n\n会话捕获\n\n夜间例行还会捕获当前会话的上下文：\n\n- 已完成工作：简要描述当天实现的内容\n- 下一步计划：记录明天要继续的任务\n- 依赖状态：提示可用的安全更新\n\n这些捕获的上下文会在第二天的晨间例行中自动恢复，实现无缝的工作接续。\n\n混合智能策略\n\n程序化与AI的结合\n\nPopKit采用一种务实的混合策略：\n\n| 方面 | 方法 | 原因 |\n|------|------|------|\n| Git操作 | 程序化脚本 | 精确、可重复 |\n| 类型检查 | 基于规则（tsc） | 标准化、可靠 |\n| 状态管理 | 显式JSON | 透明、可调试 |\n| 架构决策 | AI判断 | 需要推理和权衡 |\n| 代码审查 | AI辅助 | 需要模式识别 |\n| 任务优先级 | AI推荐 | 需要综合判断 |\n\n这种区分让AI专注于它真正擅长的事情（判断、推理、综合），而将可程序化的事情交给脚本处理。结果是更低的token使用量、更可重复的工作流，以及更聚焦的AI能力应用。\n\n工作树管理：并行开发\n\n多特性同时开发\n\n对于需要同时处理多个功能的场景，PopKit提供了工作树管理功能：\n\n\n/popkit-dev:worktree list\n\n\nPopKit在git工作树之上添加了批量操作和健康分析：\n\n- update-all：一次性拉取所有工作树的最新更改\n- analyze：获取关于陈旧工作树、未提交更改的建议\n- init：根据分支模式自动创建工作树\n\n这消除了手动管理工作树的繁琐，让并行开发变得更加流畅。\n\n模块化插件系统\n\n按需安装\n\nPopKit采用模块化设计，用户可以根据需要安装不同的插件：\n\n| 插件 | 功能 |\n|------|------|\n| popkit-core | 项目设置、Power Mode（多代理）、会话管理 |\n| popkit-dev | Git工作流、工作树、例行检查、/next推荐 |\n| popkit-ops | 质量评估、安全扫描、调试、部署管道 |\n| popkit-research | 知识捕获、研究笔记、文档同步 |\n\n安装方式\n\n安装非常简单：\n\nbash\n添加市场\n/plugin marketplace add jrc1883/popkit-claude\n\n安装所需插件\n/plugin install popkit-core@popkit-claude\n/plugin install popkit-dev@popkit-claude\n\n\n这种模块化设计让用户可以从小规模开始，随着需求增长逐步扩展功能。\n\nMCP服务器支持\n\n跨客户端兼容\n\nPopKit提供MCP（Model Context Protocol）服务器实现，使其可以与Cursor、Codex CLI、Copilot等任何MCP客户端配合使用：\n\nbash\npip install popkit-mcp\npopkit-mcp --transport stdio\n\n\n对于VS Code Insiders用户，还提供了便捷的安装徽章，一键配置MCP服务器。\n\n完整安装选项\n\n用户可以根据需要选择安装范围：\n\nbash\n仅MCP服务器\npip install popkit-mcp\n\n完整安装（CLI + 共享工具 + MCP服务器）\npip install popkit[full]\n\n单独组件\npip install popkit-shared 仅核心工具\npip install popkit-cli 仅CLI\npip install popkit[mcp] 核心 + CLI + MCP\n\n\n技术栈与要求\n\n系统要求\n\n- Claude Code 2.1.33+（测试至2.1.80）\n- Python 3.11+\n- Git\n- GitHub CLI (gh)（用于GitHub集成）\n\n版本状态\n\n当前版本：1.0.0-beta.12\n状态：公开测试版——核心功能稳定，持续改进中\n\n许可证\n\n采用PolyForm Noncommercial 1.0.0许可证，对个人、教育和非商业用途免费。\n\n总结与展望\n\nPopKit代表了AI辅助开发的一个重要演进方向：从提供工具到提供工作流。它认识到AI编码助手的价值不仅在于生成代码的能力，更在于将AI能力整合到结构化的、可重复的开发流程中。\n\n对于个人开发者，PopKit提供了日常工作的节奏和结构；对于团队，它提供了可共享的开发实践和上下文管理机制。随着AI在软件开发中扮演越来越重要的角色，像PopKit这样的工作流自动化工具将成为提升生产力的关键基础设施。\n\n项目的模块化设计和MCP支持也展示了良好的架构前瞻性，使其能够适应不断变化的AI工具生态。对于已经在使用Claude Code的开发者，PopKit值得认真考虑作为提升开发效率的下一个步骤。