superpowers-zh 1.3.0 → 1.6.0

package/skills/using-superpowers/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: using-superpowers
 description: 在开始任何对话时使用——确立如何查找和使用技能，要求在任何响应（包括澄清性问题）之前调用 Skill 工具
+version: "1.0.0"
+license: MIT
+metadata:
+  hermes:
+    tags: [meta, getting-started]
 ---
 
 <SUBAGENT-STOP>
@@ -39,7 +44,7 @@ Superpowers 技能覆盖默认系统提示行为，但**用户指令始终具有
 
 ## 平台适配
 
-技能使用 Claude Code 的工具名称。非 CC 平台：查看 `references/copilot-tools.md`（Copilot CLI）、`references/hermes-tools.md`（Hermes Agent）、`references/codex-tools.md`（Codex）了解工具对应关系。Gemini CLI 用户通过 GEMINI.md 自动获得工具映射。
+技能使用 Claude Code 的工具名称。非 CC 平台：查看 `references/copilot-tools.md`（Copilot CLI）、`references/hermes-tools.md`（Hermes Agent）、`references/codex-tools.md`（Codex）、`references/qoder-tools.md`（Qoder）了解工具对应关系。Gemini CLI 用户通过 GEMINI.md 自动获得工具映射。
 
 # 使用技能
 

package/skills/using-superpowers/references/pi-tools.md

@@ -0,0 +1,28 @@
+# Pi Tool Mapping
+
+Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). On Pi these resolve to the tools below.
+
+| Action skills request | Pi equivalent |
+| --- | --- |
+| Invoke a skill | Pi native skills: load the relevant `SKILL.md` with `read`, or let the human use `/skill:name` |
+| Read a file | `read` |
+| Create a file | `write` |
+| Edit a file | `edit` |
+| Run a shell command | `bash` |
+| Search file contents | `grep` when active; otherwise `bash` with `rg`/`grep` |
+| Find files by name | `find` or `bash` with shell globs |
+| List files and subdirectories | `ls` when active; otherwise `bash` with `ls` |
+| Dispatch a subagent (`Subagent (general-purpose):` template) | Use an installed subagent tool such as `subagent` from `pi-subagents` if available |
+| Task tracking ("create a todo", "mark complete") | Use an installed todo/task tool if available, otherwise track tasks in the plan or `TODO.md` |
+
+## Skills
+
+Pi discovers skills from configured skill directories and installed Pi packages. A Superpowers Pi package should expose `skills/` through its `pi.skills` manifest entry. Pi does not expose Claude Code's `Skill` tool, but the agent should still follow the Superpowers rule: when a skill applies, load and follow it before responding.
+
+## Subagents
+
+Pi core does not ship a standard subagent tool. The `pi-subagents` package is a strong optional companion and provides a `subagent` tool with single-agent, chain, parallel, async, forked-context, and resume/status workflows. If no subagent tool is available, do not fabricate `Task` calls; execute sequentially in the current session or explain that the optional subagent capability is not installed.
+
+## Task lists
+
+Pi core does not ship a standard task-list tool. If a todo/task extension is installed, use its documented tool. Otherwise use Superpowers plan files, checklists in Markdown, or a repo-local `TODO.md` for task tracking. Older Superpowers docs may refer to `TodoWrite`; treat that as the task-tracking action above.

package/skills/using-superpowers/references/qoder-tools.md

@@ -0,0 +1,43 @@
+# Qoder 工具映射
+
+Skills 使用 Claude Code 的工具名称。Qoder（阿里 AI IDE）大部分工具与 Claude Code **同名**，只有少数差异：
+
+| Skill 中的引用 | Qoder 等价工具 |
+|---------------|---------------|
+| `Read` / `Write` / `Edit` | 同名（`Read` / `Write` / `Edit`） |
+| `Bash` | 同名 |
+| `Grep` / `Glob` | 同名 |
+| `Task`（派遣子 agent） | 同名（`Task`） |
+| `WebFetch` / `WebSearch` | 同名 |
+| `AskUserQuestion` | 同名 |
+| `Skill` | 同名 |
+| `TodoWrite` | 同名 |
+| `EnterPlanMode` / `ExitPlanMode` | **`EnterSpecMode` / `ExitSpecMode`**（Qoder 把"计划模式"称为"Spec 模式"）|
+
+## Task 子 Agent 类型
+
+| Claude Code Agent | Qoder 等价 |
+|------------------|-----------|
+| `general-purpose` | `general-purpose` |
+| `Explore` | `explore-agent` |
+| `Plan` | `plan-agent` |
+| `claude-code-guide` | `qoder-guide` |
+
+Qoder 额外有 `browser-agent`、`code-reviewer`、`design-agent` 等专用 agent，依任务匹配选用。
+
+## Quest MCP 工具（Qoder 原生）
+
+Qoder 内置 Quest 系统提供以下工具，Claude Code 没有等价物，可在 skill 流程中直接调用：
+
+| 工具 | 用途 |
+|------|------|
+| `mcp__quest__search_codebase` | 语义化代码搜索（按意图找代码） |
+| `mcp__quest__search_symbol` | 按符号名搜索代码及关系 |
+| `mcp__quest__get_problems` | 获取文件编译/语法错误 |
+| `mcp__quest__run_preview` | 启动本地 Web 服务器预览 |
+| `mcp__quest__search_memory` / `update_memory` | 跨会话记忆管理 |
+| `mcp__quest__fetch_rules` | 查询规则文件 |
+
+## 加载方式
+
+Qoder 在每个会话自动加载 `.qoder/rules/superpowers-zh.md`（`trigger: always_on`），里面包含 skill 索引。`.qoder/skills/<name>/SKILL.md` 由模型按 description 自主调用，也可输入 `/<skill-name>` 手动触发。

package/skills/verification-before-completion/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: verification-before-completion
 description: 在宣称工作完成、已修复或测试通过之前使用，在提交或创建 PR 之前——必须运行验证命令并确认输出后才能声称成功；始终用证据支撑断言
+version: "1.0.0"
+license: MIT
+metadata:
+  hermes:
+    tags: [quality, verification]
 ---
 
 # 完成前验证

package/skills/workflow-runner/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: workflow-runner
 description: "在 Claude Code / OpenClaw / Cursor 中直接运行 agency-orchestrator YAML 工作流——无需 API key，使用当前会话的 LLM 作为执行引擎。当用户提供 .yaml 工作流文件或要求多角色协作完成任务时触发。"
+version: "1.0.0"
+license: MIT
+metadata:
+  hermes:
+    tags: [execution, workflow]
 ---
 
 # 工作流执行器：在 AI 工具内运行多角色编排

package/skills/writing-plans/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: writing-plans
 description: 当你有规格说明或需求用于多步骤任务时使用，在动手写代码之前
+version: "1.0.0"
+license: MIT
+metadata:
+  hermes:
+    tags: [planning, documentation]
 ---
 
 # 编写计划

package/skills/writing-skills/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: writing-skills
 description: 当创建新技能、编辑现有技能或在部署前验证技能是否有效时使用
+version: "1.0.0"
+license: MIT
+metadata:
+  hermes:
+    tags: [skills, documentation]
 ---
 
 # 编写技能