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

9 Commits

Author SHA1 Message Date
AI不止语
43a46f7912 refactor(skills): fork 增量改为外挂式并强制声明，保证上游各节不被改动 
按维护者决定：保留翻译 skill 内的 fork 增量，但必须做到「不影响上游部分」。
原来的做法做不到这一点 —— 增量是**插在上游步骤序列中间**的。

## 问题

executing-plans 把「处理常见异常」插成了步骤 3，于是上游的
Step 3: Complete Development 被挤成了我们的「步骤 4」。这就不是「不影响上游」，
而是改了上游的结构编号；Remember 也被多加了一条，从上游的 6 条变成 7 条。

## 改法：外挂式

- 「处理常见异常」移出步骤序列，改为独立小节，挂在「何时停下来求助」之后
  （它本就是那一节里「缺少依赖、测试失败、指令不清」三种情形的展开）
- 步骤编号恢复为 1/2/3，与上游逐条对应
- Remember 恢复为上游的 6 条；被多加的「每个任务单独提交」并入外挂节
- 节内首行显式标注：本节是 superpowers-zh 的增量内容，上游没有

using-superpowers 的「中国特色技能路由」同样加上该标注。

现在 14 个翻译 skill 里，上游各节全部逐节对应；多出的 2 节都带标注。

## 让纪律可执行：audit 新增 3c-bis

光靠 README 声明会漂移。新增检查：翻译 skill 的标题数必须等于
「上游标题数 + 本文件里带标注的增量节数」。标注与内容同处一文件，不会各自漂移。
未标注就多出章节 = 隐性分叉，下次同步会被误当成漏译 —— 直接 FAIL。

已双向验证：给 brainstorming 偷偷加一节会被拦下并给出可操作提示，
加上标注后放行。

## 修掉一个让守卫从未生效的 bug（我自己写的）

3c-bis 第一次测试没拦住。查出原因：`grep -c` 匹配到 0 个时输出 "0" 但
**退出码为 1**，写成 `$(grep -c ... || echo 0)` 会拼出 "0\n0"，后续整数比较
直接报错、检查静默失效。改用 `; true` 只吞退出码。

全仓扫同一模式，发现测试辅助里也有 3 处（上游同样有这个 bug）：
- tests/claude-code/test-helpers.sh:77 assert_count 的实际值
- test-subagent-driven-development-integration.sh 的 task_count / todo_count

这个 bug 的后果是断言**永远无法正常失败** —— 模式没匹配到时比较报错而非判定失败。
三处一并修掉并加注释说明原因。（tests/ 不进 npm 包，仅开发使用。）

修复后 audit 由 154 升到 166 pass —— 因为 3c-bis 现在真的对 14 个 skill 都跑了。

## README

简繁对比表新增一行「翻译 skill 内的增量」，写明仅 2 处、都带标注、
上游各节不被改动、audit 会强制未标注的增量报错。

验证：audit.sh 166 pass / 0 warn / 0 fail、verify-release.sh 90 pass / 0 fail
 2026-08-08 14:26:16 +08:00
AI不止语
b494acfa12 fix(test): opencode setup.sh 不再拷不存在的 lib/ 
tests/opencode/setup.sh 从上游照搬了 `cp -r $REPO_ROOT/lib`，但本 fork
没有 lib/ 目录，导致 test-plugin-loading.sh 在 setup 阶段就 cp 失败、
整个 opencode 测试套件飘红（既有问题，CI 不跑、不拦门）。

本 fork 的 opencode 插件（.opencode/plugins/superpowers.js）自包含、
仅 readFileSync 读取 ../../skills，不依赖 lib，故删除该多余拷贝。

验证：bash tests/opencode/run-tests.sh → STATUS: PASSED（1 passed/0 failed）。
 2026-06-20 09:09:21 +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不止语
483621d8bd Merge pull request #59 from jnMetaCode/sync/v6-kimi-harness 
feat(kimi): 新增 Kimi Code harness 支持（关 #37，对齐上游 v6.0.0）
 2026-06-20 07:22:21 +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
AI不止语
8ca12c26e3 sync(v6): brainstorm 可视化伴侣安全模型 + 测试套件对齐上游 v6.0.0 
上游 v6.0.0 给 brainstorm 可视化伴侣服务器重写了安全模型：之前服务器
监听 loopback 但无任何鉴权，任意本地浏览器标签页都能读取 brainstorm
屏幕/文件、或向正在运行的 agent 会话注入事件（prompt injection）。新模型
用每会话密钥（?key=<token> 或会话 cookie）门禁所有端点，并加一组安全头
（X-Frame-Options: DENY、CSP frame-ancestors none、Cross-Origin-Resource-Policy
same-origin 等）。本 fork 此前停留在旧无鉴权版本。

改动（全部逐字节对齐上游 main，本 fork 在这些文件无中文/品牌定制）：
- skills/brainstorming/scripts/server.cjs：旧 354 行 → 723 行，新鉴权模型
- skills/brainstorming/scripts/{frame-template.html,helper.js}：v6 重构拆出的
  独立模板/客户端 helper，旧版与新 server.cjs 不匹配会导致 UI 崩坏
- skills/brainstorming/scripts/{start,stop}-server.sh：随之更新
- tests/brainstorm-server/：同步上游全套测试（auth/branding/server/lifecycle/
  helper/ws-protocol/browser-launcher 等），否则旧测试与新 server 不匹配

验证：tests/brainstorm-server 全套 npm test 通过，exit 0
（ws-protocol 32 / helper 15 / browser-launcher 3 / auth 20 / branding 7 /
server 33 / lifecycle 13 / start 4 / stop 7，0 failed）。所有 17 个文件
与上游 main 逐字节一致。

修复 CI「全量审计」中 brainstorm script 漂移项。关联 #19（v6 同步追踪）
 2026-06-20 01:57:20 +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
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