{"_id":"@antares123/ai-coding-workflow","name":"@antares123/ai-coding-workflow","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@antares123/ai-coding-workflow","version":"1.0.0","description":"AI coding assistant workflow skill library — Superpowers + OpenSpec team skills for Codex, Cursor, and Claude Code","bin":{"spec":"bin/superpowers-install.js"},"scripts":{"build":"node scripts/build-dist.js","postinstall":"echo 'Superpowers + OpenSpec team skills installed. Run: npx superpowers-install --help'","prepublishOnly":"npm run build && node -e \"const fs=require('fs'); ['dist','team-skills','scripts','templates'].forEach(d=>{if(!fs.existsSync(d)){console.error('Missing: '+d);process.exit(1)}})\""},"publishConfig":{"access":"public"},"keywords":["superpowers","openspec","ai-workflow","claude-code","cursor","codex","tdd","ai-coding"],"author":"","license":"MIT","repository":{"type":"git","url":""},"engines":{"node":">=14.0.0"},"gitHead":"72c2b46655bc8f11bb57ebba01bf4e53acfe8b71","_id":"@antares123/ai-coding-workflow@1.0.0","_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-GTllfH+rbRu6ta4BfEdAFbdU6q4eG3nTAcIp8Ve8TaTMC9Zv5ijn8GR6crpFu3yZNuxeUk57uQ8g0fdTo6vceg==","shasum":"87b713ac6fe5046439d8404827597cc269428ab5","tarball":"https://registry.npmjs.org/@antares123/ai-coding-workflow/-/ai-coding-workflow-1.0.0.tgz","fileCount":142,"unpackedSize":347715,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDDH1EaNiaSNZF2HZhQ4I8b56EF5IeVXSEjiPIu3X63iwIgcMe1cNjDs28u062D5lDinhafhqm5okF1sDwM7YPlxP0="}]},"_npmUser":{"name":"antares123","email":"2531646835@qq.com"},"directories":{},"maintainers":[{"name":"antares123","email":"2531646835@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ai-coding-workflow_1.0.0_1778675582736_0.5928197671642477"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-13T12:33:02.647Z","1.0.0":"2026-05-13T12:33:02.884Z","modified":"2026-05-13T12:33:03.125Z"},"maintainers":[{"name":"antares123","email":"2531646835@qq.com"}],"description":"AI coding assistant workflow skill library — Superpowers + OpenSpec team skills for Codex, Cursor, and Claude Code","keywords":["superpowers","openspec","ai-workflow","claude-code","cursor","codex","tdd","ai-coding"],"repository":{"type":"git","url":""},"license":"MIT","readme":"# Superpowers + OpenSpec Team Skills\n\n## 中文文档\n\n中文读者可以从这里开始：\n\n- [README.cn.md](README.cn.md)\n- [MEMORY.cn.md](MEMORY.cn.md)\n- [VERIFY.cn.md](VERIFY.cn.md)\n- [team-skills/INSTALL.cn.md](team-skills/INSTALL.cn.md)\n- [team-skills/README.cn.md](team-skills/README.cn.md)\n\n这是一套面向 AI 编程助手的带有记忆和自主学习工作流技能库。目标很直接：让智能体按流程做事，而不是一上来就直接写代码。用户可以按需组合 Superpowers 和 OpenSpec 使用。\n\n这个仓库现在分成两层：\n\n- `team-skills/`：项目维护的源码级 workflow 定义\n- `dist/`：面向 Codex、Cursor、Claude Code 等具体工具的预适配 bundle\n\n如果你是使用者，请优先使用 `dist/` 和 `scripts/`。不要从 `team-skills/` 里复制单个编排 workflow，除非你有意自己扩展或适配源码定义。\n\n`team-skills/` 下的源码 workflow 和 `dist/` 下的工具 bundle 在措辞和结构上可能不同，但功能上应保持一致。源码 workflow 是面向维护者的定义；分发 bundle 是同一 workflow 面向具体工具的运行时形态。\n\n重要说明：这些 workflow 都是显式启用型流程。它们不应该变成 AI 工具的默认后台行为。用户应通过明确请求、点名 workflow，或因仓库策略明确要求来启用它们。\n\n如果你希望 Codex 在没有被显式调用时忽略这些 workflow，可以只安装 bundle，但只在对话中通过 workflow 名称来激活它。\n\n示例：\n\n```text\nUse $superpowers-openspec-execution-workflow for this feature.\n```\n\n## 开始前先看\n\n### 这套技能库的价值\n\n这个仓库适合希望 AI 编程工具别一上来就直接写代码，而是按更稳的交付路径做事的团队：\n\n- 先澄清，再实现\n- 先确认行为，再做有风险的改动\n- 实现时带上测试和验证\n- 完成后有清晰的归档收尾\n- 把项目上下文持续记在仓库里，让新会话不是从空白开始\n\n### 项目记忆\n\n这个仓库现在额外支持一套可选的、持久化到仓库里的 Superpowers 记忆模式。\n\n当目标项目中存在 `.superpowers-memory/` 时，Superpowers workflow 应该：\n\n- 读取 `PROJECT_CONTEXT.md`，了解稳定的项目事实\n- 读取 `CURRENT_STATE.md`，了解最新工作上下文\n- 读取 `DECISIONS.md` 和 `KNOWN_FAILURES.md`（如果存在）\n- 阅读 `session-journal/` 里的最近记录\n- 在会话结束前更新相关记忆文件\n- 当 workflow 依赖记忆质量时，运行 `scripts/validate-superpowers-memory.ps1`\n\n这样不用单独部署记忆服务，也能让 AI 拥有轻量的跨会话记忆。\n\n推荐的默认用法：让工具在新会话开始时先读取 repo memory，平时至少保持 `PROJECT_CONTEXT.md` 和 `CURRENT_STATE.md` 基本可用、基本最新；做完一轮有意义的工作后，用 `superpowers-learning` 作为默认记忆收尾入口。不要期待普通聊天自动把内容写回 memory 文件；如果想更轻量一点，可以改用 `scripts/run-superpowers-memory-closeout.ps1`。\n\n### 运行要求\n\n- 使用创建或检查 OpenSpec change 的 workflow 时，需要安装 OpenSpec CLI\n- 需要一个实际项目仓库，智能体可以在其中写入设计文档、计划、OpenSpec change、代码、测试和验证输出\n- 可选：如需跨会话记忆，目标项目中需要有 `.superpowers-memory/` 文件夹\n\n### 推荐入口\n\n- `openspec-superpowers`：从需求澄清到验证完成的完整功能流程\n- `superpowers-openspec-execution`：Superpowers 探索 → OpenSpec 固化 → Superpowers 执行验证 → OpenSpec 归档\n- `superpowers-feature`：设计、计划、TDD 和验证，不生成 OpenSpec 产物\n- `superpowers-learning`：反思型沉淀，保存持久项目知识、会话成果和可复用经验\n- `openspec-feature`：在实现之前先创建 OpenSpec proposal、design、specs 和 tasks\n\n### 怎么选择\n\n- 如果你想要一个端到端的统一入口，不想自己决定步骤顺序，用 `openspec-superpowers`。它是从需求澄清到验证完成的通用全流程选项。\n- 如果你想要固定的四步路径——Superpowers 探索、OpenSpec 固化、Superpowers 执行、OpenSpec 归档——用 `superpowers-openspec-execution`。\n- 如果你只需要 Superpowers 的工程纪律，不需要 OpenSpec change 产物，用 `superpowers-feature`。\n- 如果重要工作已经结束，你想保存这次会话教会了团队什么，用 `superpowers-learning`。\n- 如果你只想在实现之前先创建或补齐 OpenSpec change 产物，用 `openspec-feature`。\n\n### 推荐收尾方式\n\n对于长期协作的项目，一个比较好的模式是：\n\n1. 先用一个交付型 workflow\n2. 完成实现和验证\n3. 再用 `superpowers-learning` 保存持久经验和当前状态\n\n## 包含内容\n\n源码 workflow：\n\n- [OpenSpec + Superpowers Workflow](team-skills/openspec-superpowers-workflow/README.md)\n- [Superpowers -> OpenSpec -> Superpowers Workflow](team-skills/superpowers-openspec-execution-workflow/README.md)\n- [Superpowers Feature Workflow](team-skills/superpowers-feature-workflow/README.md)\n- [Superpowers Learning Workflow](team-skills/superpowers-learning-workflow/README.md)\n- [OpenSpec Feature Workflow](team-skills/openspec-feature-workflow/README.md)\n\n每个源码 workflow 现在还包含一个机器可读的 `workflow.yaml` 文件，用于依赖和工具元数据。\n\n## 仓库结构\n\n```text\nteam-skills/   源码 workflow 定义\ndist/          面向具体工具的预构建 bundle\nscripts/       支持工具的安装脚本\nbin/           CLI 入口 (superpowers-install)\n```\n\n## 社区\n\n如果你想贡献或审查仓库策略，可以从这里开始：\n\n- [CONTRIBUTING.md](CONTRIBUTING.md)\n- [SECURITY.md](SECURITY.md)\n- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)\n- [CHANGELOG.md](CHANGELOG.md)\n- [docs/enhancement-overview.cn.md](docs/enhancement-overview.cn.md)\n- [docs/layered-adoption-model.cn.md](docs/layered-adoption-model.cn.md)\n\n仓库还包含一个基础的 GitHub Actions CI workflow，用于治理文件检查和记忆脚本冒烟测试。\n\n## 快速开始\n\n### 通过 npm 安装（推荐）\n\n```bash\nnpm install @your-company/superpowers-openspec-team-skills\n\n# 查看可用工作流\nnpx superpowers-install list\n\n# 查看指定工具的可用工作流\nnpx superpowers-install list --tool claude-code\n\n# 安装 workflow bundle 到你的项目\nnpx superpowers-install claude-code --bundle superpowers-openspec-execution --project-root ./my-project\nnpx superpowers-install cursor --bundle openspec-superpowers --project-root ./my-project\nnpx superpowers-install codex --bundle superpowers-feature --codex-home ~/.codex\n\n# 安装记忆脚手架和集成\nnpx superpowers-install memory --project-root ./my-project\nnpx superpowers-install memory-integ --tool all --project-root ./my-project\n```\n\n### 通过安装脚本安装（适用于本地克隆仓库）\n\n本文里的 `<repo-root>`，指的是你把这个仓库 clone 下来或解压之后，它在你本机上的实际路径。\n\n例如：\n\n- macOS：`/Users/alex/projects/superpowers-openspec-team-skills`\n- Linux：`/home/alex/projects/superpowers-openspec-team-skills`\n- Windows：`D:\\projects\\superpowers-openspec-team-skills`\n\n所以这条命令：\n\n```bash\nsh \"<repo-root>/scripts/install-codex.sh\" --bundle openspec-superpowers --codex-home \"$HOME/.codex\"\n```\n\n实际可以写成：\n\n```bash\nsh \"/Users/alex/projects/superpowers-openspec-team-skills/scripts/install-codex.sh\" --bundle openspec-superpowers --codex-home \"$HOME/.codex\"\n```\n\n在运行安装脚本前，请先满足下面两种方式之一：\n\n- 先切换到仓库根目录再执行\n- 或者直接使用脚本的绝对路径执行\n\nWindows PowerShell：\n\n```powershell\ncd <repo-root>\n.\\scripts\\install-codex.ps1 -Bundle openspec-superpowers\n```\n\nWindows PowerShell 绝对路径方式：\n\n```powershell\n& \"<repo-root>\\scripts\\install-codex.ps1\" -Bundle openspec-superpowers\n```\n\nmacOS / Linux 原生 shell 方式：\n\n```bash\ncd <repo-root>\nsh \"<repo-root>/scripts/install-codex.sh\" --bundle openspec-superpowers --codex-home \"$HOME/.codex\"\n```\n\n如果系统里已经安装了 PowerShell 7（`pwsh`），也可以直接运行脚本：\n\n```bash\ncd <repo-root>\npwsh -File ./scripts/install-codex.ps1 -Bundle openspec-superpowers -CodexHome \"$HOME/.codex\"\n```\n\n### Shell 安装脚本参数\n\n原生 shell 安装脚本支持这些标志：\n\n- `--bundle <name>`：选择要安装的 bundle\n- `--project-root <path>`：为 Cursor、Claude Code 或记忆安装指定目标仓库根目录\n- `--codex-home <path>`：为 Codex 安装指定 Codex home 目录\n- `--dry-run`：只预览将写入什么，不实际复制文件\n- `--backup`：覆盖前先备份已有的目标文件\n- `--force`：跳过覆盖确认\n- `--check-dependencies`：只检查运行时依赖（如 `openspec`），不安装文件\n\n当前可用的 shell 安装脚本：\n\n- `scripts/install-codex.sh`\n- `scripts/install-cursor.sh`\n- `scripts/install-claude-code.sh`\n- `scripts/install-superpowers-memory.sh`\n- `scripts/install-superpowers-memory-integration.sh`\n\n为任意目标项目安装可选的记忆脚手架：\n\n```powershell\n.\\scripts\\install-superpowers-memory.ps1 -ProjectRoot <project-root>\n```\n\nmacOS / Linux 原生 shell 方式：\n\n```bash\nsh \"<repo-root>/scripts/install-superpowers-memory.sh\" --project-root <project-root>\n```\n\n如果系统里已经安装了 PowerShell 7（`pwsh`），也可以直接运行脚本：\n\n```bash\npwsh -File ./scripts/install-superpowers-memory.ps1 -ProjectRoot <project-root>\n```\n\n为 Codex、Cursor 和 Claude Code 安装可选的项目级记忆集成：\n\n```powershell\n.\\scripts\\install-superpowers-memory-integration.ps1 -Tool all -ProjectRoot <project-root>\n```\n\nmacOS / Linux 原生 shell 方式：\n\n```bash\nsh \"<repo-root>/scripts/install-superpowers-memory-integration.sh\" --tool all --project-root <project-root>\n```\n\n如果系统里已经安装了 PowerShell 7（`pwsh`），也可以直接运行脚本：\n\n```bash\npwsh -File ./scripts/install-superpowers-memory-integration.ps1 -Tool all -ProjectRoot <project-root>\n```\n\n安装完成后，记得重开或刷新项目，再新开一个会话，让工具先读取 repo memory；一轮有意义的工作结束后，优先用 `superpowers-learning` 来沉淀当前状态和可复用经验。\n\n### Codex\n\n请安装预构建的 Codex bundle，不要再手动复制源码 workflow。\n\nPowerShell：\n\n```powershell\n.\\scripts\\install-codex.ps1 -Bundle openspec-superpowers\n```\n\nmacOS / Linux 原生 shell 方式：\n\n```bash\nsh \"<repo-root>/scripts/install-codex.sh\" --bundle openspec-superpowers --codex-home \"$HOME/.codex\"\n```\n\n如果系统里已经安装了 PowerShell 7（`pwsh`），也可以直接运行脚本：\n\n```bash\npwsh -File ./scripts/install-codex.ps1 -Bundle openspec-superpowers -CodexHome \"$HOME/.codex\"\n```\n\n常用参数：\n\n```powershell\n.\\scripts\\install-codex.ps1 -Bundle openspec-superpowers -DryRun\n.\\scripts\\install-codex.ps1 -Bundle openspec-superpowers -Backup\n.\\scripts\\install-codex.ps1 -Bundle openspec-superpowers -Backup -Force\n.\\scripts\\install-codex.ps1 -Bundle openspec-superpowers -CheckDependencies\n```\n\nmacOS / Linux 原生 shell 示例：\n\n```bash\nsh \"<repo-root>/scripts/install-codex.sh\" --bundle openspec-superpowers --codex-home \"$HOME/.codex\" --dry-run\nsh \"<repo-root>/scripts/install-codex.sh\" --bundle openspec-superpowers --codex-home \"$HOME/.codex\" --backup\nsh \"<repo-root>/scripts/install-codex.sh\" --bundle openspec-superpowers --codex-home \"$HOME/.codex\" --backup --force\nsh \"<repo-root>/scripts/install-codex.sh\" --bundle openspec-superpowers --codex-home \"$HOME/.codex\" --check-dependencies\n```\n\nmacOS / Linux `pwsh` 示例：\n\n```bash\npwsh -File ./scripts/install-codex.ps1 -Bundle openspec-superpowers -CodexHome \"$HOME/.codex\" -DryRun\npwsh -File ./scripts/install-codex.ps1 -Bundle openspec-superpowers -CodexHome \"$HOME/.codex\" -Backup\npwsh -File ./scripts/install-codex.ps1 -Bundle openspec-superpowers -CodexHome \"$HOME/.codex\" -Backup -Force\npwsh -File ./scripts/install-codex.ps1 -Bundle openspec-superpowers -CodexHome \"$HOME/.codex\" -CheckDependencies\n```\n\n- `-DryRun`：只预览将安装什么，不实际复制文件\n- `-Backup`：覆盖前先备份同名 skill 目录\n- `-Force`：跳过覆盖确认\n- `-CheckDependencies`：只检查运行时依赖（如 `openspec`），不安装文件\n\n然后重启或刷新 Codex，再调用：\n\n```text\nUse $openspec-superpowers-workflow to run this feature from clarification through verification.\n```\n\n如果你没有明确要求使用这些 workflow 中的某一个，Codex 应该保持正常默认行为，而不应该默认假设要使用 Superpowers 或 OpenSpec 流程。\n\n当前可用的 Codex bundle：\n\n- `openspec-superpowers`\n- `superpowers-openspec-execution`\n- `superpowers-feature`\n- `superpowers-learning`\n- `openspec-feature`\n\n### Cursor\n\n将 Cursor bundle 安装到目标仓库根目录：\n\n```powershell\n.\\scripts\\install-cursor.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root>\n```\n\nmacOS / Linux 原生 shell 方式：\n\n```bash\nsh \"<repo-root>/scripts/install-cursor.sh\" --bundle openspec-superpowers --project-root <project-root>\n```\n\n如果系统里已经安装了 PowerShell 7（`pwsh`），也可以直接运行脚本：\n\n```bash\npwsh -File ./scripts/install-cursor.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root>\n```\n\n这会写入 `.cursor/rules/` 文件以及一个 `AGENTS.md` workflow 指南。\n\n重要说明：对 Cursor 来说，这些 workflow bundle 也应该按\"显式启用\"来使用。可以安装到项目里，但只有在对话中明确点名 workflow 时，才让 Cursor 按它执行。\n\n常用参数：\n\n```powershell\n.\\scripts\\install-cursor.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -DryRun\n.\\scripts\\install-cursor.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -Backup\n.\\scripts\\install-cursor.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -Backup -Force\n.\\scripts\\install-cursor.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -CheckDependencies\n```\n\nmacOS / Linux 原生 shell 示例：\n\n```bash\nsh \"<repo-root>/scripts/install-cursor.sh\" --bundle openspec-superpowers --project-root <project-root> --dry-run\nsh \"<repo-root>/scripts/install-cursor.sh\" --bundle openspec-superpowers --project-root <project-root> --backup\nsh \"<repo-root>/scripts/install-cursor.sh\" --bundle openspec-superpowers --project-root <project-root> --backup --force\nsh \"<repo-root>/scripts/install-cursor.sh\" --bundle openspec-superpowers --project-root <project-root> --check-dependencies\n```\n\nmacOS / Linux `pwsh` 示例：\n\n```bash\npwsh -File ./scripts/install-cursor.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -DryRun\npwsh -File ./scripts/install-cursor.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -Backup\npwsh -File ./scripts/install-cursor.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -Backup -Force\npwsh -File ./scripts/install-cursor.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -CheckDependencies\n```\n\n你也可以安装三段式执行 bundle：\n\n```powershell\n.\\scripts\\install-cursor.ps1 -Bundle superpowers-openspec-execution -ProjectRoot <project-root>\n```\n\nmacOS / Linux 原生 shell 方式：\n\n```bash\nsh \"<repo-root>/scripts/install-cursor.sh\" --bundle superpowers-openspec-execution --project-root <project-root>\n```\n\n如果系统里已经安装了 PowerShell 7（`pwsh`），也可以直接运行脚本：\n\n```bash\npwsh -File ./scripts/install-cursor.ps1 -Bundle superpowers-openspec-execution -ProjectRoot <project-root>\n```\n\n推荐的显式启用方式：\n\n```text\nUse the superpowers-openspec-execution workflow for this feature.\n```\n\n### Claude Code\n\n将 Claude Code bundle 安装到目标仓库根目录：\n\n```powershell\n.\\scripts\\install-claude-code.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root>\n```\n\nmacOS / Linux 原生 shell 方式：\n\n```bash\nsh \"<repo-root>/scripts/install-claude-code.sh\" --bundle openspec-superpowers --project-root <project-root>\n```\n\n如果系统里已经安装了 PowerShell 7（`pwsh`），也可以直接运行脚本：\n\n```bash\npwsh -File ./scripts/install-claude-code.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root>\n```\n\n这会写入 `.claude/commands/` 文件以及一个 `CLAUDE.md` 项目指南。\n\n重要说明：对 Claude Code 来说，安装 bundle 后，请优先用生成的 slash command 来激活 workflow，不建议只靠自然语言路由来触发。这样 Claude Code 会读取命令文件，并稳定应用 workflow 门禁。\n\n常用参数：\n\n```powershell\n.\\scripts\\install-claude-code.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -DryRun\n.\\scripts\\install-claude-code.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -Backup\n.\\scripts\\install-claude-code.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -Backup -Force\n.\\scripts\\install-claude-code.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -CheckDependencies\n```\n\nmacOS / Linux 原生 shell 示例：\n\n```bash\nsh \"<repo-root>/scripts/install-claude-code.sh\" --bundle openspec-superpowers --project-root <project-root> --dry-run\nsh \"<repo-root>/scripts/install-claude-code.sh\" --bundle openspec-superpowers --project-root <project-root> --backup\nsh \"<repo-root>/scripts/install-claude-code.sh\" --bundle openspec-superpowers --project-root <project-root> --backup --force\nsh \"<repo-root>/scripts/install-claude-code.sh\" --bundle openspec-superpowers --project-root <project-root> --check-dependencies\n```\n\nmacOS / Linux `pwsh` 示例：\n\n```bash\npwsh -File ./scripts/install-claude-code.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -DryRun\npwsh -File ./scripts/install-claude-code.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -Backup\npwsh -File ./scripts/install-claude-code.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -Backup -Force\npwsh -File ./scripts/install-claude-code.ps1 -Bundle openspec-superpowers -ProjectRoot <project-root> -CheckDependencies\n```\n\n你也可以安装三段式执行 bundle：\n\n```powershell\n.\\scripts\\install-claude-code.ps1 -Bundle superpowers-openspec-execution -ProjectRoot <project-root>\n```\n\nmacOS / Linux 原生 shell 方式：\n\n```bash\nsh \"<repo-root>/scripts/install-claude-code.sh\" --bundle superpowers-openspec-execution --project-root <project-root>\n```\n\n如果系统里已经安装了 PowerShell 7（`pwsh`），也可以直接运行脚本：\n\n```bash\npwsh -File ./scripts/install-claude-code.ps1 -Bundle superpowers-openspec-execution -ProjectRoot <project-root>\n```\n\n推荐的显式启用方式：\n\n```text\n/superpowers-openspec-execution-workflow\n<描述你的功能需求>\n```\n\n例如：\n\n```text\n/superpowers-openspec-execution-workflow\n增加点评门店信息。\n```\n\n安装后，请确认目标仓库里存在以下文件：\n\n```text\nCLAUDE.md\n.claude/commands/superpowers-openspec-execution-workflow.md\n```\n\n依赖 OpenSpec 的 bundle 即使在 `openspec` 缺失时也能安装，但脚本现在会在安装前给出警告，并且可以先显式检查依赖。\n\n## Bundle 分发模型\n\n这个仓库现在以 bundle 的形式分发面向用户的 workflow 包，而不是从源码树中复制单个文件夹。\n\n当前 bundle 目录：\n\n- `dist/codex/bundles/`\n- `dist/cursor/bundles/`\n- `dist/claude-code/bundles/`\n\n每个 bundle 只包含目标工具真正需要的文件。\n\n## 构建与安装的区别\n\n仓库里的脚本现在分成两种角色：\n\n- `install-*.ps1`：给最终用户安装 bundle 到 Codex、Cursor 或 Claude Code\n- `build-dist.ps1`：给维护者刷新和校验 `dist/` 下的分发层\n\n维护者命令示例：\n\n```powershell\n.\\scripts\\build-dist.ps1\n```\n\n当你修改了 `team-skills/` 下的源码 workflow、`workflow.yaml` 元数据，或调整了 bundle 结构约定时，就应该运行 `build-dist.ps1`。它不会向 AI 工具安装任何东西。它是发布和维护流程的一部分。\n\n## 为什么要这样改\n\n原来的源码 workflow 是模块化和可复用的，但部分入口 workflow 会依赖其他 workflow 或外部 skills。这对维护来说是好的，但对安装体验不好。\n\n新的结构通过明确区分来修复这个问题：\n\n- 源码 workflow 面向维护者\n- bundle 面向最终用户\n\n## 工具支持\n\n### Codex\n\nCodex 是目前最合适的工具，因为它原生支持 skills。请使用 `dist/codex/bundles/` 下的预构建 bundle，或 `scripts/install-codex.ps1` 下的安装脚本。\n\n### Cursor\n\nCursor 使用仓库规则和 agent 指令，而不是 Codex 风格的 skills。请使用 `dist/cursor/bundles/` 下的 bundle。\n\n### Claude Code\n\nClaude Code 使用命令文件和项目指令，而不是 Codex 风格的 skills。请使用 `dist/claude-code/bundles/` 下的 bundle。\n\n### 其他工具\n\n仓库的设计允许后续通过在 `dist/` 下添加新的 bundle 适配器来支持其他 agent 运行时。\n\n## 显式启用\n\n这些 workflow 只应在以下条件之一满足时激活：\n\n- 用户明确点名某个 workflow\n- 用户明确要求使用该 workflow 风格\n- 仓库策略明确要求使用该 workflow\n\n它们不应该被当成每个编码请求的默认后台行为。\n\n对 Codex 用户，最稳妥的模式是：\n\n1. 安装 bundle\n2. 保持正常的编码提问方式不变\n3. 只在你想要启用 workflow 时，才明确点名它\n\n对 Cursor 和 Claude Code 用户，请遵循同样的规则：\n\n1. 将 bundle 安装到项目中\n2. 保持正常的提问方式不变\n3. 只在你想要启用 workflow 时，才通过名称明确请求它\n\n## 文档\n\n- [中文 README](README.cn.md)\n- [记忆指南](MEMORY.md)\n- [中文记忆指南](MEMORY.cn.md)\n- [验证指南](VERIFY.md)\n- [中文验证指南](VERIFY.cn.md)\n- [源码 workflow 总览](team-skills/README.md)\n- [源码 workflow 安装说明](team-skills/INSTALL.md)\n","readmeFilename":"README.zh.md","_rev":"1-de921961feb52b0c50b602338e43c50a"}