@shirlytaylor73/superharness 1.5.0

package/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/README.md

@@ -0,0 +1,202 @@
+# Superharness
+
+Superharness 是面向 AI 编程代理的程序化工作流运行时。它把“什么时候该做需求分析、什么时候该写计划、什么时候该执行、什么时候必须验证”从纯 prompt 纪律升级为可校验、可审计、可恢复的状态机。
+
+核心能力：
+
+- **状态机驱动的 active skills**：覆盖会话入口分流（intake）、只读探索、轻量改动、需求澄清、计划编写、串行/并行执行、TDD、系统化调试、代码审查、完成前验证、分支收尾、中文工程规范等开发环节。
+- **程序化状态机**：默认工作流由 `workflow/default-workflow.yaml` 描述，状态切换通过 MCP 工具管理，而不是让 agent 直接改状态文件。
+- **Hook 动态注入**：Claude Code / Codex 通过 `UserPromptSubmit` 注入当前工作流上下文。
+- **状态保护**：`PreToolUse` 阻止直接写入 `.superharness/`，要求通过工作流状态工具完成状态变更。
+- **双端支持**：Claude Code、Codex 都接入同一套 skills、状态机与上下文渲染机制。
+- **用户控制命令**：`/rollback` 和 `/free` 把“何时回退、何时暂停 workflow”的决策权交还给用户。
+  - **`/rollback [state]`**：把当前 workflow state 回退到 `transition_log` 中走过的某个历史 state。
+    - 无参 → 列出最近 5 个独特 state 供选择。
+    - 有参（如 `/rollback brainstorming`）→ 直接回到指定 state。
+    - 仅允许回退到日志里真实出现过的 state，避免凭空跳转。
+  - **`/free on|off|status`**：会话级暂停 / 恢复 workflow context 注入。
+    - free-mode 期间 hook 不再注入 SKILL.md，MCP 的 mutating 工具（`transition_state` / `classify_request` / `release_stop_block`）全部锁定。
+    - `.superharness/` 写保护始终生效，free mode 不影响审计与状态文件的安全性。
+    - 适合临时跳出状态机做一些不想被规范约束的探索或对话。
+
+## 架构
+
+```text
+用户请求
+  -> Hook 注入当前工作流状态
+  -> Agent 按 active skill 执行
+  -> superharness-workflow-state MCP 管理状态跳转
+  -> .superharness/ 持久化状态与审计事实
+```
+
+### 工作流状态机（v3）
+
+每次会话都从 `intake` 开始，由它把请求分流到三条支线之一；执行支线结束后再回到 `intake` 等待下一任务。`systematic_debugging` 是抢占式分支，任何执行/验证/收尾节点失败都可以转入，调试完成后通过 `previous_state` 回边返回原状态：
+
+`intake → exploration / trivial / (brainstorming → planning → serial_execution | parallel_execution → verification → finishing) → intake`
+
+```mermaid
+flowchart TD
+    START([Session start]) --> Intake
+    Intake[intake]:::interactive
+    Explor[exploration]:::interactive
+    Triv[trivial]:::execution
+    BS[brainstorming]:::interactive
+    PL[planning]:::interactive
+    SE[serial_execution]:::execution
+    PE[parallel_execution]:::execution
+    VF[verification]:::gate
+    FN[finishing]:::gate
+    DBG[/systematic_debugging/]:::preempt
+
+    Intake -->|只读探索| Explor
+    Intake -->|轻量改动| Triv
+    Intake -->|功能/bugfix| BS
+
+    Explor --> Intake
+    Triv --> Intake
+
+    BS --> PL
+    PL -->|串行| SE
+    PL -->|并行| PE
+    SE --> VF
+    PE --> VF
+    VF --> FN
+    FN -->|下一任务| Intake
+
+    Triv -.->|测试失败/报错| DBG
+    SE -.->|遇到 bug| DBG
+    PE -.->|遇到 bug| DBG
+    VF -.->|验证失败| DBG
+    FN -.->|git/CI 失败| DBG
+
+    DBG -.->|previous_state| Intake
+    DBG -->|重写计划| PL
+    DBG -->|重新执行| SE
+
+    classDef interactive fill:#065f46,stroke:#10b981,color:#fff
+    classDef router fill:#78350f,stroke:#f59e0b,color:#fff
+    classDef execution fill:#1e40af,stroke:#3b82f6,color:#fff
+    classDef gate fill:#7f1d1d,stroke:#ef4444,color:#fff
+    classDef preempt fill:#581c87,stroke:#a855f7,color:#fff
+```
+
+关键目录：
+
+| 路径 | 说明 |
+|---|---|
+| `plugins/superharness/skills/` | 当前 active skills 目录 |
+| `plugins/superharness/workflow/` | 默认工作流配置 |
+| `plugins/superharness/workflow-state-server/` | 状态机 MCP 与渲染逻辑 |
+| `plugins/superharness/hooks/` | Claude Code / Codex hook 配置与入口 |
+| `plugins/superharness/archived-skills/` | 已归档、不可发现的历史 skill |
+
+## 安装
+
+### Claude Code
+
+```text
+/plugin marketplace add ShirlyTaylor73/superharness
+/plugin install superharness@superharness
+```
+
+更新 / 卸载：
+
+```text
+/plugin update superharness
+/plugin uninstall superharness
+```
+
+### Codex CLI
+
+#### Codex 快速安装
+
+```bash
+npx @shirlytaylor73/superharness@latest
+```
+
+安装器会用方向键询问安装到当前项目目录还是用户级目录。项目级会写入 `.agents/skills/` 和 `.codex/`；用户级会写入 `~/.agents/skills/` 和 `~/.codex/`。非交互环境使用：
+
+```bash
+npx @shirlytaylor73/superharness@latest --project
+npx @shirlytaylor73/superharness@latest --user
+```
+
+安装器会把 active skills 平铺安装到 `.agents/skills/`，并把 Codex 版 `free` / `rollback` command 写入 `.codex/commands/`。由于 Codex 不支持 Claude Code 的 `!node` 原生 command 执行语法，Codex command 会指示 agent 用 shell tool 执行等价 Node 脚本。
+
+#### Codex 插件市场
+
+```bash
+codex plugin marketplace add ShirlyTaylor73/superharness
+```
+
+然后启动 Codex，输入 `/plugins`，选择 `superharness` 安装。
+
+更新 / 移除：
+
+```bash
+codex plugin marketplace upgrade superharness
+codex plugin marketplace remove superharness
+```
+
+### 本地开发安装
+
+```bash
+git clone https://github.com/ShirlyTaylor73/superharness.git
+cd superharness
+```
+
+Claude / Codex 推荐使用插件市场安装。若只想手动使用 skills，可把 `plugins/superharness/skills/` 复制或链接到目标工具的 skills 目录。
+
+常见目标目录：
+
+| 工具 | skills 目录 |
+|---|---|
+| Claude Code | `.claude/skills/` |
+| Codex CLI | `.agents/skills/` |
+| Gemini CLI | `.gemini/skills/` |
+| Aider | `.aider/skills/` |
+| Windsurf | `.windsurf/skills/` |
+| OpenClaw | `skills/` |
+
+## Active Skills
+
+| Skill | 用途 |
+|---|---|
+| `intake` | 会话入口与请求 triage（分流到 exploration / trivial / brainstorming） |
+| `exploration` | 只读深度探索，不写文件 |
+| `trivial` | 单点轻量改动 + 自带验证 |
+| `brainstorming` | 需求澄清与设计规格 |
+| `planning` | 编写可执行实现计划 |
+| `serial-execution` | 小计划串行执行 |
+| `parallel-execution` | 大计划 wave 化并行执行 |
+| `test-driven-development` | TDD 红绿重构 |
+| `systematic-debugging` | 系统化定位和修复问题 |
+| `requesting-code-review` | 请求代码审查 |
+| `receiving-code-review` | 处理代码审查反馈 |
+| `verification` | 完成前验证 |
+| `finishing` | 开发分支收尾 |
+| `dispatching-parallel-agents` | 非 plan 场景并行派发 |
+| `using-git-worktrees` | 隔离式开发工作树 |
+| `writing-skills` | 创建和改进 skills |
+| `chinese-code-review` | 中文团队代码审查规范 |
+| `chinese-git-workflow` | 国内 Git 平台工作流 |
+| `chinese-documentation` | 中文技术文档规范 |
+| `chinese-commit-conventions` | 中文提交规范 |
+| `mcp-builder` | MCP 服务器构建方法论 |
+| `workflow-runner` | 多角色 YAML 工作流执行 |
+
+## 废弃机制
+
+历史入口 skill `using-superpowers` 已归档到 `archived-skills/`，不再注册、不再注入、不再作为运行时入口。当前入口由 hook 注入的 workflow context 和 `superharness-workflow-state` MCP 接管。
+
+## 验证
+
+```bash
+cd plugins/superharness/workflow-state-server
+npm.cmd test
+```
+
+## License
+
+MIT

