lywsvip/superpowers-zh
1
0
Fork 0
mirror of https://github.com/jnMetaCode/superpowers-zh.git synced 2026-09-03 07:23:56 +08:00
Code Issues Packages Projects Releases Wiki Activity
71 Commits 34 Branches 46 Tags
a65c3ed0dcac8b9e18f189ee93f23e33ca344d40
Commit Graph

21 Commits

Author SHA1 Message Date
AI不止语
725977b422 feat: 加 Qoder 适配（第 18 款工具）— skills + always_on bootstrap rule 
closes #26, closes #34

## 改动

- bin/superpowers-zh.js: TARGETS 加 Qoder (`.qoder/skills`, detect `.qoder`)，
  TOOL_ALIASES 加 `qoder`，新增 `generateQoderBootstrap()` 生成
  `.qoder/rules/superpowers-zh.md`（`trigger: always_on` + `alwaysApply: true`）
- scripts/audit.sh: TOOLS 加 qoder，17→18
- 3 个 plugin manifest（.claude-plugin/{plugin,marketplace}.json、.cursor-plugin/plugin.json）
  description 同步到 18 款
- README、CLAUDE.md、package.json 文案对齐 18
- docs/README.qoder.md: 新增完整安装/使用/卸载指南，附 schema 说明

## 设计要点

Qoder Rules 的 frontmatter schema（`trigger: always_on` / `model_decision` /
`manual`）官方 docs.qoder.com/zh/user-guide/rules 未公开，来自 GitHub 上
4 份真实社区样本（python-office、termiClaude、QoderTest、TelegramFileServer）
的交叉验证。

按 Trae 模式生成 always_on bootstrap 而非 Cursor/Windsurf 的"裸 skill"模式，
是为了确保核心规则（先 brainstorming / 先 TDD / 先验证）在每个会话都自动加载，
不依赖模型对 description 文本的隐式匹配。

## 验证

- 端到端：--tool qoder 装、自动检测、二次幂等、卸载（20 skills + 1 bootstrap
  全部清掉，0 残留）
- bootstrap 文件 skill 列表（20）与实际 skills/ 目录数（20）一致
- 全量 audit: 96 PASS / 0 FAIL（18 款工具完整 install + 幂等 + uninstall 跑通）
 2026-05-21 00:56:18 +08:00
