源码简介
这套源码属于 AI 编程辅助工具类项目，核心是一组可即插即用到各类 AI 编程助手的「技能（skills）」方法论。superpowers-zh 是热门 superpowers 框架的中文增强版，以 Node.js CLI 包（npm 发布）的形式分发，把 20 个经过实战验证的 AI 编码工作流（需求分析、TDD、系统化调试、代码审查、并行 Agent 等）安装到 Claude Code、Cursor、Codex、Gemini CLI 等 18 款工具目录里，让这些工具在合适时机自动调用对应方法论。源码本身零运行时依赖，适合学习 AI 编码工作流设计、插件打包与二次开发。
适用场景
- 给 Claude Code / Cursor / Codex 等 AI 编程工具扩展即插即用的工作流技能
- 团队统一 AI 编码规范（TDD、代码审查、调试、中文 Git 提交与文档）
- 基于 SKILL.md 格式二次开发，自建或改写符合自身业务的方法论
技术栈与运行环境
- 前端：无界面；官方文档站由 site/build.mjs 零依赖生成静态页（原生 JS + 模板）
- 后端：无服务；bin/superpowers-zh.js 为 Node.js 命令行脚本
- 数据库：无
- 运行环境：Node.js >= 20，npm / npx
- 其他依赖：零运行时依赖，仅使用 fs / path / os 等内置模块
功能亮点
- 内置 20 个 AI 编程技能：涵盖 brainstorming 需求分析、systematic-debugging 四阶段调试、test-driven-development、requesting-code-review 代码审查、dispatching-parallel-agents 并行 Agent、subagent-driven-development 子 Agent 开发等（skills/*/SKILL.md 均有完整 frontmatter 与正文）。
- 一键安装到 18 款工具：bin/superpowers-zh.js 内置 TARGETS 检测表，运行 `npx superpowers-zh` 自动识别当前项目所用 AI 工具并把 skills 复制到对应目录（如 .claude/skills、.cursor/skills），识别不出可用 `–tool` 显式指定。
- 6 个中文特色技能：chinese-code-review、chinese-git-workflow、chinese-documentation、chinese-commit-conventions 适配国内团队沟通与规范；mcp-builder 提供生产级 MCP 服务器构建方法论（skills/ 下目录可见）。
- 多工具插件清单与钩子：提供 .claude-plugin / .cursor-plugin / .codex-plugin / .kimi-plugin / .opencode / .pi 等插件清单，并带 SessionStart 钩子（hooks/hooks.json）让技能在会话启动时自动加载。
- 零依赖文档站生成器：site/build.mjs 直接读取 skills/*/SKILL.md 渲染中英文静态站点与每个技能详情页，内容与源文件同步不漂移。
- 安全卸载机制：–uninstall 用哨兵注释精确切除写入的 bootstrap 段、清理 skills 目录，并保留用户原有内容，避免误删。
安装与部署提示
- 环境准备：本地安装 Node.js >= 20 与 npm。
- 进入你的 AI 项目目录（避免在主目录 ~ 下运行，防止污染所有项目），执行 `npx superpowers-zh` 自动检测并安装；检测不到时用 `npx superpowers-zh –tool cursor` 之类显式指定工具。
- 二次开发 / 源码研究：直接克隆仓库，阅读 skills/ 下的 SKILL.md 与 bin/superpowers-zh.js 的安装逻辑；卸载用 `npx superpowers-zh –uninstall`。
截图与演示说明
常见问题
这套源码需要数据库或后端服务吗？
不需要。它本质是 Node.js CLI 脚本加一组 Markdown 格式的方法论文档（SKILL.md），零运行时依赖，装到 AI 工具目录后由工具读取调用，没有数据库，也没有需要常驻运行的服务进程。
适合二次开发吗？
适合。skills/ 下每个技能都是独立的 SKILL.md，含 name / description / version 等 frontmatter，结构清晰、易扩展；可在其基础上新增或改写中文技能，也可参照 mcp-builder 等扩展自己的方法论。bin/superpowers-zh.js 的 TARGETS 数组与工具别名映射也容易改造以适配更多 AI 编程工具。
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。本仓库基于 MIT 协议开源，可自由使用、修改与分发，但请保留原始版权与许可声明。
开源地址：https://github.com/jnMetaCode/superpowers-zh
