一个受Oh My Zsh启发的开源项目，为Claude Code、Codex、Gemini CLI等AI编码助手提供可复用的技能、命令模板、MCP配置和工作流，实现安全、本地优先的Agent能力增强。

Agent Powerups：为编码助手打造的模块化能力扩展系统\n\n## 项目背景与动机\n\n随着Claude Code、Codex CLI、Gemini CLI等AI编码助手的普及，开发者逐渐意识到：原生Agent的能力虽然强大，但在实际工程场景中往往缺乏系统化的工作流支持。每个团队都在重复造轮子——写相似的AGENTS.md模板、配置相同的MCP服务、设计类似的代码审查流程。\n\nAgent Powerups项目正是为解决这一痛点而生。它借鉴了Oh My Zsh的插件化设计理念，打造了一个面向编码Agent的模块化能力扩展系统。项目作者将其定位为"编码助手的Oh My Zsh"，旨在提供一套经过验证、可复用、安全可控的能力组件。\n\n## 核心架构与组件设计\n\nAgent Powerups采用分层架构设计，将能力组件划分为多个独立的模块类别，每个模块都有明确的职责边界和使用规范。\n\n### 技能系统（Skills）\n\n技能系统是Agent Powerups的核心，提供了一系列可复用的Agent工作流模板。目前已发布的技能包括：\n\n- systematic-debugging：系统化调试流程，帮助Agent按步骤定位和修复问题\n- no-fluff：去除冗余内容的精炼模式，提升输出质量\n- writing-plans：结构化写作规划，适用于技术文档和方案设计\n- ai-slop-cleaner：AI生成内容的清理和优化\n- requesting-code-review与receiving-code-review：代码审查的发起与接收工作流\n- pr-triage：Pull Request的分类和优先级评估\n- repo-map：代码仓库结构映射与分析\n- bug-hunt：缺陷挖掘的系统化方法\n- safe-refactor：安全重构的指导原则\n\n这些技能以纯文本形式提供，无需额外安装即可使用，Agent只需读取相应文件即可获取完整的工作流指导。\n\n### 命令与钩子系统\n\n项目提供了命令（Commands）和钩子（Hooks）两类可执行组件：\n\n命令包采用"先审阅后执行"的设计理念，目前已发布的包括：\n- ship-check：发布前的综合检查清单\n- using-powerups-command：Powerups使用指南\n\n钩子示例提供了在特定时机触发的自动化检查：\n- no-secrets-preflight：预提交阶段的密钥泄露检查\n- handoff-summary：工作交接时的上下文摘要生成\n- validation-required：强制验证关卡\n\n这些组件都附带安全可运行的检查脚本，用户可以在实际应用前预览其行为。\n\n### MCP配置管理\n\nAgent Powerups内置了经过验证的本地MCP（Model Context Protocol）配置，目前已发布的是github-local配置，提供GitHub MCP服务的检查、冒烟测试和显式安装流程。该配置采用Docker-backed架构，确保环境隔离和可复现性。\n\n### AGENTS.md模板库\n\n项目提供了多场景的AGENTS.md starter模板，帮助团队快速建立Agent上下文规范：\n\n- typescript-app：TypeScript应用项目模板\n- python-library：Python库开发模板\n- dbt-project：数据转换项目模板\n- ml-project：机器学习项目模板\n- open-source-maintainer：开源项目维护者模板\n\n## 本地CLI工具：apx\n\nAgent Powerups配备了一个名为apx的本地CLI工具，采用Node.js实现。该工具遵循"本地优先、安全可控"的设计哲学：\n\n### 核心功能\n\n健康检查与诊断\n\napx doctor\napx doctor --full\n\n提供项目依赖、环境配置、技能完整性的全面检查。\n\n技能浏览与查询\n\napx list\napx info markitdown-file-intake\n\n支持查看可用技能目录及详细信息。\n\n多Agent咨询接口\n\napx ask-codex \"解释这段代码\" --json\napx ask-claude \"审查这个补丁\" --json\napx ask-gemini \"头脑风暴测试用例\" --json\n\n提供与Codex、Claude、Gemini的本地咨询接口。\n\nMCP配置管理\n\napx mcp check github-local --target generic\napx mcp smoke github-local --json\napx mcp install github-local --target codex --dry-run\n\n支持MCP配置的验证、测试和安装。\n\n### 安全设计原则\n\napx工具在设计上严格遵守以下安全原则：\n\n1. 无全局修改：所有操作默认作用于本地目录，不修改全局系统配置\n2. 显式确认：安装类命令默认启用--dry-run模式，需用户显式确认后才执行\n3. 先审阅后执行：命令和钩子类组件要求用户先审阅内容，再决定是否启用\n4. 依赖显式声明：所有外部工具依赖都在文档中明确列出，不假设环境已预装\n5. 无隐藏钩子：所有自动化触发机制都是显式配置，无后台自动运行机制\n\n## 工作流与集成场景\n\nAgent Powerups设计了两类典型工作流：\n\n### 功能迭代工作流（feature-iteration）\n\n该工作流指导Agent如何安全地进行功能开发迭代：\n1. 需求理解与澄清\n2. 方案设计与影响评估\n3. 增量实现与单元验证\n4. 代码审查准备\n5. 文档同步更新\n\n### Agent中继工作流（agent-relay）\n\n该工作流支持多Agent协作场景：\n\napx relay start second-opinion --provider gemini --json\napx relay ask second-opinion \"审查这个方案\" --json\napx relay stop second-opinion --json\n\n允许启动一个持续运行的次级Agent实例，作为主Agent的"第二意见"顾问。\n\n## 技术实现与生态兼容\n\nAgent Powerups在技术实现上保持保守和稳健：\n\n纯文本优先：大多数技能采用纯Markdown文本，不绑定特定Agent平台，具备最大兼容性。\n\n渐进增强：对于特定Agent（Claude Code、Codex、Gemini CLI）提供针对性的优化支持，但核心功能保持通用。\n\n实验性插件系统：项目包含一个实验性的本地插件布局（plugins/），支持确定性构建和验证，但明确声明无官方市场支持，避免用户产生误解。\n\n验证与测试：项目内置Python验证脚本，用于检查技能定义、目录结构和依赖要求的完整性。\n\n## 实际应用价值\n\nAgent Powerups的价值体现在多个维度：\n\n对个体开发者：提供经过验证的Agent使用模式，减少与AI协作时的试错成本，提升代码质量和开发效率。\n\n对技术团队：建立统一的Agent协作规范，通过标准化的AGENTS.md模板和技能定义，降低团队成员使用AI工具的门槛。\n\n对开源社区：作为一个中立的、非商业化的能力组件库，为AI辅助编程生态提供可复用的公共品。\n\n## 使用入门\n\n开始使用Agent Powerups非常简单：\n\nbash\n# 克隆仓库\ngit clone https://github.com/yeaight7/agent-powerups.git\ncd agent-powerups\n\n# 安装依赖并构建\nnpm install\nnpm run build\n\n# 运行健康检查\nnode dist/cli/apx.js doctor\n\n# 浏览可用技能\nnode dist/cli/apx.js list\n\n\n对于特定Agent的集成，项目提供了详细的配置指南，涵盖Codex、Claude Code和Gemini CLI的完整设置流程。\n\n## 总结与展望\n\nAgent Powerups代表了AI辅助编程工具向系统化、模块化方向演进的重要尝试。它不仅仅是一个工具集合，更是一种关于如何与AI编码助手高效协作的方法论。\n\n项目的核心设计理念——安全可控、本地优先、显式确认——为AI工具集成提供了值得借鉴的范式。随着Claude Code、Codex、Gemini CLI等工具的持续迭代，Agent Powerups这类能力扩展系统将成为开发者工具链中不可或缺的一环。

