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
177 Commits 34 Branches 46 Tags
8a2f37071a298e4fc4222546bc46df1b7a6b1373
Commit Graph

21 Commits

Author SHA1 Message Date
AI不止语
8a2f37071a feat(installer): 新增 Crush 适配（23 款工具，#40）；补齐 verify-release 覆盖盲区 
## Crush（#40）

查权威源（charmbracelet/crush repo 文档）确认：Crush 遵循 Agent Skills 开放标准，
项目级**自动发现** .crush/skills、.agents/skills、.claude/skills、.cursor/skills
四个目录，无需任何配置；用户级为 ~/.config/crush/skills。

重要副作用写进了 docs：已经为 CC / Cursor / Codex / Antigravity 装过的用户，
Crush 现在就已经能读到那些 skills，此时不要再装 --tool crush，否则同一批
skills 会有两份、被重复加载。docs 里给了确认命令。

- TARGETS 加 Crush（detect: .crush / crush.json / .crush.json），支持 --global
- CLI_PROBES 加 crush（它是 CLI，PATH 探得到）
- skills-only 适配，不需要 bootstrap；不动用户的 crush.json
- 新增 docs/README.crush.md
- 计数 22 -> 23（installer TARGETS 22 条 + Copilot CLI 单独计）

实测：装 20 skills / 二次装幂等 / 卸载零残留且正确保留用户的 crush.json；
--global 装到 ~/.config/crush/skills 并可干净卸载。

## audit Category 5 当场抓到我漏改的 5 处

加计数时忘了 site/build.mjs 的 5 个位置（三语言标语 + FAQ 枚举）。上个版本
新加的计数一致性检查直接 FAIL 拦下 —— 这是它第一次在真实改动中生效。已补
site 18 处并重建，三语言首页 23 计数、0 残留、Crush 均已出现。

## verify-release.sh 有同样的漂移问题，已修

它有自己独立的覆盖清单，加新工具时不进去就静默不测（本次 Crush 就是：
分数仍是 82，因为压根没测它）。

- SPEC / DETECT / GLOBAL_OK 三处补 Crush
- 顺带发现 B 段还漏了 3 个工具的检测标记：DeerFlow（deer_flow）、
  VS Code（.github/copilot-instructions.md）、Gemini CLI（GEMINI.md）——
  后两个是文件而非目录，DETECT 循环原先一律 mkdir，现按扩展名区分创建方式
- 新增 G 段自检：SPEC 覆盖数必须等于 installer 宣称的工具数；
  DETECT 覆盖的工具名集合必须包含全部 TARGETS 名字（用集合比对而非数条数 ——
  一个工具可以有多个检测标记，数数会误判）

覆盖从 82 项升到 90 项。

回归：audit.sh 152 pass / 0 warn / 0 fail、verify-release.sh 90 pass / 0 fail
 2026-08-08 06:14:48 +08:00
AI不止语
6cb1cd89bc feat(installer): 新增 Cline 与 Kilo Code 适配（22 款工具，#112、#88） 
两款都是 VS Code 扩展，加载的是「rules」而非懒加载的 skills —— rules 会
并入每一轮 system prompt。所以照搬「把 20 个 SKILL.md 复制进规则目录」会
让每轮对话背着几万字常驻开销（Cline 官方也提示规则超约 300 行后遵守度下降）。

改用仓库既有的 Trae 模式：规则目录里只放一份小索引（核心规则 + 20 个 skill
的名称/触发条件表），skills 本体放各自的 skills/ 目录由 agent 按需读取。

Cline（#112）
- skills -> .cline/skills/，索引 -> .clinerules/superpowers-zh.md
- 不写 YAML frontmatter：Cline 目前只支持 paths 一个条件字段，
  无 frontmatter 即始终生效，正是所需
- 索引保持在 .clinerules/ 根层单文件 —— 子目录是否递归扫描官方未说明