package/bin/lib/codex-installer.js

@@ -0,0 +1,228 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+export const INSTALLER_TOKEN = `{{SUPERHARNESS_${'PLUGIN_ROOT'}}}`;
+export const COMMAND_NAMES = ['free.md', 'rollback.md'];
+const LEGACY_PLUGIN_ROOT_PLACEHOLDER = `installed-${'plugin-root'}`;
+
+export function parseArgs(argv) {
+  const parsed = { mode: null, force: false, help: false };
+
+  for (const arg of argv) {
+    if (arg === '--project') {
+      setMode(parsed, 'project');
+    } else if (arg === '--user' || arg === '--global') {
+      setMode(parsed, 'user');
+    } else if (arg === '--force') {
+      parsed.force = true;
+    } else if (arg === '--help' || arg === '-h') {
+      parsed.help = true;
+    } else {
+      throw new Error(`unknown argument: ${arg}`);
+    }
+  }
+
+  return parsed;
+}
+
+function setMode(parsed, mode) {
+  if (parsed.mode && parsed.mode !== mode) {
+    throw new Error('choose only one install target');
+  }
+  parsed.mode = mode;
+}
+
+export function resolveInstallTarget({
+  mode,
+  cwd = process.cwd(),
+  homeDir = process.env.USERPROFILE || process.env.HOME,
+}) {
+  if (mode !== 'project' && mode !== 'user') {
+    throw new Error('install target must be project or user');
+  }
+  if (mode === 'user' && !homeDir) {
+    throw new Error('cannot resolve user home directory');
+  }
+
+  const codexRoot = mode === 'project'
+    ? path.resolve(cwd, '.codex')
+    : path.resolve(homeDir, '.codex');
+  const agentsRoot = mode === 'project'
+    ? path.resolve(cwd, '.agents')
+    : path.resolve(homeDir, '.agents');
+
+  return {
+    mode,
+    codexRoot,
+    agentsRoot,
+    pluginRoot: path.join(codexRoot, 'plugins', 'superharness'),
+    commandsRoot: path.join(codexRoot, 'commands'),
+    skillsRoot: path.join(agentsRoot, 'skills'),
+  };
+}
+
+export async function backupExistingPath(target, timestamp) {
+  if (!(await exists(target))) {
+    return null;
+  }
+
+  let backupPath = `${target}.bak-${timestamp}`;
+  let counter = 1;
+  while (await exists(backupPath)) {
+    backupPath = `${target}.bak-${timestamp}-${counter}`;
+    counter += 1;
+  }
+
+  await fs.rename(target, backupPath);
+  return backupPath;
+}
+
+export async function copyPluginRuntime({ packageRoot, pluginRoot, timestamp }) {
+  const source = path.join(packageRoot, 'plugins', 'superharness');
+  const backup = await backupExistingPath(pluginRoot, timestamp);
+  await fs.mkdir(path.dirname(pluginRoot), { recursive: true });
+  await fs.cp(source, pluginRoot, {
+    recursive: true,
+    filter: (sourcePath) => path.basename(sourcePath) !== 'node_modules',
+  });
+  return backup;
+}
+
+export async function copyAgentSkills({ packageRoot, skillsRoot, timestamp }) {
+  const source = path.join(packageRoot, 'plugins', 'superharness', 'skills');
+  const backups = [];
+  await fs.mkdir(skillsRoot, { recursive: true });
+
+  const entries = await fs.readdir(source, { withFileTypes: true });
+  for (const entry of entries) {
+    const sourcePath = path.join(source, entry.name);
+    const destination = path.join(skillsRoot, entry.name);
+    const backup = await backupExistingPath(destination, timestamp);
+    if (backup) {
+      backups.push(backup);
+    }
+    await fs.cp(sourcePath, destination, { recursive: entry.isDirectory() });
+  }
+
+  return backups;
+}
+
+export function renderCommandTemplate(template, pluginRoot) {
+  const rendered = template.replaceAll(INSTALLER_TOKEN, pluginRoot);
+  if (rendered.includes(INSTALLER_TOKEN) || rendered.includes(LEGACY_PLUGIN_ROOT_PLACEHOLDER)) {
+    throw new Error('command template still contains unresolved plugin root placeholder');
+  }
+  return rendered;
+}
+
+export async function installWorkflowDependencies({ pluginRoot, runCommand = spawnCommand }) {
+  const cwd = path.join(pluginRoot, 'workflow-state-server');
+  try {
+    await runCommand('npm', ['install', '--omit=dev'], { cwd });
+  } catch (error) {
+    throw new Error(`npm install --omit=dev failed in ${cwd}: ${error.message}`);
+  }
+}
+
+export async function installCodexSupport({
+  mode,
+  cwd = process.cwd(),
+  homeDir = process.env.USERPROFILE || process.env.HOME,
+  packageRoot,
+  now = () => new Date(),
+  runCommand,
+} = {}) {
+  assertSupportedNode();
+  if (!packageRoot) {
+    throw new Error('packageRoot is required');
+  }
+
+  const target = resolveInstallTarget({ mode, cwd, homeDir });
+  const timestamp = formatTimestamp(now());
+  const backups = [];
+
+  await fs.mkdir(target.commandsRoot, { recursive: true });
+  const pluginBackup = await copyPluginRuntime({
+    packageRoot,
+    pluginRoot: target.pluginRoot,
+    timestamp,
+  });
+  if (pluginBackup) {
+    backups.push(pluginBackup);
+  }
+  backups.push(...await copyAgentSkills({
+    packageRoot,
+    skillsRoot: target.skillsRoot,
+    timestamp,
+  }));
+
+  for (const commandName of COMMAND_NAMES) {
+    const source = path.join(packageRoot, 'plugins', 'superharness', 'commands-codex', commandName);
+    const destination = path.join(target.commandsRoot, commandName);
+    const template = await fs.readFile(source, 'utf8');
+    const rendered = renderCommandTemplate(template, target.pluginRoot);
+    const backup = await backupExistingPath(destination, timestamp);
+    if (backup) {
+      backups.push(backup);
+    }
+    await fs.writeFile(destination, rendered, 'utf8');
+  }
+
+  await installWorkflowDependencies({ pluginRoot: target.pluginRoot, runCommand });
+
+  return {
+    mode: target.mode,
+    pluginRoot: target.pluginRoot,
+    commandsRoot: target.commandsRoot,
+    skillsRoot: target.skillsRoot,
+    backups,
+  };
+}
+
+function assertSupportedNode() {
+  const major = Number.parseInt(process.versions.node.split('.')[0], 10);
+  if (major < 20) {
+    throw new Error(`Superharness Codex installer requires Node.js >=20; current version is ${process.version}`);
+  }
+}
+
+function formatTimestamp(date) {
+  const parts = [
+    date.getUTCFullYear(),
+    date.getUTCMonth() + 1,
+    date.getUTCDate(),
+    date.getUTCHours(),
+    date.getUTCMinutes(),
+    date.getUTCSeconds(),
+  ].map((part, index) => (index === 0 ? String(part) : String(part).padStart(2, '0')));
+
+  return `${parts[0]}${parts[1]}${parts[2]}-${parts[3]}${parts[4]}${parts[5]}`;
+}
+
+async function exists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function spawnCommand(command, args, options) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+      ...options,
+      stdio: 'inherit',
+      shell: process.platform === 'win32',
+    });
+    child.on('error', reject);
+    child.on('exit', (code, signal) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(signal ? `terminated by ${signal}` : `exited with code ${code}`));
+      }
+    });
+  });
+}