Agent Powerups：为编码助手打造的模块化能力扩展系统\n\n项目背景与动机\n\n随着Claude Code、Codex CLI、Gemini CLI等AI编码助手的普及，开发者逐渐意识到：原生Agent的能力虽然强大，但在实际工程场景中往往缺乏系统化的工作流支持。每个团队都在重复造轮子——写相似的AGENTS.md模板、配置相同的MCP服务、设计类似的代码审查流程。\n\nAgent Powerups项目正是为解决这一痛点而生。它借鉴了Oh My Zsh的插件化设计理念，打造了一个面向编码Agent的模块化能力扩展系统。项目作者将其定位为"编码助手的Oh My Zsh"，旨在提供一套经过验证、可复用、安全可控的能力组件。\n\n核心架构与组件设计\n\nAgent Powerups采用分层架构设计，将能力组件划分为多个独立的模块类别，每个模块都有明确的职责边界和使用规范。\n\n技能系统（Skills）\n\n技能系统是Agent Powerups的核心，提供了一系列可复用的Agent工作流模板。目前已发布的技能包括：\n\n- systematic-debugging：系统化调试流程，帮助Agent按步骤定位和修复问题\n- no-fluff：去除冗余内容的精炼模式，提升输出质量\n- writing-plans：结构化写作规划，适用于技术文档和方案设计\n- ai-slop-cleaner：AI生成内容的清理和优化\n- requesting-code-review与receiving-code-review：代码审查的发起与接收工作流\n- pr-triage：Pull Request的分类和优先级评估\n- repo-map：代码仓库结构映射与分析\n- bug-hunt：缺陷挖掘的系统化方法\n- safe-refactor：安全重构的指导原则\n\n这些技能以纯文本形式提供，无需额外安装即可使用，Agent只需读取相应文件即可获取完整的工作流指导。\n\n命令与钩子系统\n\n项目提供了命令（Commands）和钩子（Hooks）两类可执行组件：\n\n命令包采用"先审阅后执行"的设计理念，目前已发布的包括：\n- ship-check：发布前的综合检查清单\n- using-powerups-command：Powerups使用指南\n\n钩子示例提供了在特定时机触发的自动化检查：\n- no-secrets-preflight：预提交阶段的密钥泄露检查\n- handoff-summary：工作交接时的上下文摘要生成\n- validation-required：强制验证关卡\n\n这些组件都附带安全可运行的检查脚本，用户可以在实际应用前预览其行为。\n\nMCP配置管理\n\nAgent Powerups内置了经过验证的本地MCP（Model Context Protocol）配置，目前已发布的是github-local配置，提供GitHub MCP服务的检查、冒烟测试和显式安装流程。该配置采用Docker-backed架构，确保环境隔离和可复现性。\n\nAGENTS.md模板库\n\n项目提供了多场景的AGENTS.md starter模板，帮助团队快速建立Agent上下文规范：\n\n- typescript-app：TypeScript应用项目模板\n- python-library：Python库开发模板\n- dbt-project：数据转换项目模板\n- ml-project：机器学习项目模板\n- open-source-maintainer：开源项目维护者模板\n\n本地CLI工具：apx\n\nAgent Powerups配备了一个名为apx的本地CLI工具，采用Node.js实现。该工具遵循"本地优先、安全可控"的设计哲学：\n\n核心功能\n\n健康检查与诊断\n\napx doctor\napx doctor --full\n\n提供项目依赖、环境配置、技能完整性的全面检查。\n\n技能浏览与查询\n\napx list\napx info markitdown-file-intake\n\n支持查看可用技能目录及详细信息。\n\n多Agent咨询接口\n\napx ask-codex \"解释这段代码\" --json\napx ask-claude \"审查这个补丁\" --json\napx ask-gemini \"头脑风暴测试用例\" --json\n\n提供与Codex、Claude、Gemini的本地咨询接口。\n\nMCP配置管理\n\napx mcp check github-local --target generic\napx mcp smoke github-local --json\napx mcp install github-local --target codex --dry-run\n\n支持MCP配置的验证、测试和安装。\n\n安全设计原则\n\napx工具在设计上严格遵守以下安全原则：\n\n1. 无全局修改：所有操作默认作用于本地目录，不修改全局系统配置\n2. 显式确认：安装类命令默认启用--dry-run模式，需用户显式确认后才执行\n3. 先审阅后执行：命令和钩子类组件要求用户先审阅内容，再决定是否启用\n4. 依赖显式声明：所有外部工具依赖都在文档中明确列出，不假设环境已预装\n5. 无隐藏钩子：所有自动化触发机制都是显式配置，无后台自动运行机制\n\n工作流与集成场景\n\nAgent Powerups设计了两类典型工作流：\n\n功能迭代工作流（feature-iteration）\n\n该工作流指导Agent如何安全地进行功能开发迭代：\n1. 需求理解与澄清\n2. 方案设计与影响评估\n3. 增量实现与单元验证\n4. 代码审查准备\n5. 文档同步更新\n\nAgent中继工作流（agent-relay）\n\n该工作流支持多Agent协作场景：\n\napx relay start second-opinion --provider gemini --json\napx relay ask second-opinion \"审查这个方案\" --json\napx relay stop second-opinion --json\n\n允许启动一个持续运行的次级Agent实例，作为主Agent的"第二意见"顾问。\n\n技术实现与生态兼容\n\nAgent Powerups在技术实现上保持保守和稳健：\n\n纯文本优先：大多数技能采用纯Markdown文本，不绑定特定Agent平台，具备最大兼容性。\n\n渐进增强：对于特定Agent（Claude Code、Codex、Gemini CLI）提供针对性的优化支持，但核心功能保持通用。\n\n实验性插件系统：项目包含一个实验性的本地插件布局（plugins/），支持确定性构建和验证，但明确声明无官方市场支持，避免用户产生误解。\n\n验证与测试：项目内置Python验证脚本，用于检查技能定义、目录结构和依赖要求的完整性。\n\n实际应用价值\n\nAgent Powerups的价值体现在多个维度：\n\n对个体开发者：提供经过验证的Agent使用模式，减少与AI协作时的试错成本，提升代码质量和开发效率。\n\n对技术团队：建立统一的Agent协作规范，通过标准化的AGENTS.md模板和技能定义，降低团队成员使用AI工具的门槛。\n\n对开源社区：作为一个中立的、非商业化的能力组件库，为AI辅助编程生态提供可复用的公共品。\n\n使用入门\n\n开始使用Agent Powerups非常简单：\n\nbash\n克隆仓库\ngit clone https://github.com/yeaight7/agent-powerups.git\ncd agent-powerups\n\n安装依赖并构建\nnpm install\nnpm run build\n\n运行健康检查\nnode dist/cli/apx.js doctor\n\n浏览可用技能\nnode dist/cli/apx.js list\n\n\n对于特定Agent的集成，项目提供了详细的配置指南，涵盖Codex、Claude Code和Gemini CLI的完整设置流程。\n\n总结与展望\n\nAgent Powerups代表了AI辅助编程工具向系统化、模块化方向演进的重要尝试。它不仅仅是一个工具集合，更是一种关于如何与AI编码助手高效协作的方法论。\n\n项目的核心设计理念——安全可控、本地优先、显式确认——为AI工具集成提供了值得借鉴的范式。随着Claude Code、Codex、Gemini CLI等工具的持续迭代，Agent Powerups这类能力扩展系统将成为开发者工具链中不可或缺的一环。