让 AI 编程工具真正会干活:superpowers-zh 超能力中文增强版完全指南

你的 AI 编程助手是不是也这样：代码写得挺溜，但让它查个日志、管个权限、调个 API 就抓瞎？不是它笨，是你没给它装”技能包”。

一、为什么你的 AI 编程工具”不太会用”？

上周有个朋友找我吐槽：”花 20 美元买了 Copilot，结果它除了写代码啥也不会。我想让它帮我看看 GitHub 上的 PR 状态，它让我自己去网页看；想让它生成个测试报告，它说没有这个功能。”

我问他：”你装 skills 了吗？”

他一脸懵：”啥玩意儿？”

这就是问题所在。大多数 AI 编程工具（Claude Code、Cursor、Windsurf、OpenClaw 等）默认只带”基础能力”——写代码、改 bug、解释逻辑。但真实开发场景远不止这些：

• • 你要查 CI/CD 构建日志
• • 你要管理 Git 分支和 PR
• • 你要调用外部 API 获取数据
• • 你要生成专业的 Word/PDF 报告
• • 你要把文章发到公众号
• • 你要诊断服务器连接问题

superpowers 就是来解决这个问题的。它是一个技能系统，给 AI 装上各种”超能力”，让它真正能干活。

而 superpowers-zh 是完整汉化 + 中国本土化增强版，在原版基础上新增了 6 个中国原创 skills，覆盖微信公众号、飞书、小红书、B 站等国内平台。

简单说：原版让 AI 会编程，中文版让 AI 会在中国编程。

二、superpowers-zh 是什么？

项目背景

superpowers 原版是 GitHub 上 116k+ ⭐ 的热门项目，目标是为 AI 编程工具提供标准化技能系统。但由于文化差异和使用场景不同，原版缺少大量中国开发者需要的功能。

superpowers-zh 做了两件事：

1. 1. 完整汉化：14 个核心 skills 的中文适配（Git 工作流、代码审查、测试生成等）
2. 2. 本土增强：6 个中国原创 skills（微信生态、飞书协作、国内内容平台等）

核心能力清单

按场景分类，superpowers-zh 提供以下能力：

🖥️ 系统操作

• • healthcheck：主机安全审计与风险配置
• • node-connect：OpenClaw 节点连接诊断
• • session-logs：会话日志搜索与分析

🔧 开发工作流

• • github：GitHub 操作（PR/Issue/CI 日志）
• • chinese-code-review：中文代码审查规范
• • chinese-commit-conventions：中文 Git 提交规范
• • test-driven-development：测试驱动开发
• • using-git-worktrees：Git 工作树隔离开发
• • verification-before-completion：完成前验证

📝 内容创作

• • minimax-docx：专业 Word 文档生成
• • minimax-pdf：美观 PDF 制作
• • minimax-xlsx：Excel 数据分析
• • pptx-generator：PPT 演示文稿
• • volcengine-image-gen：火山引擎 AI 生图
• • humanizer：去除 AI 写作痕迹

📱 微信生态

• • baoyu-post-to-wechat：公众号文章发布
• • feishu-doc/drive/wiki：飞书文档管理
• • tencent-channel-community：腾讯频道运营

🌐 中国原创

• • bb-browser-sites：36 平台 103 命令（微博/B 站/小红书/知乎等）
• • clawdhub：技能市场管理
• • workflow-runner：YAML 工作流执行

支持的工具

superpowers-zh 支持 16 款 AI 编程工具：

• • 终端类：Claude Code、Copilot CLI、Gemini CLI、Kiro
• • IDE 类：Cursor、Windsurf、VS Code + Copilot
• • Agent 类：OpenClaw、Hermes Agent、Codex
• • 其他：以及任何支持 MCP 或技能系统的工具

三、安装与配置（以 OpenClaw 为例）

前置条件

• • 已安装 OpenClaw（或其他支持的工具）
• • Node.js 环境（v18+）
• • 网络连接正常（需访问 GitHub）

安装步骤

