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
80 Commits 34 Branches 46 Tags
af4c03c1e059f7eb552df7c7b3e15a752964a0fd
Commit Graph

80 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
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
AI不止语
dc3be50f83 docs: 相关项目生态新增 codepet（码宠 桌面养成桌宠），项目数更正为八个 2026-06-18 04:50:50 +08:00
AI不止语
83083ba324 docs(readme): 修复 Antigravity 安装指南死链 (#51 跟进) 
#51 把 README 链接改成 docs/README.agents.md，但实际文档文件仍是
docs/README.antigravity.md（PR 只就地改了内容、未改文件名），导致 404。
将链接指回真实文件名。bin 与文档内容已统一为 .agents/skills（经官方文档核实）。
 2026-06-17 06:49:49 +08:00
Drolese
1d504ed756 fix(Antigravity): 修复Antigravity安装引导文件目录错误问题 (#51) 
参考官方文档https://antigravity.google/docs/skills，将引导目录从.antigravity修改为.agents
 2026-06-17 06:48:29 +08:00
blueQ
952fc29a39 fix: add version, license, and metadata.hermes.tags to all 20 skills (#49) 
Hermes Agent convention requires SKILL.md frontmatter to include
version, license, and metadata.hermes.tags (see skill-authoring.md).
All 20 skills in this repo were missing these fields.

This fix adds:
- version (1.0.0)
- license (MIT)
- metadata.hermes.tags (auto-generated per skill)

Audited by: Hermes Skill Auditor (30 rules x 100 points)
Before: avg 60/100 (C grade) -> After: avg 70/100 (B grade)

Co-authored-by: shunfeng8421 <shunfeng8421@users.noreply.github.com>
 2026-06-17 06:45:05 +08:00
AI不止语
76019ce9d6 fix(install): 检测落空时不再静默兜底安装 (#33) (#43) 
零参数 npx superpowers-zh 自动检测不到任何工具目录时，原本会静默兜底
安装到 .claude/skills/。但 Antigravity / Trae 等工具不一定在项目里留下
检测目录（如 .antigravity/），这些工具的用户因此被误装成默认目标，且因
文件实际落在 .claude/ 而非预期目录，卸载时显示成功但文件依旧存在。

改为：检测落空时明确报错并列出 --tool 用法后退出，不做任何安装。
带 .claude/ 目录的项目仍会被自动检测命中，裸命令安装行为不变。

修复 #33。
 2026-06-17 06:45:00 +08:00
AI不止语
26d157fc08 docs: 相关项目生态新增 local-agent-toolkit；本仓库 skills 支持 skillet 一键安装 2026-06-13 07:20:03 +08:00
AI不止语
75aea1834c Merge: 新增赞助商版块 5Cookie Code + 效果对比表移位 2026-06-13 06:12:39 +08:00
AI不止语
6bff7ec29c docs(readme): 效果对比表移到「这是什么？」章节下 2026-06-13 06:11:46 +08:00
AI不止语
a65c3ed0dc docs(readme): 新增赞助商版块 — 5Cookie Code 
在「这是什么？」上方新增「❤️ 赞助商」版块，首位赞助商
5Cookie Code（logo + 描述 + aff 链接），标题旁附招赞助语。
 2026-06-13 06:09:58 +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不止语
d5d64cd267 chore: 补 .gitignore 漏配 + 修 repository.url 格式 
- .gitignore: 加 .qoder/ 和 .trae/（这两个工具走 bootstrap 模式，
  会在仓库根目录写 <tool>/rules/superpowers-zh.md + <tool>/skills/，
  之前漏配导致本地装一次就有 21 个 untracked 项）
- package.json: repository.url 加 git+ 前缀，消掉 npm publish 的
  auto-correct warning（npm 端 v1.5.0 已被自动 corrected 入库，
  此修复仅影响本地 manifest，不需要发 patch）
 2026-05-24 17:32:47 +08:00
AI不止语
3202b18e43 chore: release v1.5.0 — Qoder 适配 + qoder-tools.md ref 
- package.json + 5 个 plugin manifest: 1.4.0 → 1.5.0
- RELEASE-NOTES.zh.md: 新增 v1.5.0 段，描述 Qoder 适配、Rules schema
  来源说明、设计取舍
- skills/using-superpowers/references/qoder-tools.md: 新增工具映射 ref
  （Qoder 大部分工具同名 CC，仅 EnterPlanMode → EnterSpecMode 差异；
  附 Task agent 类型表 + Quest MCP 工具清单）
- skills/using-superpowers/SKILL.md 第 42 行: 平台适配段加 Qoder ref 引用

发版前验证：
- 6 处版本号全部 1.5.0
- 18 款工具 install + 二次幂等 + uninstall 全跑通
- bootstrap 工具（Qoder + Trae）rule 文件内容正确写入与卸载清理
- audit 96 PASS / 0 FAIL
- npm pack --dry-run 确认 docs/README.qoder.md + qoder-tools.md 入包
v1.5.0 		2026-05-21 05:56:56 +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不止语
2399664f11 docs: 在姊妹项目表加 ai-shortfilm-prompts 
新仓库：https://github.com/jnMetaCode/ai-shortfilm-prompts
内容：Mx-Shell《丧尸清道夫》5 段式视频提示词方法论
适用：Seedance / 小云雀 / Sora / 可灵 / 即梦等模型
 2026-05-19 00:40:30 +08:00
AI不止语
4e79a147b0 docs: add cross-link banner to AI 编程实战三卷书 2026-05-15 00:09:00 +08:00
AI不止语
9a8d4e471e docs(meta): 修 "6 中国原创" 文案漂移，准确反映 14+4+2 拆分 (#27) 
* docs(meta): 修 "6 中国原创" 文案漂移，准确反映 14+4+2 拆分

5 处描述把 skill 数量写成 "14 翻译 + 6 中国原创"，但实际只有 4 个 chinese-*
（chinese-code-review / chinese-commit-conventions / chinese-documentation /
chinese-git-workflow）是中国原创；另外 2 个（mcp-builder / workflow-runner）
是上游 v5.0+ 已删除但本 fork 保留的 skill，不是中国原创。

- 结构化描述（3 个 plugin/marketplace JSON）：拆为 "14 翻译 + 4 中国原创 + 2 上游历史保留"
- 散文（README + package.json）：改 "完整汉化 + 4 个中国原创 skills"
  （mcp-builder/workflow-runner 实质上是汉化版，归入"完整汉化"语义）

数学：14 + 4 + 2 = 20，与 .codex-plugin/plugin.json 已有的 "4 个中文 skills 沉淀" 对齐。

* docs(readme): 补漏 L61 "6 国产原创" 同性质漂移

跟前一 commit 同性质——"国产原创" 语义明确指 chinese-original，
mcp-builder/workflow-runner 是上游翻译版不是国产原创。

剩余 L44/46/L122/L133/L134 用的是 "中国特色"（china-specific）
框架，可以包含 fork-specific 历史保留，留给跟进 PR 单独处理。
 2026-05-12 18:36:07 +08:00
AI不止语
c5b4fa446b chore: release v1.4.0 — 上游漂移 P0 全量修复 + 防回归基建 (#32) 
跟 PR #28 + #30 + #31 一起构成 v1.4.0 的完整内容。本 PR 仅做发布层
（版本号 bump + plugin manifest 同步 + release notes），不动 skill 内容。

版本号 1.3.0 → 1.4.0：
- package.json
- .claude-plugin/plugin.json + marketplace.json
- .cursor-plugin/plugin.json
- .codex-plugin/plugin.json
- gemini-extension.json（之前卡在 1.1.6，本次顺带追上）

工具链小修：
- scripts/sync-plugin-version.js TARGETS 加入 gemini-extension.json
  （之前漏掉，是 gemini-extension.json 长期卡在老版本的根因）
- package.json 的 version 钩子 git add 列表加上 gemini-extension.json

RELEASE-NOTES.zh.md 新增 v1.4.0 段，按"上游同步"性质分组列出 9 项
修复内容，明确标注每项的上游 ref + 本 fork PR 号。

注意：本 PR 应在 #28 + #30 + #31 merge 之后才 merge —— 顺序错了
会导致 release notes 描述的 PR 在 git log 里还没有。

不影响：
- 上游 marketplace 安装路径（仍按主站路径正常工作）
- 现有 npm 用户向后兼容（npx superpowers-zh 仍可用）
v1.4.0 		2026-05-12 18:14:02 +08:00
AI不止语
98ce004193 chore(ci): 加 audit 脚本 + workflow 自动检测上游漂移 (#31) 
防回归基建：把本轮全量质量审计的 4 类检查打包成可重复运行的脚本，
每次 PR 自动跑，发现漂移立刻拦下。

scripts/audit.sh：
1. 静态校验：JSON parse、SKILL.md frontmatter、symlink、hook 可执行性
2. Installer 功能：17 款工具装 / 重装（幂等）/ 卸载全跑一遍
3. 上游对齐：hooks 4 文件 + brainstorm scripts 3 文件 + 14 翻译 skill
   结构层级（H1-H4 标题数）+ code-reviewer.md self-contained 版结构
4. 交叉引用：README → docs/ 链接、skill 间 superpowers:xxx 引用、
   装完后 .claude/skills/using-superpowers/SKILL.md 路径解析

支持 --quick（跳过 installer）和 --no-upstream（跳过对齐）两个开关。

.github/workflows/audit.yml：
- 触发：PR + push to main + 手动 dispatch
- 步骤：checkout（fetch-depth 0）+ setup node 20 + 加 upstream remote
  + fetch upstream main 浅克隆 + 跑 audit.sh
- FAIL > 0 → 整个 workflow 失败，PR 被卡

设计原则：
- 这次"4 个 P0 缺陷漂"事件（hooks-cursor + brainstorm + code-reviewer 引用 +
  code-reviewer.md 整合）如果当时有这个 audit 在 CI 跑，PR 阶段就会被拦下
- 用 H 数对齐而不是行数 diff 来判断结构漂移（避免翻译造成的假阳性）
- WARN（不阻塞）vs FAIL（阻塞）分级：主动扩写算 WARN，
  结构性落后上游算 FAIL

本地烟测：
- main 分支跑：92 PASS / 2 WARN / 8 FAIL（捕获到所有已知漂移）
- chore/sync-upstream-p0-drift（PR #30）跑：97 PASS / 2 WARN / 0 FAIL（PR 修复后全绿）

后续：PR #28 + #30 merge 后，main 上 FAIL 应归零（WARN 只剩 executing-plans
主动扩写一项）。
 2026-05-12 18:13:12 +08:00
AI不止语
559ba914e0 chore(skills): 同步上游 P0 漂移修复（hooks-cursor + brainstorm + code-reviewer 引用） (#30) 
* chore(skills): 同步上游 P0 漂移修复（hooks-cursor + brainstorm + code-reviewer 引用）

来自质量审计的 3 个 P0 缺陷，全部是上游漂移类（"主站有的我们没跟"），逐项 cherry-pick / 翻译同步：

1. hooks/hooks-cursor.json：command 从直接调 unix shell 脚本改回上游的
   polyglot wrapper "./hooks/run-hook.cmd session-start"。修复 Windows
   Cursor 用户 hook 完全不触发的回归。

2. skills/brainstorming/scripts/{server.cjs,start-server.sh,stop-server.sh}：
   完整 cherry-pick 上游 v5.0.6（commit 9e3ed21）的 CONTENT_DIR/STATE_DIR
   peer-dir 拆分。修复 visual brainstorming 用户因 SKILL.md 指向新路径但
   server.cjs 还用旧 SCREEN_DIR 结构导致卡死。

3. skills/requesting-code-review/SKILL.md：
   - 3 处 "superpowers:code-reviewer" 命名子代理引用 → 上游 v5.1.0 改用
     "general-purpose" Task + 模板路径的形式
   - 占位符从 5 个（含 WHAT_WAS_IMPLEMENTED + DESCRIPTION 冗余）精简到 4 个
     （只保留 DESCRIPTION 作为 "Brief summary of what you built"），与上游对齐
   - 示例段落里的占位符顺序和命名同步上游
   - "执行计划" 集成段：从 "每批（3 个任务）后审查" 改为 "每个任务完成后或
     在自然 checkpoint 审查"，对齐上游 v5.1.0 的 subagent 节奏调整

验证：3 文件 diff vs upstream 全部 0 行漂移；残留
"superpowers:code-reviewer" 字符串 0 处。

不在本 PR 范围（issue #19 其他批次留独立 PR）：
- using-git-worktrees + finishing-a-development-branch v5.1.0 安全修复 → PR #28
- brainstorming + writing-plans 的 review loop 简化 → 后续 PR
- subagent-driven-development 的节奏调整其他部分 → 后续 PR

Refs: 本次全量质量审计（102/106 测试 96.2% 通过率）

* chore(skills): 同步 code-reviewer.md 到上游 v5.1.0 self-contained 版

补漏：本次质量审计第二轮（支持文件结构对比）发现 code-reviewer.md
有真结构漂移——上游 6 个 header，我们 16 个，原因是上游 v5.1.0
（PR #1299）把 reviewer persona + checklist + dispatch 模板整合到
单一 code-reviewer.md 里，self-contained。我们仍是拆分式老版。

这是 issue #19 列出的 "v5.1.0 Code Review 整合" 待办项。同性质上游
同步（主站有的我们没跟），合并到本 PR 的 P0 漂移清单里。

改动：重写 skills/requesting-code-review/code-reviewer.md：
- 上游结构：H1 标题 + 散文 intro + 单一 Task tool 代码块（含完整
  prompt 模板）+ Placeholders 说明 + Reviewer returns 说明 + Example
  Output 段
- 翻译策略：散文逐句翻译；占位符 {DESCRIPTION}/{PLAN_OR_REQUIREMENTS}/
  {BASE_SHA}/{HEAD_SHA} 保留英文；Critical/Important/Minor 等术语保留
- 验证：上游 6 header == 我方 6 header（结构 1:1 对齐）

不在范围：reviewer-prompt.md 其他文件（spec/plan-document-reviewer-prompt.md、
subagent-driven-development/*-prompt.md）的翻译漂移——已确认全是
translation drift（H 数对齐 1:1），无结构漂移，本 PR 不动。
 2026-05-12 18:09:22 +08:00
AI不止语
473b01114c chore(skills): 同步上游 v5.1.0 worktree 安全修复（issue #19 第一批） (#28) 
把 upstream/main v5.1.0 在 using-git-worktrees + finishing-a-development-branch
两个 skill 上的行为变更逐字翻译同步过来。属于上游修复 obra/superpowers#991
（subagent 自动创建嵌套 worktree、清理误删 harness-managed workspace）。

using-git-worktrees:
- 新增 Step 0：GIT_DIR vs GIT_COMMON 检测现有隔离，submodule 守卫
- 新增创建前同意流程（除非 instructions 已声明偏好）
- 重组 Step 1 为 1a Native Tools (首选) + 1b Git Worktree Fallback
- 新增沙盒回退（permission error 时原地工作）
- 删除旧"示例工作流"段（含 /Users/jesse 硬编码路径）
- 保留章节编号 Step 1→3 的上游怪癖（不擅自"修正"）

finishing-a-development-branch:
- 新增 Step 2 检测环境（三态表决定菜单形态和清理逻辑）
- 旧 Step 2/3/4/5 重编号为 3/4/5/6
- Step 4 新增分离 HEAD 3 选项变体
- Step 5 Option 1 重写：MAIN_ROOT cwd safety + merge→verify→cleanup→delete 严格排序
- Step 5 Option 2 增加 "Do NOT cleanup worktree" 提示（PR 迭代需要）
- Step 6 清理范围限定：只清 .worktrees/ / worktrees/ / ~/.config/superpowers/worktrees/
  之内的；外部 harness-managed workspace 一律不动（核心安全修复）
- 红线 + 常见错误段扩展（按上游对应同步）

翻译原则：
- 章节标题翻译，但保留章节编号 (Step 0/1/3/4 一一对应)
- 代码块完全保留，不翻译变量名/命令
- 散文逐句翻译，不简化不扩写
- 我们独有的 "## 集成" 段保留（指向 brainstorming/subagent-driven-development 等）

不属于本 PR 范围：
- review loop 简化（v5.0.6 brainstorming/writing-plans）→ 下一批
- code-reviewer 整合（v5.1.0 requesting-code-review）→ 下一批
- subagent 节奏调整 (v5.1.0 subagent-driven-development) → 下一批
- brainstorm server.cjs 脚本结构同步 (v5.0.6 CONTENT_DIR/STATE_DIR) → 单独 PR

Refs: jnMetaCode/superpowers-zh#19
 2026-05-12 18:08:46 +08:00
AI不止语
132b658491 docs(package): description 里 superpowers star 数 99k+ → 159k+ 对齐 README 
npm registry 页面顶部显示的 description 字段写的是 99k+，但 README
已经更新到 159k+（上游 obra/superpowers 现状）。统一一下避免 npm
访客看到过时 marketing 文案。

下次 release（v1.4.0 或 v1.3.1）npm publish 会把更新后的 description
带到 npm registry。
 2026-05-11 23:25:30 +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不止语
31fb8e317b docs(readme): 手动安装段加 low-fidelity 警示，避免误以为 cp skills 等于完整 plugin (#24) 
群友反馈：「superpowers-zh 是不是只有 skills，没 hooks/commands/agents 不完整？」

实际原因不是 plugin 缺失（v1.3.0 起 skills + hooks + 4 套 manifest 齐全；
commands/ agents/ 是上游 v5.1.0 主动删的 deprecated 内容，能力已收敛进 skills），
而是本仓库 README "方式二：手动安装" 段只展示 cp -r skills，没说还要复制
hooks/ 和生成 bootstrap，导致用户自己 cp 后 skills 不会自动触发。

改动：
- 标题改为「方式二：手动安装（low-fidelity，仅作备选）」
- 顶部加 ⚠️ 提示框，列清 plugin 完整组成（skills + hooks + bootstrap + manifest）
  与手动 cp 实际丢失的内容（hooks 不配置、bootstrap 不生成、skills 不自动触发）
- 强烈推荐回方式一 npx superpowers-zh，把手动 cp 限定在「npx 不可用的极端
  无网络环境」备选位
 2026-05-10 23:44:05 +08:00
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