Kilo Code（#88）
- skills -> .kilocode/skills/，索引 -> .kilocode/rules/superpowers-zh.md
- 走 .kilocode/rules/ 而非 v7 推荐的 .kilo/rules/ + kilo.jsonc：后者需要把
  路径登记进用户的 kilo.jsonc，那是带注释的 JSONC，安装器安全合并容易改坏
  用户配置。官方明确 .kilocode/rules/ 向后兼容且零配置生效，故选它。
  docs 里写了想迁到 v7 方式该改哪一行，以及万一没生效怎么反馈。

接入点（全部为新增，未改动任何既有工具的条目）
- TARGETS 加 2 条，检测标记 .clinerules / [.kilocode,.kilo,kilo.jsonc] 均唯一
- installForTarget 分发、TOOL_ALIASES（cline/kilocode/kilo/kilo-code）
- BOOTSTRAP_DELETE 加两份索引路径，--uninstall 能清干净
- --global 明确拒绝并指向 docs：Cline 全局 rules 路径随 OS 变
  （~/Documents/Cline/Rules，Linux/WSL 还有 ~/Cline/Rules 回退），
  Kilo 全局需改 kilo.jsonc，都不是通用 --global 能可靠命中的
- audit.sh TOOLS 数组加 cline kilocode，纳入 install/幂等/卸载回归
- 新增 docs/README.cline.md、docs/README.kilocode.md
- 计数 20 -> 22：简繁 README、package.json、CLAUDE.md、3 份 plugin manifest
  （RELEASE-NOTES 里的历史计数是过往版本记录，不动）

实测
- 两款均通过 装 / 二次装幂等 / 卸载无残留
- 检测隔离：.clinerules 只触发 Cline、.kilocode|.kilo|kilo.jsonc 只触发
  Kilo Code；.claude/.cursor/.trae/.qoder/.codebuddy 检测结果与改动前一致；
  .claude + .clinerules 共存时两款并行安装正常
- audit.sh: 130 pass / 0 fail（2 项 warn 为既有上游漂移，见 #19）

路径依据：docs.cline.bot/customization/cline-rules、kilo.ai/docs/customize/custom-rules

两款合并为一个提交：共用同一套「rules 型工具」机制与同一批计数改动，
拆开会产生 21 款的中间状态，audit 无法在中间提交上自洽通过。
 2026-08-07 17:38:37 +08:00
AI不止语
01319b5b02 feat: 新增华为云码道 CodeArts 支持（skills-only，关 #20） (#99) 
华为云 CodeArts Doer 的 skills 目录为 .codeartsdoer/skills/（用户在 #20 确认）。
本次做 skills-only 适配：检测 .codeartsdoer/ 或 --tool codearts 安装，
靠 CodeArts 自身 skill 发现加载。其 bootstrap/指令文件约定未证实，
故不生成 bootstrap（docs 已说明，若不自动触发可手动点名 skill）。

- bin: TARGET（.codeartsdoer/skills，检测 .codeartsdoer）+ 别名
  （codearts/codeartsdoer/huawei）
- 工具数 19 → 20：README/站点/package/FAQ/stats 同步
- docs/README.codearts.md（含自动触发的诚实说明 + 求证请求）
- audit TOOLS 加 codearts

测试：audit 124 PASS/0 FAIL（含 codearts 装/幂等/卸载）、全局套件 50/50
回归、站点重建工具数 20。
 2026-07-13 21:56:11 +08:00
AI不止语
cd651cd1c6 feat: 新增 CodeBuddy（腾讯 AI IDE）工具支持（关 #18 #75） (#98) 
CodeBuddy 加载机制类似同类 IDE：项目根 CODEBUDDY.md 作 bootstrap，
skills 放 .codebuddy/skills/。仅项目级（用户级加载路径未证实，暂不做全局）。