方式 1：通过 clawdhub 安装（推荐）

# 安装 clawdhub（如果还没装）npm install -g clawdhub# 安装 superpowers-zhclawdhub install superpowers-zh

方式 2：手动克隆

# 克隆到共享 skills 目录git clone https://github.com/jnMetaCode/superpowers-zh.git ~/.openclaw/skills/# 或者安装到工作区目录git clone https://github.com/jnMetaCode/superpowers-zh.git /path/to/your/workspace/skills/

配置要点

安装完成后，skills 会出现在以下目录：

~/.openclaw/skills/├── chinese-code-review/├── chinese-commit-conventions/├── github/├── healthcheck/├── minimax-docx/├── volcengine-image-gen/└── ...

启用/禁用特定 skill：

在 OpenClaw 配置文件中（通常是 ~/.openclaw/config.yaml），可以通过 skills.entries 控制哪些 skills 被加载：

skills:  entries:    - github    - chinese-code-review    - minimax-docx    # 暂时禁用的 skill 前面加 #    # - healthcheck

权限与安全：

部分 skills 需要额外配置：

• • github：需要 gh CLI 认证（运行 gh auth login）
• • volcengine-image-gen：需要火山引擎 API Key
• • baoyu-post-to-wechat：需要微信公众号 AppID/AppSecret

敏感操作（如系统命令、文件删除）会触发用户确认，这是正常的安全机制。

验证安装

启动 OpenClaw 后，运行以下命令确认 skills 已加载：

/list-skills

或在对话中直接问：”你有哪些技能？”

AI 应该能列出已安装的 skills 清单。

四、核心 Skills 详解与实战

4.1 系统级 Skills

healthcheck：主机安全审计

使用场景：VPS 部署前检查、定期安全巡检

帮我做个安全审计，检查 SSH 配置、防火墙规则、系统更新状态

AI 会执行：

• • SSH 配置检查（是否禁用 root 登录、密钥认证）
• • 防火墙状态（ufw/iptables 规则）
• • 系统更新检查
• • 开放端口扫描
• • 风险等级评估

输出格式化的安全报告，并给出修复建议。

node-connect：节点连接诊断

使用场景：Android/iOS 配对失败、局域网无法访问

我的 Android 设备连不上 OpenClaw，帮我诊断一下

AI 会检查：

• • Gateway 服务状态
• • 配对码/Bootstrap Token 有效性
• • 网络可达性（同网段/尾组网）
• • 配置文件中的 publicUrl 设置

并给出具体修复步骤。

4.2 开发工作流 Skills

github：GitHub 操作

使用场景：查 PR 状态、CI 日志、创建 Issue

查看 repo owner/name 的最近 5 个 PR 状态

帮我创建个 Issue，标题是"Bug: 登录页面在移动端显示异常"

查看 PR #123 的 CI 构建日志

需要先用 gh auth login 完成认证。

chinese-code-review：中文代码审查

使用场景：团队代码评审、PR 合并前检查

审查这段代码，用中文给出反馈

AI 会按照国内团队习惯给出审查意见：

• • 代码规范问题（命名、格式）
• • 潜在 bug（空指针、边界条件）
• • 性能优化建议
• • 可读性改进

风格专业但不生硬，避免”机翻味”。

chinese-commit-conventions：中文提交规范

使用场景：生成规范的 commit message

我改了登录页面的 bug，帮我写个 commit message

AI 会生成：

fix(登录): 修复移动端页面布局错位问题- 调整 CSS 媒体查询断点- 修复按钮点击区域过小- 优化输入框焦点状态Closes #123

符合 Conventional Commits 规范，支持 changelog 自动化。

test-driven-development：测试驱动开发

使用场景：新功能开发、bug 修复

我要实现一个用户注册功能，用 TDD 流程

AI 会按照 TDD 流程：

1. 1. 先写测试用例（失败的）
2. 2. 实现最小功能（让测试通过）
3. 3. 重构代码
4. 4. 重复以上步骤

4.3 内容创作 Skills

