@shirlytaylor73/superharness 1.5.0

package/plugins/superharness/.codex-plugin/plugin.json

@@ -0,0 +1,31 @@
+{
+  "name": "superharness",
+  "description": "Programmatic workflow harness for AI coding agents: state-machine driven skills, hooks, and MCP state management.",
+  "version": "1.5.0",
+  "author": {
+    "name": "ShirlyTaylor73",
+    "url": "https://github.com/ShirlyTaylor73"
+  },
+  "homepage": "https://github.com/ShirlyTaylor73/superharness",
+  "repository": "https://github.com/ShirlyTaylor73/superharness",
+  "license": "MIT",
+  "keywords": ["skills", "tdd", "debugging", "chinese", "中文", "best-practices", "workflows"],
+  "skills": "./skills/",
+  "hooks": "./hooks/hooks-codex.json",
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "Superharness",
+    "shortDescription": "AI coding workflow harness with skills, hooks, and state MCP.",
+    "longDescription": "Superharness provides state-machine driven skills, workflow-state hooks, and a state MCP for AI coding agents. It injects current workflow context, guards .superharness state files, and supports Claude Code and Codex.",
+    "developerName": "ShirlyTaylor73",
+    "category": "Productivity",
+    "capabilities": ["Interactive", "Write", "Hooks"],
+    "websiteURL": "https://github.com/ShirlyTaylor73/superharness",
+    "defaultPrompt": [
+      "使用 superharness 帮我制定开发计划。",
+      "用系统化调试方法分析这个问题。",
+      "按中文代码审查标准 review 当前改动。"
+    ],
+    "brandColor": "#D97706"
+  }
+}

package/plugins/superharness/.mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "superharness-workflow-state": {
+      "command": "node",
+      "args": ["workflow-state-server/bootstrap.js"],
+      "cwd": "."
+    }
+  }
+}

package/plugins/superharness/CODE_OF_CONDUCT.md