- bin: 加 TARGET（检测 .codebuddy / CODEBUDDY.md）+ 别名（codebuddy/-cn/-code）
  + CODEBUDDY.md bootstrap 生成 + 卸载哨兵清理
- 工具数 18 → 19：README/站点/package.json/FAQ/stats 全量同步
- docs/README.codebuddy.md 中文使用文档；audit TOOLS 加 codebuddy
- 站点 FAQ 与工具列表补 CodeBuddy

测试：audit 122 PASS/0 FAIL（含 codebuddy 装/幂等/卸载）、全局套件 50/50
回归无破、站点重建 42 页工具数 19。
 2026-07-13 21:43:56 +08:00
AI不止语
a3349d47c6 Merge remote-tracking branch 'origin/main' into sync/v6-pi-harness 
# Conflicts:
#	README.md
 2026-06-20 07:24:48 +08:00
AI不止语
4909388f35 feat(pi): 新增 Pi (oh-my-pi) harness 支持（关 #44，对齐上游 v6.0.0） 
issue #44：Pi 像 opencode 一样开放，skill:// 能直接用，已验证可手动使用，
希望原生支持。上游 obra/superpowers 在 v6.0.0 已用扩展模型原生集成 Pi，
本提交把同样的集成方式落到本 fork。

Pi 走扩展模型，通过 package.json 的 pi 字段声明，直接指向仓库现有
skills/，不复制 skill、无运行时依赖。扩展内容中立——读取 fork 现有的
中文 using-superpowers/SKILL.md 自动注入，故扩展代码逐字节照搬上游。

- .pi/extensions/superpowers.ts：注册 resources_discover / session_start /
  session_compact / agent_end / context 生命周期钩子，在会话注入
  using-superpowers bootstrap + Pi 工具映射（带去重标记、插在 compaction
  summary 之后）
- package.json：加 pi.skills=["./skills"] + pi.extensions + pi-package
  keyword；.pi/extensions/ 加入 files（npm 发布需含扩展）
- skills/using-superpowers/references/pi-tools.md：Pi 工具映射参考
- docs/README.pi.md：中文安装/原理/工具映射/验证指南；README.md 工具列表加链接
- tests/pi/：上游扩展行为测试（适配 fork：name=superpowers-zh）+ 运行包装

验证：bash tests/pi/run-tests.sh 6/6 通过 exit 0（校验 pi 包配置、生命周期
钩子无 pre-compaction 注入、resources_discover 贡献 skills 目录、session_start
注入 You-have-superpowers + Pi-tool-mapping、pi-tools 参考存在）；package.json
合法；scripts/audit.sh 静态 0 FAIL；README→docs/README.pi.md 链接可解析。

注：扩展是 TS（仅 import type，运行时无类型依赖），Node 22.6–23.5 需
--experimental-strip-types（run-tests.sh 已带），23.6+ 默认支持。
Pi 内实际 skill 触发需在 Pi 内验证（与本 fork 其它 harness 同样限制）。
 2026-06-20 02:53:31 +08:00
AI不止语
af4c03c1e0 feat(kimi): 新增 Kimi Code harness 支持（对齐上游 v6.0.0 集成模型） 
issue #37：Kimi Code 已支持 Skills 能力，希望原生支持。上游 obra/superpowers
在 v6.0.0 已用插件清单模型原生集成 Kimi，本提交把同样的集成方式落到本 fork。

Kimi 走插件清单模型（与 CC plugin 同类），直接指向仓库现有 skills/，
不复制 skill、不建 symlink、不装 hook、无运行时依赖，因此无需改 npx
安装器（安装器面向需要复制 skills 的工具）。

- .kimi-plugin/plugin.json：fork 品牌清单，skills 指向 ./skills/，
  sessionStart.skill = using-superpowers（会话开始自动加载 bootstrap），
  skillInstructions 提供 Kimi 工具映射（AskUserQuestion/TodoList/Agent/
  Skill/Read/Write/Edit/Bash/Grep/Glob/FetchURL/WebSearch，保留上游权威
  英文映射以免破坏真实工具名）
