AI 技能AI 插件人工智能开发工具【免费下载链接】superpowers-zh AI 编程超能力 · 中文增强版 — superpowers250k ⭐完整汉化 4 个中国原创 skills让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 26 款 AI 编程工具真正会干活项目地址https://gitcode.com/gh_mirrors/su/superpowers-zh点击查看免费下载本指南基于 superpowers-zh 项目仓库中的 docs/README.hermes.md 编写面向使用 Hermes Agent 的开发者说明如何正确安装并激活 superpowers-zh 的 20 个 AI 编程方法论 skills。读完本文你将掌握 Hermes Agent 与 Claude Code 系工具生态的最大差异——只自动加载~/.hermes/skills/这一关键机制并学会通过全局安装、config.yaml显式登记、skill_view渐进式加载三种方式让 skills 真正生效同时获得一份完整的工具映射表与故障排查清单。为什么必须先理解 Hermes 的 skills 加载机制与 Claude Code、Cursor 等工具项目级目录自动发现不同Hermes Agent 官方文档明确它只自动加载~/.hermes/skills/官方将其称为 the primary directory and source of truth主目录与事实来源项目级目录不会被自动发现。这一点在仓库安装器源码中得到了直接印证。bin/superpowers-zh.js 中 Hermes Agent 的工具注册条目注释写道Hermes 官方文档只自动加载~/.hermes/skills/the primary directory and source of truth项目级目录不被自动发现外部目录必须写进~/.hermes/config.yaml的skills.external_dirs。所以全局才是能直接生效的装法。理解了这条规则下面两种安装方式就很好选择了。推荐做法全局安装装完即生效因为 Hermes 只读~/.hermes/skills/最省事的方案就是全局安装npx superpowers-zh --global --tool hermes这条命令会把 20 个 skill 装到~/.hermes/skills/装完即生效用skills_list就能看到全部技能无需任何额外配置。这也是主 README 中 Hermes Agent 对应的一键安装命令。 版本注意事项v1.7.8 及更早版本只支持项目级安装装到项目/.hermes/skills/—— 而那个目录 Hermes 根本不读等于装了不生效。这是该项目此前的实现错误自 v1.7.9 起已修正建议使用最新版本当前仓库 package.json 中版本为 1.7.13。项目级安装可以但必须显式登记到 config.yaml如果你希望 skills 随仓库一起分发团队协作场景项目级安装也是可行的但必须显式登记否则 Hermes 看不见cd /your/project npx superpowers-zh --tool hermes安装完成后安装器会打印出一段你需要手动粘贴的配置片段。以仓库安装器实际输出的格式为准见 bin/superpowers-zh.js 的打印逻辑形如skills: external_dirs: - /your/project/.hermes/skills把它加进~/.hermes/config.yaml即可。这里有几个关键细节路径支持~展开和${VAR}环境变量替换方便在多机或 CI 环境复用同一份配置配置里不存在的路径会被静默跳过——写错了不会报错只会没生效。这是排查时最容易忽略的一点安装器不会替你改config.yaml。源码中的设计原则是那是你的配置文件项目级安装只负责打印需要粘贴的片段改不改由你决定。项目级安装会额外生成 AGENTS.md项目级安装还会在项目根生成AGENTS.md引导文件内含核心规则和 skills 列表让 Hermes 在合适时机主动检查 skill。这段内容由安装器的generateHermesBootstrap函数生成见 bin/superpowers-zh.js包含核心规则四条收到任务先检查匹配 skill、设计先于编码、测试先于实现、验证先于完成Claude Code → Hermes 的工具映射表可用 skills 清单与使用方式。而全局安装不写任何 bootstrap 文件。源码注释给出了明确理由Hermes 的全局身份文件是$HERMES_HOME/SOUL.md官方明确 SOUL.md 只放身份/人格、不放项目/任务指令用户级指令文件的约定没有公开文档因此安装器不猜路径、也不往主目录里写东西。全局安装后 skills 靠自身的name/description元数据被skills_list/skill_view发现本就不依赖 bootstrap。配置文件的另一种全局用法如果你是从源码仓库直接使用的场景也可以手动在~/.hermes/config.yaml中引用仓库内的 skills 目录skills: external_dirs: - /path/to/superpowers-zh/skills这与项目级安装生成的配置本质相同区别只是路径指向仓库源码目录而非项目内的.hermes/skills。同名冲突本地优先如果同一个 skill 名在~/.hermes/skills/和某个external_dirs目录里都存在本地~/.hermes/skills/的版本优先。这意味着全局装好后若某项目又通过external_dirs引入了另一份同名 skill项目级那份会被本地版本覆盖不会被同时加载两份。工具映射Claude Code 工具名 → Hermes 等价工具superpowers 的 skills 文档以 Claude Code 的工具名为基准编写。Hermes Agent 使用另一套命名完整映射如下与仓库 skills/using-superpowers/references/hermes-tools.md 及安装器生成的 AGENTS.md 引导内容一致Claude CodeHermes AgentReadread_fileWritewrite_fileEditpatchBashterminalGrep/Globsearch_filesSkillskill_viewTask子智能体delegate_taskWebSearchweb_searchWebFetchweb_extractTodoWritetodo其中几个工具值得展开说明其实际用法依据 hermes-tools.md搜索文件search_files负责内容搜索按文件名查找时用terminal配合find抓取网页web_extract(urls[...])网络搜索用web_search(query...)派遣子智能体delegate_task(goal..., context..., toolsets[...], roleleaf)用于并行或串行的工作流派生隔离的子智能体。参考文件特别提醒如果delegate_task不可用就把工作内联做完不要凭空编造工具调用任务跟踪会话内用todo工具多智能体任务看板在可用时使用hermes kanbanCLI。遇到旧文档里的TodoWrite引用按「任务跟踪」这个动作理解即可。使用技能三级渐进式加载Hermes Agent 支持三级渐进式加载流程# 1. 浏览所有可用技能 skills_list # 2. 加载某个技能的完整内容 skill_view(brainstorming) # 3. 查看技能的引用文件 skill_view(using-superpowers, references/hermes-tools.md)Hermes 的skills工具集包含skill_view和skills_list两个工具。如果skill_view暂时找不到某个 superpowers skill例如插件完全注册之前它还没出现在目录里可以回退到直接读取 SKILL.mdread_file(path~/.hermes/plugins/superpowers/skills/skill-name/SKILL.md)这个回退机制与项目里其他没有原生 skill 加载能力的 harness 用的是同一套方案。关于「指令文件」的定位当 skill 提到「你的指令文件」时在 Hermes Agent 上指的是项目目录里的AGENTS.md或全局的~/.hermes/SOUL.md。这里有一条来自 hermes-tools.md 的实践区分superpowers-zh 的增量内容SOUL.md是身份/人格文件Hermes 官方文档明确说项目工作流指令不属于它所以npx superpowers-zh --tool hermes的项目级安装只写AGENTS.md全局安装只装 skills、不写 bootstrap —— 往 SOUL.md 里塞技能清单是误用那个文件。故障排查Skills 未发现确认.hermes/skills/目录存在且包含 skill 文件夹每个 skill 目录下需要有SKILL.md文件——安装器的scanSkillEntries扫描逻辑见 bin/superpowers-zh.js正是以目录 SKILL.md frontmatter 中的name/description为识别标准使用skills_list查看已发现的技能。AGENTS.md 未加载确认文件在项目根目录与.hermes/同级文件名必须是AGENTS.md项目工作流指令的官方位置。⚠️版本坑v1.7.12 及更早版本写的是HERMES.md——而 Hermes 官方文档里HERMES.md出现 0 次明确指示 project workflow instructions … Those belong inAGENTS.md。旧版本写的那个文件很可能从未被加载。源码注释bin/superpowers-zh.js也记录了这是 Hermes 安装的第二次装了不生效第一次是 #45 的 skills 目录问题。升级后重装即可旧的HERMES.md可以手动删除--uninstall也会清掉安装器写入的那一段。误装清理如需卸载含清理历史遗留回到安装目录执行cd /your/project # 或 cd ~ 如果误装到了主目录 npx superpowers-zhlatest --uninstall卸载会删除装过的 skill 目录并清理追加到AGENTS.md中的 superpowers-zh 段落——安装器会把追加内容包在!-- superpowers-zh:begin/end --哨兵注释之间见 bin/superpowers-zh.js卸载按哨兵精确切除保留你自己写的内容。小结三条铁的规则Hermes 只自动加载~/.hermes/skills/——想省事就全局装npx superpowers-zh --global --tool hermes项目级目录不被自动发现——要用必须把路径写进~/.hermes/config.yaml的skills.external_dirs且写错的路径会被静默跳过项目工作流指令属于AGENTS.md别写进SOUL.md身份文件或过时的HERMES.md。遵循这三条再配合skills_list/skill_view渐进式加载与上文工具映射表superpowers-zh 的 20 个方法论 skills 就能在 Hermes Agent 中稳定发挥作用。更多工具的安装差异可对照仓库 docs/ 目录下各工具的README.*.md文档查阅。赞分享AI 技能AI 插件人工智能开发工具【免费下载链接】superpowers-zh AI 编程超能力 · 中文增强版 — superpowers250k ⭐完整汉化 4 个中国原创 skills让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 26 款 AI 编程工具真正会干活项目地址https://gitcode.com/gh_mirrors/su/superpowers-zh点击查看免费下载相关推荐TinaCMS Astro 集成如何注册 TinaIsland 添加新的可编辑区域TinaCMS Astro 集成如何注册 TinaIsland 添加新的可编辑区域 当你已经用 tinacms/astro 把 TinaCMS 可视编辑接入AI 技能AI 插件人工智能开发工具如何为组织强制启用 SAML SSO 并处理未通过 IdP 认证的成员如何为组织强制启用 SAML SSO 并处理未通过 IdP 认证的成员 如果你在管理一个使用 GitHub Enterprise Cloudghec的组织AI 技能AI 插件人工智能开发工具Superpowers 在 Kimi Code 中的落地插件清单、工具映射与完整安装实战指南Superpowers 在 Kimi Code 中的落地插件清单、工具映射与完整安装实战指南 本文基于仓库内的 Kimi Code 专用指南 https://AI 技能AI 插件开发工具上一篇如何让旧Mac焕发新生终极系统兼容性修复方案下一篇TanStack Preact Form 动态校验Dynamic Validation实战指南用 onDynamic 与 revalidateLogic 实现提交前/提交后差异化校验创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考