AI不止语
a9e02b501e chore: 跟上游 v5.1.0 对齐 (#22) 
补齐上游漏的根级文件：CLAUDE.md（翻译 + 中文 fork 备注）、
AGENTS.md（symlink → CLAUDE.md，跟上游 mode 120000 一致）、
RELEASE-NOTES.md（上游英文原样 1180 行）、RELEASE-NOTES.zh.md
（新建中文 fork 自身 release log）、.codex-plugin/plugin.json
（中文化）、.version-bump.json、scripts/bump-version.sh、
assets/{app-icon.png,superpowers-small.svg}、4 个上游新增测试。

跟上游意图对齐，删上游已废弃流程：
- commands/ 全 3 个 deprecated stub（上游 #1188）
- agents/code-reviewer.md（已上升进 requesting-code-review skill，
  上游 PR #1299）
- bin/superpowers-zh.js 删 install agents 逻辑，保留 uninstall 用
  hardcoded LEGACY_AGENT_FILENAMES 列表清理已装用户残留
- .github/workflows/ci.yml 删 "Validate agents" 段
- package.json files 字段移除 agents/ commands/

主动修上游 v5.1.0 疏忽：
- .cursor-plugin/plugin.json 删 dangling 的 "agents": "./agents/"
  和 "commands": "./commands/"。上游删目录但忘同步 manifest
  （git blame 显示自 2026-02-13 起从未更新）。

配套：
- scripts/sync-plugin-version.js 扩到 .codex-plugin/plugin.json
- npm pack 校验 90 文件 228KB，agents/commands 残留 0 条

中文版"手动新增"叠加层全部保留：bin/ + npx 流程、docs/、
chinese-* skill、mcp-builder、workflow-runner、README 主推 npx、
各 INSTALL.md、.gemini/、sync-plugin-version.js。

详见 RELEASE-NOTES.zh.md v1.3.0 段。
 2026-05-10 22:27:52 +08:00
AI不止语
36187d388e fix: 哨兵注释 + 保守 fallback，杜绝 --uninstall 数据丢失 
v1.2.0 的 cleanBootstrapSection 用 indexOf('\n# ') 找段尾，当 superpowers
段在文件开头、后面只有 ## 二级标题时，会错误地把段尾扩展到文件末尾，
导致用户在 superpowers 段之后写的二级标题内容被一并删除。

修复：
- 安装时给 4 处追加型 bootstrap（CLAUDE.md / GEMINI.md / HERMES.md /
  CONVENTIONS.md）的内容用 <!-- superpowers-zh:begin/end --> 哨兵包裹
- 卸载优先按哨兵精确切除；找不到时 fallback 到标题 marker；
  再不行用末尾固定句子兜底；都不行就跳过 + 警告，绝不删用户数据
- isHomeDir 在 homedir() 返回空字符串时返回 false（避免误判 cwd 是 home）
 2026-05-05 18:24:57 +08:00
AI不止语
85fd3aeda2 fix: 加 --uninstall 子命令、home 目录守护、计数显示修复（#17） 
- 修复在 ~ 直接安装会污染主目录的问题：默认拒绝，需 --force
- 新增 npx superpowers-zh --uninstall：清理 skills、bootstrap 文件，
  保留用户在 CLAUDE.md/HERMES.md 中的原有内容
- 修复多工具检测时计数叠加显示（21/23/101 → 全部按源数 20 显示）
- copyDirSync 跳过 .DS_Store，停止散播 macOS 元数据
 2026-05-05 18:01:43 +08:00
jnMetaCode
8298e9f865 fix: npx 安装 CC 目标时补上 CLAUDE.md bootstrap（skill 不触发根因） (#14) 
之前 installForTarget 对 Trae/Gemini/Aider/Antigravity/Hermes 都会自动生成
bootstrap 规则（写到各自的 rules 文件），让模型知道"任何任务前先查 skill"。
唯独 .claude/ 分支只复制 skills 和 agents，不写 CLAUDE.md 引导。

结果：用户 npx superpowers-zh 装到 .claude/ 后，skill 文件都在，但模型
完全没被告知要主动用——提"加个导出功能"直接写代码，不会走 brainstorming
→ writing-plans 的方法论流程。手动 /brainstorming 能触发，自动不触发。

本次改动：
- 新增 generateClaudeCodeBootstrap()，对齐 Gemini/Aider 的追加/创建逻辑
- installForTarget 的 .claude/ 分支调用它
- 默认回退分支（未检测到任何工具）也调用它
- 幂等：已包含 superpowers-zh 引用则跳过
- 已有 CLAUDE.md 则追加，保留用户原内容

本地验证四个场景：空项目 / 已有 CLAUDE.md / 二次装 / --tool claude，全部通过。

version bump: 1.1.8 -> 1.1.9
 2026-04-28 11:11:44 +08:00
jiangnan
4778006422 feat: 添加 Claw Code 支持（第 17 款工具）+ CNB 平台支持 
- 新增 Claw Code（Rust 版 AI CLI）：auto-detect `.claw/` 或 `CLAW.md`，支持 `--tool claw/claw-code/clawcode`
- chinese-git-workflow skill 新增 CNB（腾讯云原生构建）平台适配，含 `.cnb.yml` CI 示例（#6）
- 版本 1.1.7 → 1.1.8
 2026-04-19 16:04:29 +08:00
jiangnan
fb08e884dc fix: Windows 下 cpSync 复制 skills 失败导致目标目录为空（#5） 
- 弃用 cpSync 改用手动递归 + realpathSync，规避 npx 缓存 junction
  和 Node 16.7-18 cpSync 实验性 API 在 Windows 上的不稳定行为
- 复制后做计数校验：源 >0 而目标 =0 时报错并给出排查建议
- bump 1.1.6 → 1.1.7
 2026-04-16 08:27:53 +08:00
jiangnan
d89daf9fc2 feat: 添加 Hermes Agent 支持（第 16 款工具） 
- 安装器新增 Hermes Agent 目标（.hermes/skills/）和别名（hermes/hermes-agent）
- 安装时自动生成 HERMES.md bootstrap（含工具映射和 skills 列表）
- 新增 references/hermes-tools.md 工具映射表（中文化）
- using-superpowers 技能新增 Hermes Agent 平台说明（skill_view 三级渐进式加载）
- 各处 description 加入 Hermes Agent 名称，工具数量更新为 16 款
- package.json 添加 hermes/hermes-agent 关键词
 2026-04-13 20:16:00 +08:00
jiangnan
fc9a2a40ca 同步上游 v5.0.7：Copilot CLI 支持、OpenCode bootstrap 改进、版本统一 
上游同步：
- hooks/session-start: 新增 Copilot CLI 平台检测（COPILOT_CLI 环境变量）
- .opencode/plugins/superpowers.js: bootstrap 从 system prompt 改为 user message 注入，避免 token 膨胀和 Qwen 兼容问题
- skills/using-superpowers: 新增 Copilot CLI 使用说明和工具映射引用
- 新增 references/copilot-tools.md（中文化）

本地优化：
- 清理 OpenCode 插件死代码（normalizePath/os/configDir）
- 统一版本号为 1.1.6（修复插件 JSON 与 package.json 不一致）
- .gitignore 排除安装器生成的 skills 副本
- package.json files 数组精简，避免打包重复的 skills 副本
- 安装器新增 copilot/copilot-cli 别名
- 工具数量更新为 15 款
 2026-04-13 19:55:20 +08:00
jiangnan
72db65ad1c fix: bootstrap rules 不再混入第三方 skills（如 OpenSpec） 
scanSkillEntries 改为扫描源目录 SKILLS_SRC，而非安装目标目录，
避免用户已有的其他工具 skills 被误列进生成的 rules 文件。
 2026-04-06 14:11:22 +08:00
jiangnan
b38edc010c feat: 添加 --tool 参数支持手动指定工具，改进检测失败提示 
Cursor 等工具如果项目里没有配置目录，自动检测会失败。

新增：
- --tool cursor / --tool trae 等参数跳过检测直接安装
- 支持 19 个别名（cursor, claude-code, trae, windsurf 等）
- 检测不到工具时提示用户使用 --tool 而非静默回退
- 重构 installForTarget() 消除重复代码
 2026-04-01 14:46:22 +08:00
jiangnan
550853fd8e fix: 兼容低版本 Node.js（>=14），解决 cpSync 不可用问题 
Windows 用户报告 SyntaxError: 'fs' does not provide an export named 'cpSync'。
根因：cpSync 是 Node 16.7+ API，低版本不支持。

修复：
- 新增 copyDirSync() 兼容函数，优先用 cpSync，不可用时手动递归复制
- 添加 engines 字段声明最低 Node 14+ 要求
 2026-03-31 14:11:03 +08:00
jiangnan
67a4365819 fix: Antigravity/Aider/Gemini CLI 安装后自动生成引导文件 
与 Trae 同类问题：skills 复制到目录后工具无法自动发现。

- Antigravity: 生成 .antigravity/rules.md
- Aider: 生成 CONVENTIONS.md（已有则追加，幂等安全）
- Gemini CLI: 追加到 GEMINI.md（已有则追加，幂等安全）
- 重构 scanSkillEntries() 为公共函数，4 款工具共用
 2026-03-30 11:20:28 +08:00
jiangnan
c4123e821b fix(trae): 安装 skills 到正确目录并自动生成 bootstrap rule 
Trae 用户反馈安装后 skills 无法自动激活。根因：skills 被安装到
.trae/rules/ 而非 .trae/skills/，且缺少 alwaysApply 引导规则。

修复：
- skills 安装到 .trae/skills/（正确目录）
- 自动生成 .trae/rules/superpowers-zh.md（alwaysApply: true）
- bootstrap rule 包含所有 skills 的名称和触发条件
 2026-03-30 11:02:26 +08:00
jiangnan
c2ab9e653b feat: add Windsurf, Gemini CLI, Aider, OpenCode, Qwen Code support — 14 tools total 
- Add 5 new tool targets to installer (bin/superpowers-zh.js)
- Gemini CLI detects GEMINI.md to avoid conflict with Antigravity
- Aider detects .aider/ directory for broader compatibility
- Add installation docs for Windsurf, Gemini CLI, Aider, Qwen Code
- Update README with full 14-tool support table and usage guide
- Fix skills count: 20 (14 translated + 6 Chinese-original incl. workflow-runner)
- Fix OpenClaw doc linking to wrong upstream repo
- Align gemini-extension.json name/version with package.json
- Add docs/ to package.json files array for npm installs
- Add install script validation step to CI
 2026-03-26 22:33:15 +08:00
jiangnan
fd145dc641 feat: add OpenClaw support 
- Add OpenClaw target in installer (detect .openclaw/, install to skills/)
- Add OpenClaw to README supported tools list, manual install, config table
- Add docs/README.openclaw.md installation guide
- Add openclaw keyword to package.json
 2026-03-26 21:07:04 +08:00
jiangnan
6046c4c334 feat: add DeerFlow 2.0 support + workflow-runner skill 
- Install script detects deer_flow/ and copies skills to skills/custom/
- Add DeerFlow to README tool list and install instructions
- Add docs/README.deerflow.md install guide
- Add deerflow keyword to package.json
- Include workflow-runner skill (20 skills total)
 2026-03-24 07:44:50 +08:00
jiangnan
74a9b7c1f0 修复安装脚本：fallback 补装 agents、错误处理、参数校验 
- fallback 安装现在也会安装 agents 到 .claude/agents/
- install 函数添加 try-catch 和 SKILLS_SRC 存在性检查
- 未知 CLI 参数显示警告并输出帮助
- 帮助文本补充 agents 相关说明
 2026-03-21 00:17:52 +08:00
jiangnan
6fa291f09c 修复安装脚本：精确检测工具目录，防止误安装 
- VS Code 检测改为 .github/copilot-instructions.md（避免误判普通 .github 目录）
- VS Code skills 安装到 .github/superpowers/（不污染 .github 根目录）
- Antigravity skills 安装到 .antigravity/skills/
- 移除 installed===0 的首个工具强制安装逻辑
- 6 个场景测试全部通过
 2026-03-20 19:35:35 +08:00
jiangnan
6d95ed50b0 v1.1.0: 新增 Kiro/Trae/Antigravity/VS Code 支持 
- 安装脚本自动检测 7 种 AI 编程工具
- 新增 4 个工具安装指南（Kiro/Trae/Antigravity/VS Code）
- README 更新支持工具列表和安装方式
- package.json 版本升级至 1.1.0
 2026-03-20 19:31:56 +08:00
jiangnan
80bc100625 superpowers 中文社区版：14 个翻译 + 5 个中国特色原创 skills 
基于 obra/superpowers (MIT) 完整汉化，新增中国开发者专属 skills：
- 中文代码审查：适配国内团队沟通文化
- 中文 Git 工作流：支持 Gitee/Coding/极狐 GitLab
- 中文技术文档：中英混排规范、排版标准
- 中文提交规范：Conventional Commits 中文适配 + commitlint 配置
- MCP 服务器构建：生产级 MCP 工具开发方法论

支持工具：CC / Cursor / Codex CLI / Gemini
安装：npx superpowers-zh
 2026-03-20 11:32:25 +08:00