- 版本同步：.version-bump.json 与 scripts/sync-plugin-version.js 双向接入
- docs/README.kimi.md：中文安装/工具映射/排错指南；README.md 工具列表加链接
- tests/kimi/：清单结构测试（适配 fork：name=superpowers-zh、校验版本同步条目）

验证：bash tests/kimi/run-tests.sh 通过；manifest 合法 JSON；版本同步双机制
均含 kimi 条目；scripts/audit.sh 静态校验 0 FAIL；README→docs/README.kimi.md
链接可解析。

注：Kimi 实际 skill 自动触发需在 Kimi Code 内验证（与本 fork 其它 harness
同样限制），清单结构已对齐上游 v6.0.0 经过验证的集成方式。
 2026-06-20 02:37:31 +08:00
Drolese
1d504ed756 fix(Antigravity): 修复Antigravity安装引导文件目录错误问题 (#51) 
参考官方文档https://antigravity.google/docs/skills，将引导目录从.antigravity修改为.agents
 2026-06-17 06:48:29 +08:00
AI不止语
1a388c6851 docs(trae): 修正手动安装路径 .trae/rules → .trae/skills 
安装器实际把各 skill 复制到 .trae/skills/，并在
.trae/rules/superpowers-zh.md 生成 bootstrap 规则。旧文档让用户把
skills 往 .trae/rules/ 拷，会误导。对齐安装器真实行为，并注明手动复制
不会生成自动触发规则。
 2026-06-02 20:51:04 +08:00
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不止语
7bc9acde14 docs(openclaw): 移除 stale slash command 引用，改自然语言触发 (#25) 
OpenClaw 安装指南的"使用"段写"输入 /brainstorming 开始头脑风暴"和
"输入 /commit 使用中文提交规范"——这两条都是过时引用：

- `/brainstorming` 不是有效 slash command（commands/ 目录在 v5.1.0 已删，
  且我们的 commands/ 里也从来没有 brainstorming 这个名字）
- `/commit` 完全不存在（我们没有 commit 这个 skill；可能想表达
  chinese-commit-conventions，但 slash command 形式也不存在）
- 即便 commands/ 还在的年代，OpenClaw 也不一定把 skill 自动暴露为
  slash command

改写为 OpenClaw 实际生效的触发方式：AI 通过 skill frontmatter 的
description 字段自主选择 skill。文档同时给出 4 个高频触发场景示例，
并说明强制触发的方式（在指令里点名 skill）。
 2026-05-11 21:40:38 +08:00
AI不止语
174817f762 docs: README + Trae 指南补 --uninstall / --force 文档 
v1.2.1 加了主目录守护和 --uninstall 子命令，但 README/docs 里完全没提，
新功能等于"被发布但没人知道"。

- README 在「方式一」加主目录警告 link，安装方式之后加完整的
  「卸载 / 误装清理」小节（含哨兵机制的数据安全说明 + 全参数表）
- docs/README.trae.md（issue #17 是 trae 用户）末尾加同样的清理段
 2026-05-05 23:06:53 +08:00
jiangnan
c86b269718 docs: README 新增 Copilot CLI / Hermes Agent 支持说明，工具数更新为 16 
- 标题、工具表格、手动安装、配置文件、页脚等 9 处 14→16
- 工具表格新增 Copilot CLI 和 Hermes Agent 两行
- 新增 docs/README.hermes.md 详细安装指南
- 详细安装指南链接列表补充 Hermes Agent
 2026-04-13 22:21:58 +08:00
jiangnan
9619238a14 docs: enhance demo animation with realistic install and brainstorming flow 2026-03-27 16:27:58 +08:00
jiangnan
0efc964b3b docs: update star count to 116k, add before/after comparison to README 2026-03-27 10:19:31 +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
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