package/bin/lib/interactive-select.js

@@ -0,0 +1,96 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import readline from 'node:readline';
+
+const OPTIONS = [
+  {
+    value: 'project',
+    label: 'Project install',
+    description: "Install into this repository's .agents and .codex directories",
+  },
+  {
+    value: 'user',
+    label: 'User install',
+    description: 'Install into ~/.agents and ~/.codex for all Codex projects',
+  },
+  {
+    value: 'cancel',
+    label: 'Cancel',
+    description: '',
+  },
+];
+
+export async function selectInstallTarget({
+  cwd = process.cwd(),
+  input = process.stdin,
+  output = process.stdout,
+} = {}) {
+  let selectedIndex = await hasCodexDir(cwd) ? 0 : 1;
+
+  readline.emitKeypressEvents(input);
+  const canSetRawMode = typeof input.setRawMode === 'function';
+  if (canSetRawMode) {
+    input.setRawMode(true);
+  }
+  input.resume();
+  render(output, selectedIndex, false);
+
+  return new Promise((resolve) => {
+    const finish = (value) => {
+      input.off('keypress', onKeypress);
+      if (canSetRawMode) {
+        input.setRawMode(false);
+      }
+      output.write('\n');
+      resolve(value);
+    };
+
+    const onKeypress = (_text, key = {}) => {
+      if (key.ctrl && key.name === 'c') {
+        finish('cancel');
+        return;
+      }
+      if (key.name === 'up') {
+        selectedIndex = (selectedIndex + OPTIONS.length - 1) % OPTIONS.length;
+        render(output, selectedIndex, true);
+        return;
+      }
+      if (key.name === 'down') {
+        selectedIndex = (selectedIndex + 1) % OPTIONS.length;
+        render(output, selectedIndex, true);
+        return;
+      }
+      if (key.name === 'return' || key.name === 'enter') {
+        finish(OPTIONS[selectedIndex].value);
+      }
+    };
+
+    input.on('keypress', onKeypress);
+  });
+}
+
+async function hasCodexDir(cwd) {
+  try {
+    const stat = await fs.stat(path.join(cwd, '.codex'));
+    return stat.isDirectory();
+  } catch {
+    return false;
+  }
+}
+
+function render(output, selectedIndex, rerender) {
+  if (rerender) {
+    output.write('\x1b[5A\x1b[J');
+  }
+
+  const lines = [
+    'Where should Superharness Codex support be installed?',
+    '',
+    ...OPTIONS.map((option, index) => {
+      const prefix = index === selectedIndex ? '>' : ' ';
+      return `${prefix} ${option.label.padEnd(16)}${option.description}`;
+    }),
+  ];
+
+  output.write(`${lines.join('\n')}\n`);
+}

