lywsvip/superpowers-zh
1
0
Fork 0
mirror of https://github.com/jnMetaCode/superpowers-zh.git synced 2026-09-02 22:54:06 +08:00
Code Issues Packages Projects Releases Wiki Activity
206 Commits 34 Branches 46 Tags
main
Commit Graph

206 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
AI不止语
6c1fe583e8 chore: release v1.3.0 — 跟上游 v5.1.0 对齐 + 修 marketplace.json drift v1.3.0 2026-05-10 22:57:13 +08:00
AI不止语
acff43a04c docs: 补 RELEASE-NOTES.zh.md v1.3.0 段 — #23 marketplace.json drift 修复 2026-05-10 22:56:50 +08:00
AI不止语
48c4d0d417 fix(scripts): sync-plugin-version 支持嵌套字段路径 (#23) 
补上之前简化版未实现的 plugins.0.version 路径，把
.claude-plugin/marketplace.json 纳入版本同步目标。

修复 marketplace.json 卡在 1.1.8 的老漂移（自 v1.1.8 起没动过）：
plugins[0].version 1.1.8 -> 1.2.1（追上其他 4 个 manifest）。

实现：
- TARGETS 改为对象数组 { path, field }，对齐上游 .version-bump.json 格式
- field='version' 走顶层 regex（保留原行为）
- field='plugins.0.version' 走嵌套 regex（锚定到 plugins 数组首项）
- 都用 regex 替换而非 JSON.stringify，保持原文件格式（缩进/数组写法等）

测试：
- 升级场景 1.2.1 → 1.3.0：4 个 manifest 全部同步
- 幂等性：版本相同时输出 "already at"
- 边界：marketplace.json 其他字段完全未动（diff 仅 version 一行）
- npm pack：90 文件 228KB 不变
 2026-05-10 22:48:09 +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不止语
392ff753cd fix(skills): 4 个 chinese-* 改为手动调用，避免污染上游 skill 自动调度 
旧 description 是"中文 X 规范——卖点描述"句式，既不符合 skill auto-trigger
约定（应当以"在 X 时使用"开头），又会在修对之后过度触发污染上下文。这 4 个
本质是参考资料而非工作流，锁成手动调用更合适。

- 4 个 SKILL.md frontmatter description 改为"内容描述 + 显式 /xxx 调用"
  句式，末尾加硬指令"不要根据上下文自动触发"
- GEMINI.md 列表同步更新（bin/superpowers-zh.js 的 scanSkillEntries 从
  SKILL.md 读，新装用户已经能拿到新版；这份是仓库自带的快照，需手动追平）
- README 中国特色 Skills 段加警示框 + 「调用方式」列，标明前 4 个为手动
- 不影响上游 18 个 skill 的自动触发原貌
 2026-05-09 00:06:52 +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
AI不止语
bb9dc4950e chore: plugin manifest 版本号自动跟 package.json 同步 
之前 .claude-plugin/plugin.json 和 .cursor-plugin/plugin.json 的 version
字段一直停在 1.1.8，落后于 npm 1.1.9 / 1.2.0 / 1.2.1——每次发版都要手改。

- 新增 scripts/sync-plugin-version.js：用正则替换 version 字段一行，
  保留两个 manifest 的原排版（数组单行/多行、缩进等），无 diff 噪音
- 在 package.json 挂 npm version 钩子：bump 后自动同步并 git add 到
  version commit 里，从此不会再漏
- 把当前两个 manifest 从 1.1.8 一次性修到 1.2.1
 2026-05-05 19:32:20 +08:00
AI不止语
f324429cce chore: release v1.2.1 — fix uninstall data-loss edge case v1.2.1 2026-05-05 18:24:57 +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不止语
32230c596e chore: release v1.2.0 — --uninstall + home guard + 计数修复 v1.2.0 2026-05-05 18:07:41 +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
v1.1.9 		2026-04-28 11:11:44 +08:00
jiangnan
81f746a5c2 chore(deps): bump Node engine 要求 >=14 → >=20（Node 14/16/18 均已 EOL） 
NLPM 审计建议 >=18，但 2026-04-28 当下 Node 18 已于 2025-04 EOL，
20 是当前刚进入 maintenance 的 LTS（22/24 为 active），一次到位避免反复 bump。

bin/superpowers-zh.js 仅用 ESM + 标准 fs/path/url，对运行版本无新增要求；
此改动为声明式安全护栏，阻止安装到已知有 CVE 的 EOL 运行时。

Closes #13 (security item only). Refs #12.
 2026-04-28 10:43:39 +08:00
jiangnan
2d538d2e1e docs: 为高 star 姊妹项目补上 star badge（superpowers-zh 1k+） 2026-04-19 20:02:31 +08:00
jiangnan
802a250d8f docs: 相关项目表情绪钩子回补（几分钟出方案 / 即插即用 / 零依赖） 2026-04-19 19:50:22 +08:00
jiangnan
b71a319233 docs: 相关项目表描述统一为'中等密度+视觉平衡'版 2026-04-19 19:11:46 +08:00
jiangnan
e9e3c1a9ee docs: QQ 群标识改为 QQ 2群 2026-04-19 17:47:58 +08:00
jiangnan
c2ea321c8a docs: 姊妹项目表只保留 agency-agents-zh 的 star badge (6.9k 社会证明) 2026-04-19 17:41:52 +08:00
jiangnan
dcc106cc5f docs: 重构姊妹项目区块为独立"相关项目生态"章节，重点推广 orchestrator 
- 新增顶级章节 "## 🌟 相关项目生态"，从埋在致谢里提升为独立区块
- 项目表格含 star badge（shield.io 动态拉取，不过期）+ 定位图标 + 一句话卖点
- 过期数据修正：agency-agents-zh / orchestrator 的 "187 个" → **211 个**
- agency-orchestrator 单独 featured 块（🔥 重点推荐）：
  * 场景对比（1 小时 vs 几分钟）
  * 4 个卖点（211 专家 / 零代码 YAML / 9 家 LLM 6 家免费 / 与 superpowers-zh 互补）
  * 明确 CTA "立即体验" 跳转
- shellward / ai-coding-guide 描述精简，agency-agents-zh 补上 46 中国原创亮点
 2026-04-19 17:37:22 +08:00
jiangnan
e30d6445a9 docs: README 新增详细对比上游表，挪到显眼位置 
- 新增"🆚 与英文上游的区别"表（16 行维度），放到"这是什么？"之下最显眼处
- 补齐差异点：支持工具（6 vs 17）、安装方式、CI/CD 平台、PR 接受策略、社区等
- 顺手修正上游 star 数据 116k → 159k+
- 删除旧的 8 行"对比上游"表，避免重复
 2026-04-19 17:17:12 +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
v1.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
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
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
63d634df19 docs: 交流 section 加回 QQ 群入口 2026-04-01 21:25:32 +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
dd39945d5d docs: 社区交流改为微信公众号入口 2026-04-01 14:12:17 +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
9ce7f726fb chore: bump version to 1.1.3 2026-03-30 11:20:40 +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
04d1a6fdf8 chore: bump version to 1.1.2 2026-03-30 11:06:36 +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
4a55cbf9f3 同步上游 v5.0.6：用内联自检替代子代理审查循环 
- brainstorming: 规格审查循环 → 规格自检（4 项内联检查清单）
- writing-plans: 计划审查循环 → 自检（3 项检查清单）+ 新增"禁止占位符"章节
- writing-skills: 修正 frontmatter 描述，添加 agentskills.io 规范链接
 2026-03-27 22:00:59 +08:00
jiangnan
00b1e8b7d7 社区交流群添加群号 2026-03-27 21:51:00 +08:00
jiangnan
c4b0407c2e 社区交流群改为2群 2026-03-27 21:45:05 +08:00
jiangnan
baaa442a96 姊妹项目：8 款 → 9 款（新增 OpenClaw） 2026-03-27 20:20:07 +08:00
jiangnan
451aea118f 统一姊妹项目描述 2026-03-27 18:30:43 +08:00
jiangnan
5e41251822 添加 ai-coding-guide 交叉链接 2026-03-27 17:03:19 +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
7628e03ece docs: update branding -- OpenClaw first, 6 Chinese skills, 14 tools 
- Unify all descriptions: GitHub repo, package.json, plugin configs
- Put OpenClaw first in all tool listings (high demand from community)
- Fix skills count: 5 -> 6 Chinese-original (was missing workflow-runner)
- Fix version: 1.0.0 -> 1.1.1 in claude-plugin and cursor-plugin configs
- Reorder tool support table by popularity
- Update README tagline to match GitHub repo description
 2026-03-26 22:55:38 +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
03baa7805d docs: expand ecosystem links — add agency-orchestrator + shellward 2026-03-24 13:32:40 +08:00
jnMetaCode
6471c855ee fix: CI should validate SKILL.md instead of arbitrary .md files (#2) 
The validation step used `find ... -name '*.md' | head -1` to pick the
first .md file in each skill directory. On Linux (GitHub Actions), `find`
returns files in inode order — not alphabetical — so auxiliary files like
CREATION-LOG.md or code-quality-reviewer-prompt.md could be picked
instead of SKILL.md. These auxiliary files have no frontmatter, causing
4 false-positive validation errors on every CI run.

Fix: directly target SKILL.md (the canonical skill definition file) and
error if it's missing rather than silently skipping.
 2026-03-24 07:58:33 +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
62f7ac38cc ci: 新增 GitHub Actions CI — 校验 skills 和 agents 结构 
- 校验所有 skill 文件的 frontmatter（name, description 必填）
- 校验 agent 文件格式
- 检查 package.json 完整性
 2026-03-22 03:16:00 +08:00
jiangnan
73fc468f3a 同步上游 v5.0.5 审查循环优化和执行交接变更 
- 确认 6 个核心技能文件已与上游对齐（审查迭代上限 3 次、整体计划审查、执行交接用户选择）
- 新增 CODE_OF_CONDUCT.md 中文版（贡献者公约 v2.0）
- 版本号升至 1.1.1
 2026-03-21 00:52:00 +08:00