superpowers-zh 1.5.0 → 1.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +3 -2
- package/.cursor-plugin/plugin.json +1 -1
- package/.pi/extensions/superpowers.ts +121 -0
- package/README.md +74 -35
- package/README.zh-Hant.md +353 -0
- package/RELEASE-NOTES.zh.md +59 -0
- package/assets/qr-wechat.jpg +0 -0
- package/bin/superpowers-zh.js +242 -98
- package/docs/README.antigravity.md +7 -7
- package/docs/README.codearts.md +49 -0
- package/docs/README.codebuddy.md +54 -0
- package/docs/README.kimi.md +86 -0
- package/docs/README.pi.md +54 -0
- package/docs/README.trae.md +6 -4
- package/gemini-extension.json +1 -1
- package/hooks/session-start +4 -12
- package/package.json +18 -4
- package/skills/brainstorming/SKILL.md +5 -0
- package/skills/brainstorming/scripts/frame-template.html +25 -26
- package/skills/brainstorming/scripts/helper.js +101 -22
- package/skills/brainstorming/scripts/server.cjs +399 -30
- package/skills/brainstorming/scripts/start-server.sh +70 -9
- package/skills/brainstorming/scripts/stop-server.sh +66 -2
- package/skills/chinese-code-review/SKILL.md +5 -0
- package/skills/chinese-commit-conventions/SKILL.md +5 -0
- package/skills/chinese-documentation/SKILL.md +5 -0
- package/skills/chinese-git-workflow/SKILL.md +5 -0
- package/skills/dispatching-parallel-agents/SKILL.md +5 -0
- package/skills/executing-plans/SKILL.md +7 -2
- package/skills/finishing-a-development-branch/SKILL.md +7 -2
- package/skills/mcp-builder/SKILL.md +5 -0
- package/skills/receiving-code-review/SKILL.md +5 -0
- package/skills/requesting-code-review/SKILL.md +5 -0
- package/skills/subagent-driven-development/SKILL.md +5 -0
- package/skills/systematic-debugging/SKILL.md +5 -0
- package/skills/test-driven-development/SKILL.md +5 -0
- package/skills/using-git-worktrees/SKILL.md +14 -24
- package/skills/using-superpowers/SKILL.md +24 -72
- package/skills/using-superpowers/references/codex-tools.md +2 -2
- package/skills/using-superpowers/references/pi-tools.md +28 -0
- package/skills/verification-before-completion/SKILL.md +5 -0
- package/skills/workflow-runner/SKILL.md +5 -0
- package/skills/writing-plans/SKILL.md +5 -0
- package/skills/writing-skills/SKILL.md +5 -0
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
{
|
|
10
10
|
"name": "superpowers-zh",
|
|
11
11
|
"description": "AI 编程超能力中文增强版:20 个 skills(14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 18 款工具",
|
|
12
|
-
"version": "1.
|
|
12
|
+
"version": "1.7.0",
|
|
13
13
|
"source": "./",
|
|
14
14
|
"author": {
|
|
15
15
|
"name": "jnMetaCode",
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "superpowers-zh",
|
|
3
3
|
"description": "AI 编程超能力中文增强版:20 个 skills(14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 18 款工具",
|
|
4
|
-
"version": "1.
|
|
4
|
+
"version": "1.7.0",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "jnMetaCode",
|
|
7
7
|
"url": "https://github.com/jnMetaCode"
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "superpowers-zh",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.7.0",
|
|
4
4
|
"description": "AI 编程超能力中文增强版:头脑风暴、subagent 驱动开发、规划、TDD、调试、代码审查、收尾工作流,附 4 个中文 skills 沉淀。",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "jnMetaCode",
|
|
@@ -22,12 +22,13 @@
|
|
|
22
22
|
"中文"
|
|
23
23
|
],
|
|
24
24
|
"skills": "./skills/",
|
|
25
|
+
"hooks": {},
|
|
25
26
|
"interface": {
|
|
26
27
|
"displayName": "Superpowers 中文版",
|
|
27
28
|
"shortDescription": "面向编程 agent 的规划、TDD、调试、交付工作流(中文增强版)",
|
|
28
29
|
"longDescription": "用 Superpowers 中文版引导 agent 完成头脑风暴、实现规划、测试驱动开发、系统化调试、并行执行、代码审查与分支收尾。在上游 obra/superpowers 之上叠加 4 个中国原创 skill 与多工具适配。",
|
|
29
30
|
"developerName": "jnMetaCode",
|
|
30
|
-
"category": "
|
|
31
|
+
"category": "Developer Tools",
|
|
31
32
|
"capabilities": [
|
|
32
33
|
"Interactive",
|
|
33
34
|
"Read",
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"name": "superpowers-zh",
|
|
3
3
|
"displayName": "Superpowers 中文版",
|
|
4
4
|
"description": "AI 编程超能力中文增强版:20 个 skills(14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 18 款工具",
|
|
5
|
-
"version": "1.
|
|
5
|
+
"version": "1.7.0",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "jnMetaCode",
|
|
8
8
|
"url": "https://github.com/jnMetaCode"
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
import { dirname, resolve } from "node:path";
|
|
3
|
+
import { fileURLToPath } from "node:url";
|
|
4
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
5
|
+
|
|
6
|
+
const EXTREMELY_IMPORTANT_MARKER = "<EXTREMELY_IMPORTANT>";
|
|
7
|
+
const BOOTSTRAP_MARKER = "superpowers:using-superpowers bootstrap for pi";
|
|
8
|
+
|
|
9
|
+
const extensionDir = dirname(fileURLToPath(import.meta.url));
|
|
10
|
+
const packageRoot = resolve(extensionDir, "../..");
|
|
11
|
+
const skillsDir = resolve(packageRoot, "skills");
|
|
12
|
+
const bootstrapSkillPath = resolve(skillsDir, "using-superpowers", "SKILL.md");
|
|
13
|
+
|
|
14
|
+
let cachedBootstrap: string | null | undefined;
|
|
15
|
+
|
|
16
|
+
export default function superpowersPiExtension(pi: ExtensionAPI) {
|
|
17
|
+
let injectBootstrap = true;
|
|
18
|
+
|
|
19
|
+
pi.on("resources_discover", async () => ({
|
|
20
|
+
skillPaths: [skillsDir],
|
|
21
|
+
}));
|
|
22
|
+
|
|
23
|
+
pi.on("session_start", async () => {
|
|
24
|
+
injectBootstrap = true;
|
|
25
|
+
});
|
|
26
|
+
|
|
27
|
+
pi.on("session_compact", async () => {
|
|
28
|
+
injectBootstrap = true;
|
|
29
|
+
});
|
|
30
|
+
|
|
31
|
+
pi.on("agent_end", async () => {
|
|
32
|
+
injectBootstrap = false;
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
pi.on("context", async (event) => {
|
|
36
|
+
if (!injectBootstrap) return;
|
|
37
|
+
if (event.messages.some(messageContainsBootstrap)) return;
|
|
38
|
+
|
|
39
|
+
const bootstrap = getBootstrapContent();
|
|
40
|
+
if (!bootstrap) return;
|
|
41
|
+
|
|
42
|
+
const bootstrapMessage = {
|
|
43
|
+
role: "user" as const,
|
|
44
|
+
content: [{ type: "text" as const, text: bootstrap }],
|
|
45
|
+
timestamp: Date.now(),
|
|
46
|
+
};
|
|
47
|
+
|
|
48
|
+
const insertAt = firstNonCompactionSummaryIndex(event.messages);
|
|
49
|
+
return {
|
|
50
|
+
messages: [
|
|
51
|
+
...event.messages.slice(0, insertAt),
|
|
52
|
+
bootstrapMessage,
|
|
53
|
+
...event.messages.slice(insertAt),
|
|
54
|
+
],
|
|
55
|
+
};
|
|
56
|
+
});
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
function getBootstrapContent(): string | null {
|
|
60
|
+
if (cachedBootstrap !== undefined) return cachedBootstrap;
|
|
61
|
+
|
|
62
|
+
try {
|
|
63
|
+
const skillContent = readFileSync(bootstrapSkillPath, "utf8");
|
|
64
|
+
const body = stripFrontmatter(skillContent);
|
|
65
|
+
cachedBootstrap = `${EXTREMELY_IMPORTANT_MARKER}
|
|
66
|
+
${BOOTSTRAP_MARKER}
|
|
67
|
+
|
|
68
|
+
You have superpowers.
|
|
69
|
+
|
|
70
|
+
The using-superpowers skill content is included below and is already loaded for this Pi session. Follow it now. Do not try to load using-superpowers again.
|
|
71
|
+
|
|
72
|
+
${body}
|
|
73
|
+
|
|
74
|
+
${piToolMapping()}
|
|
75
|
+
</EXTREMELY_IMPORTANT>`;
|
|
76
|
+
return cachedBootstrap;
|
|
77
|
+
} catch {
|
|
78
|
+
cachedBootstrap = null;
|
|
79
|
+
return null;
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
function stripFrontmatter(content: string): string {
|
|
84
|
+
const match = content.match(/^---\n[\s\S]*?\n---\n([\s\S]*)$/);
|
|
85
|
+
return (match ? match[1] : content).trim();
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
function piToolMapping(): string {
|
|
89
|
+
return `## Pi tool mapping
|
|
90
|
+
|
|
91
|
+
Pi has native skills but does not expose Claude Code's \`Skill\` tool. When a Superpowers instruction says to invoke a skill, use Pi's native skill system instead: load the relevant \`SKILL.md\` with \`read\` when the skill applies, or let a human invoke \`/skill:name\` explicitly.
|
|
92
|
+
|
|
93
|
+
Pi's built-in coding tools are lowercase: \`read\`, \`write\`, \`edit\`, \`bash\`, plus optional \`grep\`, \`find\`, and \`ls\`. Use those for the corresponding actions: read a file, create or edit files, run shell commands, search file contents, find files by name, and list directories.
|
|
94
|
+
|
|
95
|
+
Pi does not ship a standard subagent tool. If a subagent tool such as \`subagent\` from \`pi-subagents\` is available, use it for Superpowers subagent workflows. If no subagent tool is available, do the work in this session or explain the missing capability instead of inventing \`Task\` calls.
|
|
96
|
+
|
|
97
|
+
Pi does not ship a standard task-list tool. If an installed todo/task tool is available, use it. Otherwise track work in plan files or a repo-local \`TODO.md\` when task tracking is needed. Treat older \`TodoWrite\` references as this task-tracking action.`;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
function messageContainsBootstrap(message: unknown): boolean {
|
|
101
|
+
const content = (message as { content?: unknown }).content;
|
|
102
|
+
if (typeof content === "string") return content.includes(BOOTSTRAP_MARKER);
|
|
103
|
+
if (!Array.isArray(content)) return false;
|
|
104
|
+
return content.some((part) => {
|
|
105
|
+
return (
|
|
106
|
+
part &&
|
|
107
|
+
typeof part === "object" &&
|
|
108
|
+
(part as { type?: unknown }).type === "text" &&
|
|
109
|
+
typeof (part as { text?: unknown }).text === "string" &&
|
|
110
|
+
(part as { text: string }).text.includes(BOOTSTRAP_MARKER)
|
|
111
|
+
);
|
|
112
|
+
});
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
function firstNonCompactionSummaryIndex(messages: unknown[]): number {
|
|
116
|
+
let index = 0;
|
|
117
|
+
while ((messages[index] as { role?: unknown } | undefined)?.role === "compactionSummary") {
|
|
118
|
+
index += 1;
|
|
119
|
+
}
|
|
120
|
+
return index;
|
|
121
|
+
}
|
package/README.md
CHANGED
|
@@ -1,10 +1,34 @@
|
|
|
1
1
|
# superpowers-zh(AI 编程超能力 · 中文增强版)
|
|
2
2
|
|
|
3
|
-
🌐 **简体中文** | [English (upstream)](https://github.com/obra/superpowers)
|
|
3
|
+
🌐 **简体中文** | [繁體中文](README.zh-Hant.md) | [English (upstream)](https://github.com/obra/superpowers)
|
|
4
4
|
|
|
5
|
-
> 🦸 **superpowers(
|
|
5
|
+
> 🦸 **superpowers(250k+ ⭐)完整汉化 + 4 个中国原创 skills** — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **20 款 AI 编程工具**真正会干活。从头脑风暴到代码审查,从 TDD 到调试,每个 skill 都是经过实战验证的工作方法论。
|
|
6
6
|
|
|
7
|
-
Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across
|
|
7
|
+
Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 20 AI coding tools, including full translations and China-specific development skills.
|
|
8
|
+
|
|
9
|
+
[](https://sp.aiolaola.com)
|
|
10
|
+
[](https://github.com/jnMetaCode/superpowers-zh)
|
|
11
|
+
[](https://www.npmjs.com/package/superpowers-zh)
|
|
12
|
+
[](https://opensource.org/licenses/MIT)
|
|
13
|
+
[](https://makeapullrequest.com)
|
|
14
|
+
|
|
15
|
+
> 📖 **免费配套学习** → [从零学会 AI 编程](https://aiolaola.com/?utm_source=github&utm_campaign=superpowers):180 节免费实操课 + 《AI 编程实战三卷书》在线阅读 + 实战社区 · superpowers 装好后配上方法论效率翻倍 · 永久免费
|
|
16
|
+
|
|
17
|
+
### 📊 项目规模
|
|
18
|
+
|
|
19
|
+
| 📦 翻译 Skills | 🇨🇳 中国特色 Skills | 🤖 支持工具 |
|
|
20
|
+
|:---:|:---:|:---:|
|
|
21
|
+
| **14** | **6** | **Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity / Claw Code / Qoder** |
|
|
22
|
+
|
|
23
|
+
> 🙏 **想赞助支持本项目?** 联系 **jnMetaCode@qq.com**
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## 这是什么?
|
|
28
|
+
|
|
29
|
+
[superpowers](https://github.com/obra/superpowers) 是目前最火的 AI 编程 skills 框架(250k+ stars),为 AI 编程工具提供**系统化的工作方法论**。
|
|
30
|
+
|
|
31
|
+
**superpowers-zh** 在完整翻译的基础上,新增了面向中国开发者的特色 skills。
|
|
8
32
|
|
|
9
33
|
<!-- 效果对比 -->
|
|
10
34
|
<table>
|
|
@@ -33,35 +57,14 @@ AI:在开始实现之前,我需要了解几个关键问题:
|
|
|
33
57
|
</td></tr>
|
|
34
58
|
</table>
|
|
35
59
|
|
|
36
|
-
[](https://github.com/jnMetaCode/superpowers-zh)
|
|
37
|
-
[](https://www.npmjs.com/package/superpowers-zh)
|
|
38
|
-
[](https://opensource.org/licenses/MIT)
|
|
39
|
-
[](https://makeapullrequest.com)
|
|
40
|
-
|
|
41
|
-
> 📖 **配套阅读**:[《AI 编程实战 · 方法论三卷书》](https://book.aibuzhiyu.com/) — 10 个 AI 编程工具完整教程 + 真实踩坑 · superpowers 装好之后,配上方法论效率翻倍 · 在线书 + PDF · 永久免费
|
|
42
|
-
|
|
43
|
-
### 📊 项目规模
|
|
44
|
-
|
|
45
|
-
| 📦 翻译 Skills | 🇨🇳 中国特色 Skills | 🤖 支持工具 |
|
|
46
|
-
|:---:|:---:|:---:|
|
|
47
|
-
| **14** | **6** | **Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity / Claw Code / Qoder** |
|
|
48
|
-
|
|
49
|
-
---
|
|
50
|
-
|
|
51
|
-
## 这是什么?
|
|
52
|
-
|
|
53
|
-
[superpowers](https://github.com/obra/superpowers) 是目前最火的 AI 编程 skills 框架(159k+ stars),为 AI 编程工具提供**系统化的工作方法论**。
|
|
54
|
-
|
|
55
|
-
**superpowers-zh** 在完整翻译的基础上,新增了面向中国开发者的特色 skills。
|
|
56
|
-
|
|
57
60
|
### 🆚 与英文上游的区别(老被问,一次说清)
|
|
58
61
|
|
|
59
62
|
| 维度 | superpowers(英文上游) | superpowers-zh(中文增强版) |
|
|
60
63
|
|------|----------------------|---------------------------|
|
|
61
|
-
| ⭐ Star 数 |
|
|
64
|
+
| ⭐ Star 数 | 250k+ | — |
|
|
62
65
|
| 📦 Skills 总数 | 14 | **20**(14 翻译 + 4 国产原创 + 2 上游历史保留) |
|
|
63
66
|
| 🌐 语言 | 英文 | 中文(技术术语保留英文) |
|
|
64
|
-
| 🤖 **支持工具** | **6 款**:Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **
|
|
67
|
+
| 🤖 **支持工具** | **6 款**:Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **20 款**:上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code(通义灵码)/ OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy(腾讯) / CodeArts(华为云码道) |
|
|
65
68
|
| ⚡ **安装方式** | 按工具分别装(每款一条不同的 plugin marketplace 命令) | **`npx superpowers-zh` 一条命令自动识别项目里的工具并安装**;识别不出可 `--tool <name>` 显式指定 |
|
|
66
69
|
| 🇨🇳 Git 平台 | GitHub 为主 | GitHub + Gitee + Coding + 极狐 GitLab + **CNB(腾讯云原生构建)** |
|
|
67
70
|
| 🇨🇳 CI/CD 示例 | GitHub Actions | GitHub Actions + Gitee Go + Coding CI + 极狐 CI + `.cnb.yml` |
|
|
@@ -75,9 +78,9 @@ AI:在开始实现之前,我需要了解几个关键问题:
|
|
|
75
78
|
| 💬 社区 | Discord | 微信公众号「AI不止语」+ 微信群 + QQ 群 |
|
|
76
79
|
| 📜 License | MIT | MIT |
|
|
77
80
|
|
|
78
|
-
**一句话总结:** 英文上游 = 方法论内核;中文增强版 = 方法论内核 **+**
|
|
81
|
+
**一句话总结:** 英文上游 = 方法论内核;中文增强版 = 方法论内核 **+** 20 款工具一键适配 **+** 国内 Git/CI 生态 **+** 中文化表达习惯。
|
|
79
82
|
|
|
80
|
-
### 🤖 支持
|
|
83
|
+
### 🤖 支持 20 款主流 AI 编程工具
|
|
81
84
|
|
|
82
85
|
| 工具 | 类型 | 一键安装 | 手动安装 |
|
|
83
86
|
|------|------|:---:|:---:|
|
|
@@ -96,9 +99,11 @@ AI:在开始实现之前,我需要了解几个关键问题:
|
|
|
96
99
|
| [OpenCode](https://opencode.ai) | CLI | `npx superpowers-zh` | `.opencode/skills/` |
|
|
97
100
|
| [OpenClaw](https://github.com/anthropics/openclaw) | CLI | `npx superpowers-zh` | `skills/` |
|
|
98
101
|
| [Qwen Code](https://tongyi.aliyun.com/lingma) (通义灵码) | IDE 插件 | `npx superpowers-zh` | `.qwen/skills/` |
|
|
99
|
-
| [Antigravity](https://github.com/anthropics/antigravity) | CLI | `npx superpowers-zh` | `.
|
|
102
|
+
| [Antigravity](https://github.com/anthropics/antigravity) | CLI | `npx superpowers-zh` | `.agents/skills/` |
|
|
100
103
|
| [Claw Code](https://github.com/ultraworkers/claw-code) | CLI (Rust) | `npx superpowers-zh` | `.claw/skills/` |
|
|
101
104
|
| [Qoder](https://qoder.com) (阿里 AI IDE) | IDE | `npx superpowers-zh` | `.qoder/skills/` + `.qoder/rules/` |
|
|
105
|
+
| [CodeBuddy](https://copilot.tencent.com) (腾讯 AI IDE) | IDE | `npx superpowers-zh` | `.codebuddy/skills/` + `CODEBUDDY.md` |
|
|
106
|
+
| [华为云码道 CodeArts](https://www.huaweicloud.com/product/codeartsdoer.html) | IDE | `npx superpowers-zh` | `.codeartsdoer/skills/` |
|
|
102
107
|
|
|
103
108
|
> 运行 `npx superpowers-zh` 会自动检测你项目中使用的工具,将 20 个 skills 安装到正确位置。
|
|
104
109
|
|
|
@@ -141,12 +146,32 @@ AI:在开始实现之前,我需要了解几个关键问题:
|
|
|
141
146
|
|
|
142
147
|
### 方式一:npm 安装(推荐)
|
|
143
148
|
|
|
149
|
+
**项目级**(默认,装到当前项目):
|
|
150
|
+
|
|
144
151
|
```bash
|
|
145
152
|
cd /your/project
|
|
146
153
|
npx superpowers-zh
|
|
147
154
|
```
|
|
148
155
|
|
|
149
|
-
> ⚠️
|
|
156
|
+
> ⚠️ **项目级安装不要在主目录(`~`)下跑**。v1.2.1 起会拒绝并提示,老版本会把 skills 和 `CLAUDE.md` 等 bootstrap 文件写到你的 home 目录,污染所有项目。如已误装见下文「卸载 / 误装清理」。想让 skills 对所有项目生效,请用下面的**全局安装**,而不是在 `~` 下跑项目级。
|
|
157
|
+
|
|
158
|
+
**全局安装**(v1.7.0+,装到用户目录,所有项目共享,适合同时维护多个项目):
|
|
159
|
+
|
|
160
|
+
```bash
|
|
161
|
+
npx superpowers-zh --global # 自动检测已装工具
|
|
162
|
+
npx superpowers-zh --global --tool claude # 或指定工具
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
全局安装把 skills 装到工具的**用户级目录**(如 `~/.claude/skills`),一次安装所有项目自动可用,更新时也只需重装一次。**项目级优先、全局兜底**,二者可共存。
|
|
166
|
+
|
|
167
|
+
支持通用全局安装的工具(均为 docs 已证实的用户级加载路径):**Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode**。其中 **Codex CLI** 全局装到 `~/.agents/skills`(Codex 启动扫描目录)。其余工具(Cursor / Kiro / Trae / Aider / DeerFlow / VS Code / Hermes / Claw)规则是项目级或存于应用内设置,`--global` 会提示改用项目级;**Gemini CLI / Antigravity** 有各自专属的全局方式(Gemini 走扩展目录),见对应 `docs/README.*.md`。
|
|
168
|
+
|
|
169
|
+
| | 项目级(默认) | 全局(`--global`) |
|
|
170
|
+
|---|---|---|
|
|
171
|
+
| 安装位置 | `<项目>/.claude/skills` 等 | `~/.claude/skills` 等用户级目录 |
|
|
172
|
+
| 生效范围 | 仅当前项目 | 所有项目 |
|
|
173
|
+
| 适合 | 单项目、需项目内版本固定 | 多项目、想一次装好到处可用 |
|
|
174
|
+
| 卸载 | `npx superpowers-zh --uninstall` | `npx superpowers-zh --global --uninstall` |
|
|
150
175
|
|
|
151
176
|
### 方式二:手动安装(low-fidelity,仅作备选)
|
|
152
177
|
|
|
@@ -170,7 +195,7 @@ cp -r superpowers-zh/skills /your/project/.codex/skills # Codex CLI
|
|
|
170
195
|
cp -r superpowers-zh/skills /your/project/.kiro/steering # Kiro
|
|
171
196
|
cp -r superpowers-zh/skills /your/project/skills/custom # DeerFlow 2.0
|
|
172
197
|
cp -r superpowers-zh/skills /your/project/.trae/rules # Trae
|
|
173
|
-
cp -r superpowers-zh/skills /your/project/.
|
|
198
|
+
cp -r superpowers-zh/skills /your/project/.agents # Antigravity
|
|
174
199
|
cp -r superpowers-zh/skills /your/project/.github/superpowers # VS Code (Copilot)
|
|
175
200
|
cp -r superpowers-zh/skills /your/project/skills # OpenClaw
|
|
176
201
|
cp -r superpowers-zh/skills /your/project/.windsurf/skills # Windsurf
|
|
@@ -207,7 +232,7 @@ cp -r superpowers-zh/skills /your/project/.qoder/skills # Qoder(阿里 AI
|
|
|
207
232
|
| Claw Code | `.claw/skills/*/SKILL.md` | Rust 版 CLI agent,兼容 Claude Code 的 SKILL.md 格式 |
|
|
208
233
|
| Qoder | `.qoder/skills/*/SKILL.md` + `.qoder/rules/superpowers-zh.md` | 阿里 AI IDE,自动生成 `trigger: always_on` 的 bootstrap rule |
|
|
209
234
|
|
|
210
|
-
> **详细安装指南**:[Kiro](docs/README.kiro.md) · [DeerFlow](docs/README.deerflow.md) · [Trae](docs/README.trae.md) · [Antigravity](docs/README.antigravity.md) · [VS Code](docs/README.vscode.md) · [Codex](docs/README.codex.md) · [OpenCode](docs/README.opencode.md) · [OpenClaw](docs/README.openclaw.md) · [Windsurf](docs/README.windsurf.md) · [Gemini CLI](docs/README.gemini-cli.md) · [Aider](docs/README.aider.md) · [Qwen Code](docs/README.qwen.md) · [Hermes Agent](docs/README.hermes.md) · [Qoder](docs/README.qoder.md)
|
|
235
|
+
> **详细安装指南**:[Kiro](docs/README.kiro.md) · [DeerFlow](docs/README.deerflow.md) · [Trae](docs/README.trae.md) · [Antigravity](docs/README.antigravity.md) · [VS Code](docs/README.vscode.md) · [Codex](docs/README.codex.md) · [OpenCode](docs/README.opencode.md) · [OpenClaw](docs/README.openclaw.md) · [Windsurf](docs/README.windsurf.md) · [Gemini CLI](docs/README.gemini-cli.md) · [Aider](docs/README.aider.md) · [Qwen Code](docs/README.qwen.md) · [Hermes Agent](docs/README.hermes.md) · [Qoder](docs/README.qoder.md) · [CodeBuddy](docs/README.codebuddy.md) · [华为云码道](docs/README.codearts.md) · [Kimi Code](docs/README.kimi.md) · [Pi](docs/README.pi.md)
|
|
211
236
|
|
|
212
237
|
### 卸载 / 误装清理(v1.2.1+)
|
|
213
238
|
|
|
@@ -219,7 +244,7 @@ npx superpowers-zh@latest --uninstall
|
|
|
219
244
|
会做这些:
|
|
220
245
|
|
|
221
246
|
- 删除所有装过的 skill 目录(`.claude/skills/`、`.trae/skills/` 等)
|
|
222
|
-
- 删除独立 bootstrap 文件(`.trae/rules/superpowers-zh.md`、`.qoder/rules/superpowers-zh.md`、`.
|
|
247
|
+
- 删除独立 bootstrap 文件(`.trae/rules/superpowers-zh.md`、`.qoder/rules/superpowers-zh.md`、`.agents/rules.md`)
|
|
223
248
|
- 清理追加到 `CLAUDE.md` / `HERMES.md` / `GEMINI.md` / `CONVENTIONS.md` 里的 superpowers-zh 段,**保留你自己写的内容**
|
|
224
249
|
|
|
225
250
|
数据安全说明:v1.2.1 起,安装会把追加内容包在 `<!-- superpowers-zh:begin/end -->` 哨兵注释之间,卸载按哨兵精确切除。识别不可靠时跳过 + 警告,**绝不会误删用户内容**。
|
|
@@ -253,6 +278,14 @@ npx superpowers-zh@latest --uninstall
|
|
|
253
278
|
|
|
254
279
|
## 交流 · Community
|
|
255
280
|
|
|
281
|
+
<table>
|
|
282
|
+
<tr>
|
|
283
|
+
<td width="170" align="center">
|
|
284
|
+
<img src="assets/qr-wechat.jpg" width="150" alt="微信公众号 AI不止语 二维码"><br>
|
|
285
|
+
<sub>微信扫码关注</sub>
|
|
286
|
+
</td>
|
|
287
|
+
<td>
|
|
288
|
+
|
|
256
289
|
微信公众号 **「AI不止语」**(微信搜索 `AI_BuZhiYu`)— 技术问答 · 项目更新 · 实战文章
|
|
257
290
|
|
|
258
291
|
| 渠道 | 加入方式 |
|
|
@@ -260,11 +293,15 @@ npx superpowers-zh@latest --uninstall
|
|
|
260
293
|
| QQ 2群 | [点击加入](https://qm.qq.com/q/EeNQA9xCxy)(群号 1071280067) |
|
|
261
294
|
| 微信群 | 关注公众号后回复「群」获取入群方式 |
|
|
262
295
|
|
|
296
|
+
</td>
|
|
297
|
+
</tr>
|
|
298
|
+
</table>
|
|
299
|
+
|
|
263
300
|
---
|
|
264
301
|
|
|
265
302
|
## 🌟 相关项目生态
|
|
266
303
|
|
|
267
|
-
|
|
304
|
+
**八个项目组合使用,覆盖 AI 编程 + AI 视频创作 + 桌面陪伴的完整链路。**
|
|
268
305
|
|
|
269
306
|
| 项目 | 定位 | 一句话 |
|
|
270
307
|
|------|------|-------|
|
|
@@ -274,6 +311,8 @@ npx superpowers-zh@latest --uninstall
|
|
|
274
311
|
| **[ai-coding-guide](https://github.com/jnMetaCode/ai-coding-guide)** | 📖 实战教程 | 66 个 Claude Code 技巧 + 9 款工具最佳实践 + 配置模板 |
|
|
275
312
|
| **[shellward](https://github.com/jnMetaCode/shellward)** | 🛡️ 安全中间件 | 8 层防御 + DLP 数据流 + 注入检测,**零依赖**(含 MCP Server) |
|
|
276
313
|
| 🆕 **[ai-shortfilm-prompts](https://github.com/jnMetaCode/ai-shortfilm-prompts)** | 🎬 视频提示词 | Mx-Shell《丧尸清道夫》5 段式方法论 + Skill,Seedance / 小云雀 / Sora / 可灵 / 即梦通用 |
|
|
314
|
+
| 🆕 **[local-agent-toolkit](https://github.com/jnMetaCode/local-agent-toolkit)** | 🛠️ Agent 本地三件套 | 给 agent 配上**记忆 / 技能管理 / 运行追踪**,零依赖、数据不出本机;本仓库 skills 可用 `npx @jnmetacode/skillet add jnMetaCode/superpowers-zh/skills/<名称>` 一键安装 |
|
|
315
|
+
| 🆕 **[codepet](https://github.com/jnMetaCode/codepet)** | 🐾 桌面养成桌宠 | 码宠 CodePet —— 你写代码 / 用 Claude Code,它就涨经验、升级、换状态、跳舞。**全本地、隐私优先、开源** |
|
|
277
316
|
|
|
278
317
|
---
|
|
279
318
|
|
|
@@ -307,7 +346,7 @@ MIT License — 自由使用,商业或个人均可。
|
|
|
307
346
|
|
|
308
347
|
<div align="center">
|
|
309
348
|
|
|
310
|
-
**🦸 AI 编程超能力:让 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等
|
|
349
|
+
**🦸 AI 编程超能力:让 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 20 款工具真正会干活**
|
|
311
350
|
|
|
312
351
|
[Star 本项目](https://github.com/jnMetaCode/superpowers-zh) · [提交 Issue](https://github.com/jnMetaCode/superpowers-zh/issues) · [贡献代码](https://github.com/jnMetaCode/superpowers-zh/pulls)
|
|
313
352
|
|