minimax-docx：专业 Word 文档

使用场景：合同、报告、方案书

帮我写一份技术服务合同，甲方是 XX 公司，乙方是 YY 工作室

AI 会生成格式规范的 .docx 文件，包含：

• • 封面页
• • 目录
• • 正文（带样式）
• • 签署页

volcengine-image-gen：AI 生图

使用场景：公众号配图、海报、封面

生成一张现代科技风格的封面图，深色主题，AI 元素

需要配置火山引擎 API Key，支持多种尺寸和风格。

4.4 微信生态 Skills

baoyu-post-to-wechat：公众号发布

使用场景：文章推送、图文消息

把这篇文章发到公众号，标题是"XXX"

支持：

• • 文章模式（HTML/Markdown/纯文本）
• • 图文模式（多图 + 文字）
• • 自动转换外部链接为底部引用

需要配置微信公众号 AppID/AppSecret。

五、实战案例：一个完整的 GitHub 开发工作流

下面演示如何用 superpowers-zh 完成一个真实的开发任务：修复一个 GitHub Issue 并合并 PR。

场景背景

假设你维护一个开源项目，收到用户反馈的 bug。你要完成：

1. 1. 查看 Issue 详情
2. 2. 创建分支修复
3. 3. 编写测试
4. 4. 提交代码
5. 5. 创建 PR
6. 6. 处理 Review 意见

步骤 1：查看 Issue 列表

帮我查看 repo jnMetaCode/superpowers-zh 的 bug 标签 Issue，按最近更新时间排序

AI 返回：

找到 3 个带 bug 标签的 Issue：#127 [bug] healthcheck 在 Ubuntu 24.04 上报告误报      更新于 2 小时前，作者：@user123#125 [bug] GitHub skill 认证失败时没有明确错误提示      更新于 1 天前，作者：@dev456#122 [bug] 中文代码审查输出格式错乱      更新于 3 天前，作者：@tester789

步骤 2：查看 Issue 详情

查看 Issue #127 的详细内容

AI 返回完整描述、评论、标签等信息。你决定修复这个问题。

步骤 3：创建开发分支

基于 main 分支创建新分支 fix/healthcheck-ubuntu24，并切换过去

AI 执行 Git 命令并确认：

✓ 已创建分支 fix/healthcheck-ubuntu24✓ 已切换到新分支

步骤 4：编写测试用例（TDD）

用 test-driven-development skill，先写测试用例验证 healthcheck 在 Ubuntu 24.04 上的行为

AI 会：

1. 1. 分析现有测试结构
2. 2. 编写针对 Ubuntu 24.04 的测试用例
3. 3. 运行测试（预期失败）

步骤 5：实现修复

根据测试结果，修复 healthcheck 的 Ubuntu 24.04 兼容性问题

AI 分析误报原因，修改相关代码，然后再次运行测试：

✓ 测试通过

步骤 6：规范提交

用 chinese-commit-conventions 帮我写个 commit message

AI 生成：

fix(healthcheck): 修复 Ubuntu 24.04 系统版本检测误报- 更新 /etc/os-release 解析逻辑- 添加 Ubuntu 24.04 (Noble) 版本识别- 补充对应测试用例Fixes #127

你确认后执行提交。

步骤 7：代码审查

用 chinese-code-review 审查这次修改

AI 给出审查意见：

✅ 代码规范：符合项目风格✅ 测试覆盖：新增测试用例覆盖修复场景⚠️ 建议：在 CHANGELOG.md 中添加更新记录

你根据建议更新 CHANGELOG。

步骤 8：创建 PR

推送到远程仓库，并创建 PR 关联 Issue #127

AI 执行：

✓ 已推送分支到 origin✓ 已创建 PR #128: fix(healthcheck): 修复 Ubuntu 24.04 系统版本检测误报✓ 已关联 Issue #127

步骤 9：监控 CI 状态

查看 PR #128 的 CI 构建状态

AI 返回：