package/bin/superharness.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { installCodexSupport, parseArgs } from './lib/codex-installer.js';
+import { selectInstallTarget } from './lib/interactive-select.js';
+
+export async function main(argv = process.argv.slice(2), env = process.env) {
+  const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+  const options = parseArgs(argv);
+
+  if (options.help) {
+    process.stdout.write(usage());
+    return 0;
+  }
+
+  let mode = options.mode;
+  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY && !env.CI);
+  if (!mode) {
+    if (!interactive) {
+      throw new Error('non-interactive install requires --project or --user');
+    }
+    mode = await selectInstallTarget();
+    if (mode === 'cancel') {
+      return 0;
+    }
+  }
+
+  const result = await installCodexSupport({ mode, packageRoot });
+  process.stdout.write(successMessage(result));
+  return 0;
+}
+
+export function usage() {
+  return `Usage: superharness [--project|--user] [--force]
+
+Install Superharness Codex support into project or user .agents and .codex directories.
+
+Options:
+  --project   Install into the current repository's .agents and .codex directories
+  --user      Install into ~/.agents and ~/.codex for all Codex projects
+  --global    Alias for --user
+  --force     Backup and overwrite existing installed assets
+  -h, --help  Show this help
+`;
+}
+
+function successMessage({ mode, pluginRoot, commandsRoot, skillsRoot, backups }) {
+  const scope = mode === 'project' ? 'project' : 'user';
+  const backupLine = backups.length > 0
+    ? `Backups created:\n${backups.map((backup) => `  - ${backup}`).join('\n')}\n`
+    : '';
+
+  return `Superharness Codex support installed for ${scope} scope.
+Skills: ${skillsRoot}
+Plugin: ${pluginRoot}
+Commands: ${commandsRoot}
+${backupLine}`;
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  main().then((code) => {
+    process.exitCode = code;
+  }).catch((error) => {
+    process.stderr.write(`${error.message}\n`);
+    process.exitCode = 1;
+  });
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@shirlytaylor73/superharness",
+  "version": "1.5.0",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "description": "Programmatic workflow harness for AI coding agents with skills, hooks, MCP state management, and cross-client support.",
+  "type": "module",
+  "bin": {
+    "superharness": "bin/superharness.js"
+  },
+  "files": [
+    "bin/",
+    "plugins/superharness/"
+  ],
+  "scripts": {
+    "test:installer": "node --test tests/codex-installer/*.test.mjs"
+  },
+  "keywords": [
+    "superharness",
+    "claude-code",
+    "codex",
+    "gemini",
+    "kiro",
+    "deerflow",
+    "trae",
+    "antigravity",
+    "openclaw",
+    "windsurf",
+    "aider",
+    "qwen",
+    "vscode",
+    "copilot",
+    "hermes",
+    "hermes-agent",
+    "claw-code",
+    "ai-coding",
+    "skills",
+    "chinese",
+    "中文",
+    "tdd",
+    "debugging",
+    "code-review"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ShirlyTaylor73/superharness.git"
+  },
+  "homepage": "https://github.com/ShirlyTaylor73/superharness",
+  "author": "ShirlyTaylor73",
+  "license": "MIT"
+}

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

@@ -0,0 +1,19 @@
+{
+  "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"],
+  "mcpServers": {
+    "superharness-workflow-state": {
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/workflow-state-server/bootstrap.js"]
+    }
+  }
+}