@@ -0,0 +1,79 @@
+# 贡献者公约行为准则
+
+## 我们的承诺
+
+作为成员、贡献者和领导者，我们承诺让每个人都能在我们的社区中获得无骚扰的体验，无论其年龄、体型、可见或不可见的残疾、民族、性别特征、性别认同与表达、经验水平、教育程度、社会经济地位、国籍、外貌、种族、宗教或性取向如何。
+
+我们承诺以有助于建设一个开放、友好、多元、包容且健康的社区的方式行事和互动。
+
+## 我们的标准
+
+有助于为社区营造积极环境的行为包括：
+
+* 对他人表现出同理心和善意
+* 尊重不同的观点、看法和经历
+* 给予和优雅地接受建设性反馈
+* 为自己的错误承担责任并向受影响者道歉，同时从中吸取教训
+* 关注的不仅是个人的最佳利益，还有整个社区的最佳利益
+
+不可接受的行为包括：
+
+* 使用性暗示的语言或图像，以及任何形式的性关注或挑逗
+* 挑衅、侮辱性或贬低性评论，以及人身攻击或政治攻击
+* 公开或私下的骚扰
+* 未经明确许可，发布他人的私人信息，如物理地址或电子邮件地址
+* 其他在专业环境中被合理认为不恰当的行为
+
+## 执行责任
+
+社区领导者负责阐明和执行我们的行为标准，并对任何他们认为不恰当、具有威胁性、冒犯性或有害的行为采取适当且公平的纠正措施。
+
+社区领导者有权利和责任删除、编辑或拒绝不符合本行为准则的评论、提交、代码、Wiki 编辑、Issue 和其他贡献，并在适当时说明审核决定的原因。
+
+## 适用范围
+
+本行为准则适用于所有社区空间，也适用于个人在公共空间中正式代表社区的情况。代表社区的例子包括使用官方电子邮件地址、通过官方社交媒体账号发帖，或在线上或线下活动中担任指定代表。
+
+## 执行
+
+可以向负责执行的社区领导者报告滥用、骚扰或其他不可接受的行为，联系方式为 jesse@primeradiant.com。所有投诉将被及时、公正地审查和调查。
+
+所有社区领导者都有义务尊重事件报告者的隐私和安全。
+
+## 执行指南
+
+社区领导者将遵循以下社区影响指南，以确定对违反本行为准则的行为的处理方式：
+
+### 1. 纠正
+
+**社区影响**：使用不恰当的语言或其他在社区中被视为不专业或不受欢迎的行为。
+
+**后果**：社区领导者发出私下书面警告，说明违规的性质以及该行为不恰当的原因。可能会要求公开道歉。
+
+### 2. 警告
+
+**社区影响**：通过单次事件或一系列行为造成的违规。
+
+**后果**：发出警告，说明持续此类行为的后果。在指定时间内，不得与相关人员互动，包括与执行行为准则的人员进行非主动的互动。这包括避免在社区空间以及社交媒体等外部渠道中的互动。违反这些条款可能导致临时或永久封禁。
+
+### 3. 临时封禁
+
+**社区影响**：严重违反社区标准，包括持续的不恰当行为。
+
+**后果**：在指定时间内临时禁止与社区进行任何形式的互动或公开沟通。在此期间，不允许与相关人员进行任何公开或私下互动，包括与执行行为准则的人员进行非主动的互动。违反这些条款可能导致永久封禁。
+
+### 4. 永久封禁
+
+**社区影响**：表现出持续违反社区标准的模式，包括持续的不恰当行为、对个人的骚扰，或对某类群体的攻击或贬低。
+
+**后果**：永久禁止在社区内进行任何形式的公开互动。
+
+## 来源
+
+本行为准则改编自[贡献者公约][homepage] 2.0 版本，可在 https://www.contributor-covenant.org/version/2/0/code_of_conduct.html 查看。
+
+社区影响指南受到 [Mozilla 行为准则执行阶梯](https://github.com/mozilla/diversity)的启发。
+
+[homepage]: https://www.contributor-covenant.org
+
+有关本行为准则的常见问题，请参阅 https://www.contributor-covenant.org/faq。翻译版本可在 https://www.contributor-covenant.org/translations 查看。

package/plugins/superharness/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jnMetaCode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/plugins/superharness/README.md

@@ -0,0 +1,57 @@
+# Superharness Plugin
+
+This plugin package contains the Superharness runtime for AI coding agents.
+
+It provides:
+
+- State-machine driven skills for structured software development workflows.
+- Claude Code / Codex hooks for workflow context injection and `.superharness/` write protection.
+- A programmatic workflow state server backed by SQLite and configured by YAML.
+- User-controlled workflow rollback through `/rollback [state]`, limited to states that appear in `transition_log`.
+- Session-level workflow context pause and resume through `/free on|off|status`, with mutating state tools locked while free mode is on.
+
+## Layout
+
+| Path | Purpose |
+|---|---|
+| `.claude-plugin/` | Claude Code plugin metadata |
+| `.codex-plugin/` | Codex plugin metadata and interface metadata |
+| `skills/` | Active skills discovered by supported agents |
+| `workflow/` | Workflow graph configuration |
+| `workflow-state-server/` | MCP server, state store, renderer, and tests |
+| `hooks/` | Claude Code / Codex hook config and commands |
+| `commands/` | Claude Code slash command markdown |
+| `commands-codex/` | Codex command templates rendered by the npx installer |
+| `archived-skills/` | Historical disabled skills that must not be registered |
+
+## Runtime Entry
+
+The old text bootstrap entry has been removed from runtime. Superharness starts from workflow context:
+
+- Claude Code / Codex: `UserPromptSubmit -> workflow-context`
+- Claude Code / Codex: `PreToolUse -> workflow-pre-tool-use`
+- State tools: `superharness-workflow-state`
+
+## Codex npx Install
+
+Codex skills and command support are installed through the root package:
+
+```bash
+npx @shirlytaylor73/superharness@latest
+```
+
+The installer asks whether to install into the current project directories or the user-level directories. Project installs write skills to `.agents/skills/` and commands/runtime to `.codex/`; user installs write skills to `~/.agents/skills/` and commands/runtime to `~/.codex/`. Non-interactive installs can use:
+
+```bash
+npx @shirlytaylor73/superharness@latest --project
+npx @shirlytaylor73/superharness@latest --user
+```
+
+The installer copies active skills from `skills/` into `.agents/skills/`. Codex command markdown currently supports `free` and `rollback`. `commands/` is the Claude Code version; `commands-codex/` is the Codex template source. During install, `commands-codex/` is rendered into `.codex/commands/` with the concrete absolute plugin path because Codex does not support Claude Code's `!node` native command execution syntax.
+
+## Development
+
+```bash
+cd workflow-state-server
+npm.cmd test
+```

package/plugins/superharness/agents/code-reviewer.md

@@ -0,0 +1,48 @@
+---
+name: code-reviewer
+description: |
+  当一个主要项目步骤完成并需要根据原始计划和编码标准进行审查时使用此智能体。示例：<example>Context: 用户正在创建一个代码审查智能体，应在逻辑代码块编写完成后调用。user: "我已经按照计划第 3 步完成了用户认证系统的实现" assistant: "干得好！让我使用 code-reviewer 智能体来根据我们的计划和编码标准审查实现" <commentary>由于一个主要项目步骤已完成，使用 code-reviewer 智能体来验证工作是否符合计划并识别任何问题。</commentary></example> <example>Context: 用户完成了一个重要功能的实现。user: "任务管理系统的 API 端点现在完成了——这涵盖了我们架构文档中的第 2 步" assistant: "很好！让我用 code-reviewer 智能体检查这个实现，确保它符合我们的计划并遵循最佳实践" <commentary>规划文档中的一个编号步骤已完成，所以应该用 code-reviewer 智能体审查工作。</commentary></example>
+model: inherit
+---
+
+你是一位高级代码审查员，精通软件架构、设计模式和最佳实践。你的角色是根据原始计划审查已完成的项目步骤，确保代码质量标准得到满足。
+
+审查已完成的工作时，你将：
+
+1. **计划对齐分析**：
+   - 将实现与原始规划文档或步骤描述进行对比
+   - 识别与计划的方案、架构或需求的任何偏差
+   - 评估偏差是合理的改进还是有问题的偏离
+   - 验证所有计划的功能是否都已实现
+
+2. **代码质量评估**：
+   - 审查代码是否遵循已建立的模式和约定
+   - 检查错误处理、类型安全和防御性编程是否恰当
+   - 评估代码组织、命名约定和可维护性
+   - 评估测试覆盖率和测试实现的质量
+   - 寻找潜在的安全漏洞或性能问题
+
+3. **架构和设计审查**：
+   - 确保实现遵循 SOLID 原则和已建立的架构模式
+   - 检查关注点分离和松耦合是否恰当
+   - 验证代码与现有系统的集成是否良好
+   - 评估可扩展性和可延展性的考虑
+
+4. **文档和标准**：
+   - 验证代码包含适当的注释和文档
+   - 检查文件头、函数文档和内联注释是否存在且准确
+   - 确保遵循项目特定的编码标准和约定
+
+5. **问题识别和建议**：
+   - 将问题明确分类为：关键（必须修复）、重要（应该修复）或建议（锦上添花）
+   - 对每个问题提供具体示例和可操作的建议
+   - 识别计划偏差时，解释它们是有问题的还是有益的
+   - 在有帮助时提供带有代码示例的具体改进建议
+
+6. **沟通协议**：
+   - 如果发现与计划的重大偏差，请编码智能体审查并确认更改
+   - 如果识别出原始计划本身的问题，建议更新计划
+   - 对于实现问题，提供明确的修复指导
+   - 在指出问题之前始终先肯定做得好的地方
+
+你的输出应该是结构化的、可操作的，聚焦于帮助保持高代码质量同时确保项目目标的达成。要全面但简洁，始终提供建设性的反馈，帮助改进当前实现和未来的开发实践。

package/plugins/superharness/archived-skills/using-superpowers/SKILL.md

@@ -0,0 +1,140 @@
+---
+name: using-superpowers
+description: 在开始任何对话时使用——确立如何查找和使用技能，要求在任何响应（包括澄清性问题）之前调用 Skill 工具
+---
+
+<SUBAGENT-STOP>
+如果你是作为子智能体被分派来执行特定任务的，跳过此技能。
+</SUBAGENT-STOP>
+
+<EXTREMELY-IMPORTANT>
+如果你认为哪怕只有 1% 的可能性某个技能适用于你正在做的事情，你绝对必须调用该技能。
+
+如果一个技能适用于你的任务，你没有选择。你必须使用它。
+
+这不可协商。这不是可选的。你不能通过合理化来逃避。
+</EXTREMELY-IMPORTANT>
+
+## 指令优先级
+
+Superpowers 技能覆盖默认系统提示行为，但**用户指令始终具有最高优先级**：
+
+1. **用户的明确指令**（CLAUDE.md、GEMINI.md、AGENTS.md、直接请求）——最高优先级
+2. **Superpowers 技能** ——在冲突处覆盖默认系统行为
+3. **默认系统提示** ——最低优先级
+
+如果 CLAUDE.md、GEMINI.md 或 AGENTS.md 说"不要使用 TDD"，而某个技能说"始终使用 TDD"，遵循用户的指令。用户拥有控制权。
+
+## 如何访问技能
+
+**在 Claude Code 中：** 使用 `Skill` 工具。当你调用一个技能时，其内容会被加载并呈现给你——直接遵循即可。绝不要用 Read 工具读取技能文件。
+
+**在 Copilot CLI 中：** 使用 `skill` 工具。技能从已安装的插件中自动发现。`skill` 工具的工作方式与 Claude Code 的 `Skill` 工具相同。
+
+**在 Hermes Agent 中：** 使用 `skill_view` 工具加载技能。Hermes 支持三级渐进式加载：`skills_list` 浏览 → `skill_view(name)` 加载完整内容 → `skill_view(name, path)` 查看引用文件。
+
+**在 Gemini CLI 中：** 技能通过 `activate_skill` 工具激活。Gemini 在会话开始时加载技能元数据，并按需激活完整内容。
+
+**在其他环境中：** 查看你的平台文档了解技能的加载方式。
+
+## 平台适配
+
+技能使用 Claude Code 的工具名称。非 CC 平台：查看 `references/copilot-tools.md`（Copilot CLI）、`references/hermes-tools.md`（Hermes Agent）、`references/codex-tools.md`（Codex）了解工具对应关系。Gemini CLI 用户通过 GEMINI.md 自动获得工具映射。
+
+# 使用技能
+
+## 规则
+
+**在任何响应或操作之前调用相关或被请求的技能。** 哪怕只有 1% 的可能性某个技能适用，你都应该调用该技能来检查。如果调用后发现技能不适合当前情况，你不需要使用它。
+
+```dot
+digraph skill_flow {
+    "收到用户消息" [shape=doublecircle];
+    "即将进入 EnterPlanMode？" [shape=doublecircle];
+    "已经头脑风暴过？" [shape=diamond];
+    "调用头脑风暴技能" [shape=box];
+    "可能有技能适用？" [shape=diamond];
+    "调用 Skill 工具" [shape=box];
+    "宣布：'使用 [技能] 来 [目的]'" [shape=box];
+    "有检查清单？" [shape=diamond];
+    "为每个条目创建 TodoWrite 待办" [shape=box];
+    "严格遵循技能" [shape=box];
+    "响应（包括澄清）" [shape=doublecircle];
+
+    "即将进入 EnterPlanMode？" -> "已经头脑风暴过？";
+    "已经头脑风暴过？" -> "调用头脑风暴技能" [label="否"];
+    "已经头脑风暴过？" -> "可能有技能适用？" [label="是"];
+    "调用头脑风暴技能" -> "可能有技能适用？";
+
+    "收到用户消息" -> "可能有技能适用？";
+    "可能有技能适用？" -> "调用 Skill 工具" [label="是，哪怕只有 1%"];
+    "可能有技能适用？" -> "响应（包括澄清）" [label="确定不适用"];
+    "调用 Skill 工具" -> "宣布：'使用 [技能] 来 [目的]'";
+    "宣布：'使用 [技能] 来 [目的]'" -> "有检查清单？";
+    "有检查清单？" -> "为每个条目创建 TodoWrite 待办" [label="是"];
+    "有检查清单？" -> "严格遵循技能" [label="否"];
+    "为每个条目创建 TodoWrite 待办" -> "严格遵循技能";
+}
+```
+
+## 红线
+
+这些想法意味着停下——你在合理化：
+
+| 想法 | 现实 |
+|------|------|
+| "这只是一个简单的问题" | 问题就是任务。检查技能。 |
+| "我需要先了解更多上下文" | 技能检查在澄清性问题之前。 |
+| "让我先探索一下代码库" | 技能告诉你如何探索。先检查。 |
+| "我可以快速查一下 git/文件" | 文件缺少对话上下文。检查技能。 |
+| "让我先收集信息" | 技能告诉你如何收集信息。 |
+| "这不需要正式的技能" | 如果技能存在，就使用它。 |
+| "我记得这个技能" | 技能会迭代更新。阅读当前版本。 |
+| "这不算一个任务" | 行动 = 任务。检查技能。 |
+| "技能太小题大做了" | 简单的事会变复杂。使用它。 |
+| "让我先做这一件事" | 在做任何事之前先检查。 |
+| "这样做感觉很高效" | 无纪律的行动浪费时间。技能防止这一点。 |
+| "我知道那是什么意思" | 知道概念 ≠ 使用技能。调用它。 |
+
+## 技能优先级
+
+当多个技能可能适用时，使用此顺序：
+
+1. **流程技能优先**（头脑风暴、调试）- 这些决定如何处理任务
+2. **实现技能其次**（前端设计、mcp-builder）- 这些指导执行
+
+"让我们构建 X" → 先头脑风暴，再使用实现技能。
+"修复这个 bug" → 先调试，再使用领域特定技能。
+"编写、修订、压缩、审查或修复实现计划/plan" → 使用 writing-plans。
+"修改现有实现计划、清理 plan 漂移、同步任务/metadata/并行执行图" → 使用 writing-plans。
+
+## 中国特色技能路由
+
+当检测到以下场景时，**必须**优先调用对应的中国特色技能：
+
+| 场景 | 调用技能 |
+|------|---------|
+| 代码审查且团队使用中文沟通 | **superpowers:chinese-code-review** |
+| 使用 Gitee/Coding/极狐 GitLab | **superpowers:chinese-git-workflow** |
+| 编写中文技术文档或 README | **superpowers:chinese-documentation** |
+| 编写 git commit message（中文项目） | **superpowers:chinese-commit-conventions** |
+| 构建 MCP 服务器/工具 | **superpowers:mcp-builder** |
+
+**判断依据：**
+- 项目中有中文注释、中文 README、或 .gitee 目录 → 启用中文系列技能
+- commit 历史中有中文 → 使用中文提交规范
+- 用户用中文交流 → 所有输出使用中文，优先考虑中国特色技能
+
+中国特色技能与翻译技能**叠加使用**，不互斥。例如：做代码审查时，同时使用 requesting-code-review（流程）+ chinese-code-review（风格）。
+
+## 技能类型
+
+**刚性的**（TDD、调试）：严格遵循。不要偏离纪律。
+
+**灵活的**（模式）：根据上下文调整原则。
+
+技能本身会告诉你它属于哪种。
+
+## 用户指令
+
+指令说明做什么，而非怎么做。"添加 X"或"修复 Y"不意味着跳过工作流。

package/plugins/superharness/archived-skills/using-superpowers/references/codex-tools.md

@@ -0,0 +1,25 @@
+# Codex 工具映射
+
+Skills 使用 Claude Code 的工具名称。在 Codex 中遇到这些名称时，请使用对应的平台等价工具：
+
+| Skill 中的引用 | Codex 等价工具 |
+|---------------|---------------|
+| `Task` 工具（派遣子 agent） | `spawn_agent` |
+| 多个 `Task` 调用（并行） | 多个 `spawn_agent` 调用 |
+| Task 返回结果 | `wait` |
+| Task 自动完成 | `close_agent` 释放槽位 |
+| `TodoWrite`（任务跟踪） | `update_plan` |
+| `Skill` 工具（调用 skill） | Skills 原生加载——直接按说明操作 |
+| `Read`、`Write`、`Edit`（文件） | 使用原生文件工具 |
+| `Bash`（执行命令） | 使用原生 shell 工具 |
+
+## 子 Agent 派遣需要多 Agent 支持
+
+在 Codex 配置文件（`~/.codex/config.toml`）中添加：
+
+```toml
+[features]
+multi_agent = true
+```
+
+启用后可使用 `spawn_agent`、`wait` 和 `close_agent`，支持 `dispatching-parallel-agents` 和 `parallel-executing-plans` 等 skills。

package/plugins/superharness/archived-skills/using-superpowers/references/copilot-tools.md

@@ -0,0 +1,52 @@
+# Copilot CLI 工具映射
+
+技能使用 Claude Code 的工具名称。当你在技能中遇到这些工具时，使用你平台的等价工具：
+
+| 技能中引用的工具 | Copilot CLI 等价工具 |
+|-----------------|----------------------|
+| `Read`（读取文件） | `view` |
+| `Write`（创建文件） | `create` |
+| `Edit`（编辑文件） | `edit` |
+| `Bash`（运行命令） | `bash` |
+| `Grep`（搜索文件内容） | `grep` |
+| `Glob`（按名称搜索文件） | `glob` |
+| `Skill` 工具（调用技能） | `skill` |
+| `WebFetch` | `web_fetch` |
+| `Task` 工具（分派子智能体） | `task`（参见[智能体类型](#智能体类型)） |
+| 多个 `Task` 调用（并行） | 多个 `task` 调用 |
+| Task 状态/输出 | `read_agent`、`list_agents` |
+| `TodoWrite`（任务跟踪） | `sql` 配合内置 `todos` 表 |
+| `WebSearch` | 无等价工具 — 使用 `web_fetch` 配合搜索引擎 URL |
+| `EnterPlanMode` / `ExitPlanMode` | 无等价工具 — 留在主会话中 |
+
+## 智能体类型
+
+Copilot CLI 的 `task` 工具接受 `agent_type` 参数：
+
+| Claude Code 智能体 | Copilot CLI 等价 |
+|-------------------|----------------------|
+| `general-purpose` | `"general-purpose"` |
+| `Explore` | `"explore"` |
+| 命名的插件智能体（如 `superpowers:code-reviewer`） | 从已安装的插件中自动发现 |
+
+## 异步 Shell 会话
+
+Copilot CLI 支持持久化的异步 shell 会话，这在 Claude Code 中没有直接等价物：
+
+| 工具 | 用途 |
+|------|---------|
+| `bash` 配合 `async: true` | 在后台启动长时间运行的命令 |
+| `write_bash` | 向运行中的异步会话发送输入 |
+| `read_bash` | 读取异步会话的输出 |
+| `stop_bash` | 终止异步会话 |
+| `list_bash` | 列出所有活跃的 shell 会话 |
+
+## 额外的 Copilot CLI 工具
+
+| 工具 | 用途 |
+|------|---------|
+| `store_memory` | 持久化代码库相关事实供未来会话使用 |
+| `report_intent` | 更新 UI 状态行显示当前意图 |
+| `sql` | 查询会话的 SQLite 数据库（待办、元数据） |
+| `fetch_copilot_cli_documentation` | 查阅 Copilot CLI 文档 |
+| GitHub MCP 工具（`github-mcp-server-*`） | 原生 GitHub API 访问（issue、PR、代码搜索） |

package/plugins/superharness/archived-skills/using-superpowers/references/gemini-tools.md

@@ -0,0 +1,33 @@
+# Gemini CLI 工具映射
+
+Skills 使用 Claude Code 的工具名称。在 Gemini CLI 中遇到这些名称时，请使用对应的平台等价工具：
+
+| Skill 中的引用 | Gemini CLI 等价工具 |
+|---------------|-------------------|
+| `Read`（读取文件） | `read_file` |
+| `Write`（创建文件） | `write_file` |
+| `Edit`（编辑文件） | `replace` |
+| `Bash`（执行命令） | `run_shell_command` |
+| `Grep`（搜索文件内容） | `grep_search` |
+| `Glob`（按名称搜索文件） | `glob` |
+| `TodoWrite`（任务跟踪） | `write_todos` |
+| `Skill` 工具（调用 skill） | `activate_skill` |
+| `WebSearch` | `google_web_search` |
+| `WebFetch` | `web_fetch` |
+| `Task` 工具（派遣子 agent） | 无等价工具——Gemini CLI 不支持子 agent |
+
+## 不支持子 Agent
+
+Gemini CLI 没有 Claude Code `Task` 工具的等价物。依赖子 agent 派遣的 skills（`parallel-executing-plans`、`dispatching-parallel-agents`）将退化为通过 `serial-executing-plans` 进行单会话执行。
+
+## Gemini CLI 额外工具
+
+以下工具在 Gemini CLI 中可用，但 Claude Code 中没有对应工具：
+
+| 工具 | 用途 |
+|------|------|
+| `list_directory` | 列出文件和子目录 |
+| `save_memory` | 将信息持久化到 GEMINI.md，跨会话保留 |
+| `ask_user` | 向用户请求结构化输入 |
+| `tracker_create_task` | 丰富的任务管理（创建、更新、列表、可视化） |
+| `enter_plan_mode` / `exit_plan_mode` | 切换到只读研究模式，在修改前先调研 |

package/plugins/superharness/archived-skills/using-superpowers/references/hermes-tools.md

@@ -0,0 +1,44 @@
+# Hermes Agent 工具映射
+
+技能使用 Claude Code 的工具名称。当你在技能中遇到这些工具时，使用你平台的等价工具：
+
+| 技能中引用的工具 | Hermes Agent 等价工具 |
+|-----------------|----------------------|
+| `Read`（读取文件） | `read_file` |
+| `Write`（创建文件） | `write_file` |
+| `Edit`（编辑文件） | `patch` |
+| `Bash`（运行命令） | `terminal` |
+| `Grep`（搜索文件内容） | `search_files` |
+| `Glob`（按名称搜索文件） | `search_files` |
+| `Skill` 工具（调用技能） | `skill_view` |
+| `WebFetch` | `web_extract` |
+| `WebSearch` | `web_search` |
+| `Task` 工具（分派子智能体） | `delegate_task` |
+| 多个 `Task` 调用（并行） | 多个 `delegate_task` 调用 |
+| `TodoWrite`（任务跟踪） | `todo` |
+| `EnterPlanMode` / `ExitPlanMode` | 无等价工具 — 留在主会话中 |
+
+## 技能管理
+
+Hermes Agent 使用三级渐进式技能加载：
+
+| 操作 | 工具 |
+|------|------|
+| 列出所有可用技能 | `skills_list` |
+| 查看技能完整内容 | `skill_view(name)` |
+| 查看技能的引用文件 | `skill_view(name, path)` |
+| 管理技能（安装/更新） | `skill_manage` |
+
+## 额外的 Hermes Agent 工具
+
+| 工具 | 用途 |
+|------|---------|
+| `memory` | 持久化知识供未来会话使用 |
+| `session_search` | 搜索历史会话记录 |
+| `execute_code` | 在沙箱中执行代码 |
+| `process` | 后台进程管理 |
+| `vision_analyze` | 图像分析 |
+| `image_generate` | 图像生成 |
+| `clarify` | 向用户提出澄清性问题 |
+| `browser_*` | 浏览器自动化工具集 |
+| `mixture_of_agents` | 多智能体高级推理 |

package/plugins/superharness/commands/free.md

@@ -0,0 +1,6 @@
+---
+description: 进入或退出 free-mode；暂停 superharness workflow context 注入
+allowed-tools: Bash
+---
+
+!node "${CLAUDE_PLUGIN_ROOT}/scripts/set-free-mode.mjs" "$PWD" "$ARGS"

package/plugins/superharness/commands/rollback.md

@@ -0,0 +1,30 @@
+---
+description: 回退 workflow state 到 transition_log 中走过的某个 state（用户控制）
+allowed-tools: mcp__plugin_superharness_superharness-workflow-state__list_history, AskUserQuestion, Bash
+---
+
+# /rollback $ARGS
+
+用户输入了 `/rollback $ARGS`。按以下步骤执行：
+
+**步骤 1**：调 `list_history(workspaceRoot=$PWD)` 拿历史。
+
+**步骤 2 解析参数**：
+
+- 若 `$ARGS` 非空：把 `$ARGS` 当目标 state 名。从 transition_log 中过滤 `to_state == $ARGS` 是否存在：
+  - 存在 → 跳到步骤 4，目标 = `$ARGS`
+  - 不存在 → 报错并列出"曾走过的 state"让用户重新指定
+
+- 若 `$ARGS` 为空：
+  - 从 transition_log 提取 to_state，按时间倒序去重，取**最近 5 个独特 state**
+  - 用 AskUserQuestion 让用户选 → 选中作为目标 state，跳到步骤 4
+
+**步骤 4 执行 rollback**：
+
+```bash
+!node "${CLAUDE_PLUGIN_ROOT}/scripts/rollback.mjs" "$PWD" "<chosen_state>" "[rollback] 用户 /rollback $ARGS"
+```
+
+**步骤 5 报告**：根据脚本 stdout 简短报告"已从 X 回到 Y"。
+
+**不要**继续做其他事：不要补 transition_state、不要继续之前 state 的任务。下一轮 UserPromptSubmit hook 会注入新 state SKILL.md。

package/plugins/superharness/commands-codex/free.md

@@ -0,0 +1,29 @@
+---
+description: 进入或退出 free-mode；暂停 superharness workflow context 注入（Codex）
+allowed-tools: shell_command
+---
+
+# /free $ARGS
+
+用户输入了 `/free $ARGS`。这是 Codex 兼容 command：不要把下面的命令展示给用户后停止，必须由 agent 调用 shell tool 直接执行。
+
+解析 `$ARGS`：
+
+- 空或 `status`：查询状态
+- `on`：进入 free mode
+- `off`：退出 free mode
+- 其他值：报告用法 `/free [on|off|status]` 并停止
+
+在 PowerShell 中执行：
+
+```powershell
+node "{{SUPERHARNESS_PLUGIN_ROOT}}\scripts\set-free-mode.mjs" (Get-Location).Path "$ARGS"
+```
+
+在 bash/Git Bash 中执行：
+
+```bash
+node "{{SUPERHARNESS_PLUGIN_ROOT}}/scripts/set-free-mode.mjs" "$PWD" "$ARGS"
+```
+
+根据 stdout 简短报告结果。不要继续做其他事，不要补 transition_state。

package/plugins/superharness/commands-codex/rollback.md

@@ -0,0 +1,33 @@
+---
+description: 回退 workflow state 到 transition_log 中走过的某个 state（Codex 用户控制）
+allowed-tools: mcp__plugin_superharness_superharness-workflow-state__list_history, shell_command, request_user_input
+---
+
+# /rollback $ARGS
+
+用户输入了 `/rollback $ARGS`。这是 Codex 兼容 command：最终 rollback 命令必须由 agent 调用 shell tool 直接执行。
+
+步骤 1：调用 `list_history(workspaceRoot=<当前工作目录>)` 获取历史。
+
+步骤 2：解析参数。
+
+- `$ARGS` 非空：把 `$ARGS` 当目标 state 名。从 transition_log 中过滤 `to_state == $ARGS` 是否存在。不存在就报错，并列出曾走过的 state。
+- `$ARGS` 为空：从 transition_log 提取 `to_state`，按时间倒序去重，取最近 5 个独特 state，让用户选择。
+
+步骤 3：执行 rollback。
+
+PowerShell：
+
+```powershell
+node "{{SUPERHARNESS_PLUGIN_ROOT}}\scripts\rollback.mjs" (Get-Location).Path "<chosen_state>" "[rollback] 用户 /rollback $ARGS"
+```
+
+bash/Git Bash：
+
+```bash
+node "{{SUPERHARNESS_PLUGIN_ROOT}}/scripts/rollback.mjs" "$PWD" "<chosen_state>" "[rollback] 用户 /rollback $ARGS"
+```
+
+步骤 4：根据 stdout 简短报告“已从 X 回到 Y”。
+
+不要调用 `transition_state`，不要继续之前 state 的任务。下一轮 UserPromptSubmit hook 会注入新 state SKILL.md。