CI 构建中...- GitHub Actions (Ubuntu): 运行中- GitHub Actions (macOS): 通过- GitHub Actions (Windows): 通过

等待几分钟后再次查询：

✓ 所有 CI 检查通过

步骤 10：处理 Review 意见

维护者在 PR 中提出修改意见。你查看评论：

查看 PR #128 的 Review 评论

AI 返回评论内容。你根据意见修改代码，再次提交。

步骤 11：合并 PR

维护者批准并合并 PR。你收到通知后：

帮我清理本地分支 fix/healthcheck-ubuntu24，切换回 main 并拉取最新代码

✓ 已删除本地分支✓ 已切换回 main✓ 已拉取最新代码

完成。

从 Issue 到 PR 合并，整个流程中 AI 帮你完成了：

• • 信息查询（Issue/PR/CI）
• • 代码开发（TDD/修复）
• • 规范提交（commit message）
• • 代码审查
• • Git 操作（分支/推送/清理）

你只需要做决策和确认，重复性工作全部交给 AI。

六、常见问题与避坑指南

Q1：Skill 加载失败怎么办？

现象：AI 说”没有这个技能”或”找不到命令”

排查步骤：

1. 1. 确认 skill 目录在正确位置（~/.openclaw/skills/ 或工作区 skills/）
2. 2. 检查目录中是否有 SKILL.md 文件
3. 3. 重启 OpenClaw 重新加载
4. 4. 运行 /list-skills 确认是否出现在列表中

Q2：如何调试 Skill 执行问题？

现象：Skill 执行报错或无响应

方法：

1. 1. 查看 OpenClaw 日志（通常在 ~/.openclaw/logs/）
2. 2. 检查 skill 是否需要额外配置（API Key、认证等）
3. 3. 确认网络连接正常（部分 skill 需要访问外部 API）
4. 4. 尝试简化指令，排除参数问题

Q3：权限配置注意事项

部分 skills 涉及敏感操作：

• • 系统命令（healthcheck、node-connect）：需要 shell 执行权限
• • 文件操作（读/写/删除）：需要工作区访问权限
• • 外部 API（GitHub、微信、火山引擎）：需要配置认证信息

建议：

• • 首次使用某个 skill 时，仔细阅读其 SKILL.md 中的权限说明
• • 不要随意授予 elevated 权限给不信任的 skills
• • 定期审计已安装的 skills，删除不再使用的

Q4：如何贡献自己的 Skill？

如果你有好的想法，可以：

1. 1. 在本地创建 skill 目录结构
2. 2. 编写 SKILL.md 定义技能行为
3. 3. 测试无误后，提交 PR 到 superpowers-zh 仓库
4. 4. 或通过 clawdhub 发布为独立 skill

具体规范参考项目文档。

七、总结与资源

核心价值

superpowers-zh 不是”另一个工具”，而是让现有工具变得更好用的增强层。你不需要替换 Cursor 或 Claude Code，只需要装上 skills，它们就能做更多事。

关键收获

1. 1. 技能系统：给 AI 编程工具装上”插件”，扩展能力边界
2. 2. 本土适配：14 个汉化 skills + 6 个中国原创 skills
3. 3. 实战导向：从安装配置到完整工作流，即学即用

下一步

• • 项目地址：https://github.com/jnMetaCode/superpowers-zh
• • 文档：每个 skill 的 SKILL.md 都是详细文档
• • 社区：GitHub Issues 提问或讨论

行动建议

1. 1. 安装 superpowers-zh（10 分钟）
2. 2. 选 1-2 个最需要的 skills 先用起来（如 github、chinese-code-review）
3. 3. 逐步扩展到其他场景
4. 4. 遇到问题提 Issue，帮助项目改进

最后说句实话：工具本身不会让你变强，但用好工具可以让你把时间花在真正重要的事上。

superpowers-zh 做不到”一键完成所有工作”，但它能让 AI 从”写代码的助手”变成”能干活的合作者”。

这中间的差距，就是你省下来的时间。

作者：milsonshen\ 公众号：未来之路 AI