Hermes Agent 无法正确使用superpowers-zh技能

[parkycai]

环境信息

字段	值
Superpowers 版本	1.3.0
工具（Claude Code、Cursor 等）	Hermes Agent
工具版本	v0.15.1
模型	deepseek-v4-pro
操作系统 + Shell	macOS 26.5.1 / ghostty

这是 Superpowers 的问题还是平台的问题？

• [✅] 我已确认此问题在未安装 Superpowers 的情况下不会发生

发生了什么？

Hermes Agent无法发现项目本地的 .hermes/skills/里的技能，导致superpowers无法正常工作。
superpowers-zh 的 20 个技能从项目本地 .hermes/skills/ 被注册到 Hermes Agent 全局技能库后，发现 7 个技能文件 / 24 处使用了 Claude Code 专属的工具名，而这些工具名在 Hermes Agent 中不存在或名称不同。

具体问题分为两类：

问题 1：技能无法被 Hermes Agent 发现

Hermes Agent 的 skill_view 工具只扫描全局技能库 ~/.hermes/skills/，不会自动发现项目本地 .hermes/skills/。20 个技能文件虽然存在于项目本地，但全部返回 404，必须手动复制到 ~/.hermes/skills/ 才会被识别。

问题 2：工具名硬编码不兼容

以下 Claude Code 工具名在 Hermes Agent 中无法使用：

Claude Code	Hermes Agent	受影响位置
Read	read_file	workflow-runner（3 处）、brainstorming/visual-companion
Write	write_file	workflow-runner、brainstorming/visual-companion
Bash	terminal	workflow-runner、brainstorming/visual-companion
Task	delegate_task	requesting-code-review
TodoWrite	todo	executing-plans（3 处）、subagent-driven-development（7 处）、using-superpowers（4 处）、writing-skills
Skill 工具	skill_view	using-superpowers graphviz（3 处）
run_in_background	background	brainstorming/visual-companion

具体受影响文件

文件	修复数	典型错误
workflow-runner/SKILL.md	5	"用 Read 工具读取"、"用 Write 工具将结果保存"、"用 Bash test -d"
requesting-code-review/SKILL.md	1	"使用 Task 工具，指定 general-purpose 类型"
executing-plans/SKILL.md	3	"创建 TodoWrite"、"更新 TodoWrite"
subagent-driven-development/SKILL.md	7	graphviz 节点 "创建 TodoWrite"
using-superpowers/SKILL.md	6	graphviz 节点 "调用 Skill 工具"、"TodoWrite 待办"
brainstorming/visual-companion.md	3	"Bash 工具调用"、"Write 工具"、"run_in_background"
writing-skills/SKILL.md	1	"使用 TodoWrite 为下方清单项创建待办"

关于 using-superpowers/references/hermes-tools.md

该参考文件已经包含了正确的 Hermes Agent 工具映射表（Read→read_file, Write→write_file 等），问题是技能正文中直接使用了 Claude Code 工具名，没有遵守自己的映射表。

复现步骤

1. 将 superpowers-zh 安装到 Hermes Agent 项目（npx superpowers install 或手动复制到 .hermes/skills/）
2. 尝试 skill_view("brainstorming") → 返回 "Skill not found"
3. 将 .hermes/skills/* 手动复制到 ~/.hermes/skills/software-development/ 后可以加载
4. 加载后技能内容中的 "用 Read 工具读取" 等指令会引导 Hermes Agent 调用不存在的工具

预期行为

1. 技能应能被 Hermes Agent 的 skill_view 自动发现，无需手动复制到全局库
2. 技能内容中的工具名应使用 Hermes Agent 的实际工具名：read_file、write_file、terminal、delegate_task、todo、skill_view
3. 或者技能内容统一使用平台无关的抽象描述（如 "读取文件"），由各平台的适配层完成映射

实际行为

• 技能文件存在于项目本地但全部 404
• 加载后技能内容引导使用不存在的 Read、Write、Bash、TodoWrite 等工具

建议修复方向

短期： 将技能文件安装到全局库，并在技能文件中全局替换上述工具名映射。

长期：

1. 技能内容应使用平台无关的描述 + references/ 目录下的平台映射表
2. 或者为 Hermes Agent 提供安装脚本，自动将技能注册到 ~/.hermes/skills/ 并执行工具名替换
3. using-superpowers/references/hermes-tools.md 已有正确映射表，需要让技能正文遵循它