superpowers-zh 1.7.14 → 1.8.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 +1 -1
- package/.cursor-plugin/plugin.json +1 -1
- package/.opencode/INSTALL.md +1 -1
- package/README.md +25 -25
- package/README.zh-Hant.md +24 -24
- package/RELEASE-NOTES.zh.md +46 -0
- package/assets/sponsors/88api.jpg +0 -0
- package/assets/sponsors/apinebula.png +0 -0
- package/assets/sponsors/logo-infistar-icon.png +0 -0
- package/assets/sponsors/logo-sidrune-ai.png +0 -0
- package/docs/README.opencode.md +1 -1
- package/gemini-extension.json +1 -1
- package/hooks/run-hook.cmd +34 -18
- package/hooks/session-start +40 -8
- package/package.json +3 -3
- package/skills/brainstorming/SKILL.md +105 -191
- package/skills/brainstorming/builder-check-prompt.md +15 -0
- package/skills/brainstorming/scripts/server.cjs +1 -1
- package/skills/chinese-code-review/SKILL.md +1 -1
- package/skills/chinese-commit-conventions/SKILL.md +1 -1
- package/skills/executing-plans/scripts/task-done +1 -1
- package/skills/requesting-code-review/SKILL.md +1 -1
- package/skills/subagent-driven-development/scripts/sdd-workspace +9 -4
- package/skills/systematic-debugging/CREATION-LOG.md +1 -1
- package/skills/systematic-debugging/SKILL.md +2 -2
- package/skills/writing-skills/SKILL.md +1 -1
- package/assets/sponsors/apimart.jpg +0 -0
- package/assets/sponsors/compshare.jpg +0 -0
- package/assets/sponsors/logo-apimart-icon.png +0 -0
- package/assets/sponsors/logo-compshare-icon.png +0 -0
- package/assets/sponsors/logo-fluxionai-icon.png +0 -0
- package/skills/brainstorming/spec-document-reviewer-prompt.md +0 -48
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
{
|
|
10
10
|
"name": "superpowers-zh",
|
|
11
11
|
"description": "AI 编程超能力中文增强版:21 个 skills(15 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 26 款工具",
|
|
12
|
-
"version": "1.
|
|
12
|
+
"version": "1.8.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 编程超能力中文增强版:21 个 skills(15 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 26 款工具",
|
|
4
|
-
"version": "1.
|
|
4
|
+
"version": "1.8.0",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "jnMetaCode",
|
|
7
7
|
"url": "https://github.com/jnMetaCode"
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"name": "superpowers-zh",
|
|
3
3
|
"displayName": "Superpowers 中文版",
|
|
4
4
|
"description": "AI 编程超能力中文增强版:21 个 skills(15 翻译 + 4 中国原创 + 2 上游历史保留),支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 26 款工具",
|
|
5
|
-
"version": "1.
|
|
5
|
+
"version": "1.8.0",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "jnMetaCode",
|
|
8
8
|
"url": "https://github.com/jnMetaCode"
|
package/.opencode/INSTALL.md
CHANGED
|
@@ -70,7 +70,7 @@ OpenCode 通过一个基于 git 的包说明(package spec)安装 Superpowers
|
|
|
70
70
|
|
|
71
71
|
```json
|
|
72
72
|
{
|
|
73
|
-
"plugin": ["superpowers@git+https://github.com/jnMetaCode/superpowers-zh.git#v1.7.
|
|
73
|
+
"plugin": ["superpowers@git+https://github.com/jnMetaCode/superpowers-zh.git#v1.7.14"]
|
|
74
74
|
}
|
|
75
75
|
```
|
|
76
76
|
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
🌐 **简体中文** | [繁體中文](README.zh-Hant.md) | [English (upstream)](https://github.com/obra/superpowers)
|
|
4
4
|
|
|
5
|
-
> 🦸 **superpowers(
|
|
5
|
+
> 🦸 **superpowers(300k+ ⭐)完整汉化 + 4 个中国原创 skills** — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **26 款 AI 编程工具**真正会干活。从头脑风暴到代码审查,从 TDD 到调试,每个 skill 都是经过实战验证的工作方法论。
|
|
6
6
|
|
|
7
7
|
Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 21 skills across 26 AI coding tools, including full translations and China-specific development skills.
|
|
8
8
|
|
|
@@ -12,7 +12,7 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
|
|
|
12
12
|
[](https://opensource.org/licenses/MIT)
|
|
13
13
|
[](https://makeapullrequest.com)
|
|
14
14
|
|
|
15
|
-
> 📖 **免费配套学习** → [从零学会 AI 编程](https://aiolaola.com/?utm_source=github&utm_campaign=superpowers)(182 节)+ [从零构建 AI 智能体](https://aiolaola.com/course/ai-agent?utm_source=github&utm_campaign=superpowers)(40 节):两门免费实操课 + 实战社区,superpowers 装好后配上方法论效率翻倍(站上共
|
|
15
|
+
> 📖 **免费配套学习** → [从零学会 AI 编程](https://aiolaola.com/?utm_source=github&utm_campaign=superpowers)(182 节)+ [从零构建 AI 智能体](https://aiolaola.com/course/ai-agent?utm_source=github&utm_campaign=superpowers)(40 节):两门免费实操课 + 实战社区,superpowers 装好后配上方法论效率翻倍(站上共 14 门课、700 节,**全部 ¥0**——另有 大模型原理 / AI 绘画 / 写小说 / 漫剧 / 量化 / DeepSeek / 深度专注 等)
|
|
16
16
|
>
|
|
17
17
|
> 🌍 Also available in [English](https://aiolaola.com/en?utm_source=github&utm_campaign=superpowers) · [日本語](https://aiolaola.com/ja?utm_source=github&utm_campaign=superpowers) · [Español](https://aiolaola.com/es?utm_source=github&utm_campaign=superpowers) · [한국어](https://aiolaola.com/ko?utm_source=github&utm_campaign=superpowers) · [繁體中文](https://aiolaola.com/zh-Hant?utm_source=github&utm_campaign=superpowers)
|
|
18
18
|
|
|
@@ -29,33 +29,33 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
|
|
|
29
29
|
## ❤️ 赞助商 <sub>🙏 想出现在这里?联系 **jnMetaCode@qq.com** 赞助</sub>
|
|
30
30
|
|
|
31
31
|
<p align="center">
|
|
32
|
-
<a href="https://
|
|
33
|
-
<img src="assets/sponsors/
|
|
32
|
+
<a href="https://apinebula.ai/1Axi9F">
|
|
33
|
+
<img src="assets/sponsors/apinebula.png" alt="APINEBULA —— 企业级 AI 聚合平台,一个接口接入 Claude、GPT、Gemini 等全球顶尖模型,价格低至 1 折" width="100%">
|
|
34
34
|
</a>
|
|
35
35
|
</p>
|
|
36
36
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
感谢 Infistar.cc 无限星河 赞助并为 superpowers-zh 用户提供模型服务支持!
|
|
37
|
+
感谢 [APINEBULA](https://apinebula.ai/1Axi9F) 大屏赞助本项目!APINEBULA 是银河录像局旗下的企业级 AI 聚合平台,背靠大平台资源,面向开发者、团队与企业用户提供稳定、高性价比的大模型 API 接入服务。平台聚合 Claude、GPT、Gemini 等主流满血模型,一个接口接入全球顶尖 AI 大模型,各大模型价格低至 1 折起,支持企业级高并发、正式合同、对公打款与开票服务,适合 AI 编程、Agent 开发、业务系统集成等多种场景!
|
|
40
38
|
|
|
41
|
-
|
|
42
|
-
- 🧠 **一个 API Key 接入主流模型**:全面支持 Claude、ChatGPT、Gemini、Kimi、GLM、DeepSeek 等模型,适配 Claude Code、Codex、Cursor、Windsurf、Kiro 等 AI 编程工具。
|
|
43
|
-
- 🛠️ **赋能完整开发工作流**:结合 superpowers-zh 的系统化 Skills,让 AI 更好地完成头脑风暴、计划执行、问题排查和质量检查。
|
|
44
|
-
|
|
45
|
-
🎁 **superpowers-zh 用户专属福利:通过[此链接](https://www.infistar.cc/register?aff=PDVTM2VS&ref_source=link)注册并完成首次调用,即可领取 5 美元等值测试额度!**
|
|
39
|
+
🎁 **通过[此链接](https://apinebula.ai/1Axi9F)注册并在充值时填写 `agent` 优惠码可享 9 折优惠!**
|
|
46
40
|
|
|
47
41
|
<hr>
|
|
48
42
|
|
|
49
43
|
<table>
|
|
50
44
|
<tr>
|
|
51
45
|
<td width="25%">
|
|
52
|
-
<a href="https://
|
|
53
|
-
<img src="assets/sponsors/
|
|
46
|
+
<a href="https://88api.ai/sign-up?aff=MvTX">
|
|
47
|
+
<img src="assets/sponsors/88api.jpg" alt="88API Token聚合平台 —— 聚合语言、编程、图片、视频与语音模型的一站式 AI API 平台" width="100%">
|
|
54
48
|
</a>
|
|
55
49
|
</td>
|
|
56
50
|
<td width="75%" valign="middle">
|
|
57
51
|
|
|
58
|
-
|
|
52
|
+
[88API Token聚合平台](https://88api.ai/sign-up?aff=MvTX)<br>
|
|
53
|
+
🧠 聚合 GPT、Claude、Gemini、Grok、DeepSeek、Kimi、GLM 等语言与编程模型;<br>
|
|
54
|
+
🎨 图片模型:GPT-Image、Gemini、Grok 等;<br>
|
|
55
|
+
🎬 视频模型:Seedance、Veo、MiniMax H3、Kling、Grok 等;<br>
|
|
56
|
+
🎙️ 语音能力:Whisper、TTS 等。从文案、出图、改图,到视频生成与配音<br>
|
|
57
|
+
🎁新用户注册送体验额度,可以检测模型能力。站内有人工客服值守!<br>
|
|
58
|
+
👉香港正规企业运营 稳定供应 全绿满血 不降智 提供发票
|
|
59
59
|
|
|
60
60
|
</td>
|
|
61
61
|
</tr>
|
|
@@ -76,14 +76,14 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
|
|
|
76
76
|
</table>
|
|
77
77
|
<table>
|
|
78
78
|
<tr>
|
|
79
|
-
<td width="25%">
|
|
80
|
-
<a href="https://
|
|
81
|
-
<img src="assets/sponsors/
|
|
79
|
+
<td width="25%" align="center">
|
|
80
|
+
<a href="https://sidrune.ai/register?source=github&campaign=superpowers&promo=superpowers&aff=RQHWKAMQLX2S">
|
|
81
|
+
<img src="assets/sponsors/logo-sidrune-ai.png" alt="Sidrune AI —— 一个入口,接入并管理全球主流 AI 模型" width="100%">
|
|
82
82
|
</a>
|
|
83
83
|
</td>
|
|
84
84
|
<td width="75%" valign="middle">
|
|
85
85
|
|
|
86
|
-
感谢 [
|
|
86
|
+
感谢 [Sidrune AI](https://sidrune.ai/register?source=github&campaign=superpowers&promo=superpowers&aff=RQHWKAMQLX2S) 赞助本项目!一个入口,接入并管理全球主流 AI 模型。Sidrune AI 面向个人开发者、技术团队与企业,通过统一 API 接入并管理全球主流 AI 模型;通过多线路动态调度提升可用性,模型表现、响应时间与费用透明可查。根据不同模型与线路,API 调用成本较官方或基准价格可降低 **40%—98%**。🎁 **通过[此链接](https://sidrune.ai/register?source=github&campaign=superpowers&promo=superpowers&aff=RQHWKAMQLX2S)注册即可获得 $3 API 额度!**
|
|
87
87
|
|
|
88
88
|
</td>
|
|
89
89
|
</tr>
|
|
@@ -104,14 +104,14 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
|
|
|
104
104
|
</table>
|
|
105
105
|
<table>
|
|
106
106
|
<tr>
|
|
107
|
-
<td width="25%"
|
|
108
|
-
<a href="https://
|
|
109
|
-
<img src="assets/sponsors/
|
|
107
|
+
<td width="25%">
|
|
108
|
+
<a href="https://www.infistar.cc/register?aff=PDVTM2VS&ref_source=link">
|
|
109
|
+
<img src="assets/sponsors/infistar.jpg" alt="Infistar.cc 无限星河 —— 全模型 API 服务,一个 API Key 接入 Claude、ChatGPT、Gemini、Kimi、GLM、DeepSeek,价格低至官方渠道 1 折" width="100%">
|
|
110
110
|
</a>
|
|
111
111
|
</td>
|
|
112
112
|
<td width="75%" valign="middle">
|
|
113
113
|
|
|
114
|
-
感谢 [
|
|
114
|
+
感谢 [Infistar.cc 无限星河](https://www.infistar.cc/register?aff=PDVTM2VS&ref_source=link) 赞助并为 superpowers-zh 用户提供模型服务支持!无限星河提供高可用模型通道与多节点冗余,一个 API Key 接入 Claude、ChatGPT、Gemini、Kimi、GLM、DeepSeek 等模型,价格低至官方渠道 **1 折**,并适配 Claude Code、Codex、Cursor、Windsurf、Kiro 等 AI 编程工具。🎁 **通过[此链接](https://www.infistar.cc/register?aff=PDVTM2VS&ref_source=link)注册并完成首次调用,即可领取 5 美元等值测试额度!**
|
|
115
115
|
|
|
116
116
|
</td>
|
|
117
117
|
</tr>
|
|
@@ -121,7 +121,7 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
|
|
|
121
121
|
|
|
122
122
|
## 这是什么?
|
|
123
123
|
|
|
124
|
-
[superpowers](https://github.com/obra/superpowers) 是目前最火的 AI 编程 skills 框架(
|
|
124
|
+
[superpowers](https://github.com/obra/superpowers) 是目前最火的 AI 编程 skills 框架(300k+ stars),为 AI 编程工具提供**系统化的工作方法论**。
|
|
125
125
|
|
|
126
126
|
**superpowers-zh** 在完整翻译的基础上,新增了面向中国开发者的特色 skills。
|
|
127
127
|
|
|
@@ -156,7 +156,7 @@ AI:在开始实现之前,我需要了解几个关键问题:
|
|
|
156
156
|
|
|
157
157
|
| 维度 | superpowers(英文上游) | superpowers-zh(中文增强版) |
|
|
158
158
|
|------|----------------------|---------------------------|
|
|
159
|
-
| ⭐ Star 数 |
|
|
159
|
+
| ⭐ Star 数 | 300k+ | — |
|
|
160
160
|
| 📦 Skills 总数 | 15 | **21**(15 翻译 + 4 国产原创 + 2 上游历史保留) |
|
|
161
161
|
| 🌐 语言 | 英文 | 中文(技术术语保留英文) |
|
|
162
162
|
| 🤖 **支持工具** | **6 款**:Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **26 款**:上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code / OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy(腾讯) / CodeArts(华为云码道) / Cline / Kilo Code / Crush / ZCode(智谱)/ DeepSeek Harness / Reasonix |
|
package/README.zh-Hant.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
🌐 [简体中文](README.md) | **繁體中文** | [English (upstream)](https://github.com/obra/superpowers)
|
|
4
4
|
|
|
5
|
-
> 🦸 **superpowers(
|
|
5
|
+
> 🦸 **superpowers(300k+ ⭐)完整漢化 + 4 個中國原創 skills** — 讓 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **26 款 AI 編程工具**真正會幹活。從頭腦風暴到程式碼審查,從 TDD 到除錯,每個 skill 都是經過實戰驗證的工作方法論。
|
|
6
6
|
|
|
7
7
|
Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 21 skills across 26 AI coding tools, including full translations and China-specific development skills.
|
|
8
8
|
|
|
@@ -26,33 +26,33 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
|
|
|
26
26
|
## ❤️ 贊助商 <sub>🙏 想出現在這裡?聯絡 **jnMetaCode@qq.com** 贊助</sub>
|
|
27
27
|
|
|
28
28
|
<p align="center">
|
|
29
|
-
<a href="https://
|
|
30
|
-
<img src="assets/sponsors/
|
|
29
|
+
<a href="https://apinebula.ai/1Axi9F">
|
|
30
|
+
<img src="assets/sponsors/apinebula.png" alt="APINEBULA —— 企業級 AI 聚合平台,一個介面接入 Claude、GPT、Gemini 等全球頂尖模型,價格低至 1 折" width="100%">
|
|
31
31
|
</a>
|
|
32
32
|
</p>
|
|
33
33
|
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
感謝 Infistar.cc 無限星河 贊助並為 superpowers-zh 使用者提供模型服務支援!
|
|
34
|
+
感謝 [APINEBULA](https://apinebula.ai/1Axi9F) 大屏贊助本專案!APINEBULA 是銀河錄像局旗下的企業級 AI 聚合平台,背靠大型平台資源,面向開發者、團隊與企業使用者提供穩定、高性價比的大型模型 API 接入服務。平台聚合 Claude、GPT、Gemini 等主流滿血模型,一個介面接入全球頂尖 AI 大型模型,各大模型價格低至 1 折起,支援企業級高併發、正式合約、對公付款與開票服務,適合 AI 編程、Agent 開發、業務系統整合等多種場景!
|
|
37
35
|
|
|
38
|
-
|
|
39
|
-
- 🧠 **一個 API Key 接入主流模型**:全面支援 Claude、ChatGPT、Gemini、Kimi、GLM、DeepSeek 等模型,適配 Claude Code、Codex、Cursor、Windsurf、Kiro 等 AI 編程工具。
|
|
40
|
-
- 🛠️ **賦能完整開發工作流**:結合 superpowers-zh 的系統化 Skills,讓 AI 更好地完成頭腦風暴、計畫執行、問題排查和品質檢查。
|
|
41
|
-
|
|
42
|
-
🎁 **superpowers-zh 使用者專屬福利:透過[此連結](https://www.infistar.cc/register?aff=PDVTM2VS&ref_source=link)註冊並完成首次呼叫,即可領取 5 美元等值測試額度!**
|
|
36
|
+
🎁 **透過[此連結](https://apinebula.ai/1Axi9F)註冊並在儲值時填寫 `agent` 優惠碼可享 9 折優惠!**
|
|
43
37
|
|
|
44
38
|
<hr>
|
|
45
39
|
|
|
46
40
|
<table>
|
|
47
41
|
<tr>
|
|
48
42
|
<td width="25%">
|
|
49
|
-
<a href="https://
|
|
50
|
-
<img src="assets/sponsors/
|
|
43
|
+
<a href="https://88api.ai/sign-up?aff=MvTX">
|
|
44
|
+
<img src="assets/sponsors/88api.jpg" alt="88API Token 聚合平台 —— 聚合語言、編程、圖片、影片與語音模型的一站式 AI API 平台" width="100%">
|
|
51
45
|
</a>
|
|
52
46
|
</td>
|
|
53
47
|
<td width="75%" valign="middle">
|
|
54
48
|
|
|
55
|
-
|
|
49
|
+
[88API Token 聚合平台](https://88api.ai/sign-up?aff=MvTX)<br>
|
|
50
|
+
🧠 聚合 GPT、Claude、Gemini、Grok、DeepSeek、Kimi、GLM 等語言與編程模型;<br>
|
|
51
|
+
🎨 圖片模型:GPT-Image、Gemini、Grok 等;<br>
|
|
52
|
+
🎬 影片模型:Seedance、Veo、MiniMax H3、Kling、Grok 等;<br>
|
|
53
|
+
🎙️ 語音能力:Whisper、TTS 等。從文案、出圖、改圖,到影片生成與配音<br>
|
|
54
|
+
🎁新使用者註冊即送體驗額度,可以檢測模型能力。站內有人工客服值守!<br>
|
|
55
|
+
👉香港正規企業營運 穩定供應 全綠滿血 不降智 提供發票
|
|
56
56
|
|
|
57
57
|
</td>
|
|
58
58
|
</tr>
|
|
@@ -73,14 +73,14 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
|
|
|
73
73
|
</table>
|
|
74
74
|
<table>
|
|
75
75
|
<tr>
|
|
76
|
-
<td width="25%">
|
|
77
|
-
<a href="https://
|
|
78
|
-
<img src="assets/sponsors/
|
|
76
|
+
<td width="25%" align="center">
|
|
77
|
+
<a href="https://sidrune.ai/register?source=github&campaign=superpowers&promo=superpowers&aff=RQHWKAMQLX2S">
|
|
78
|
+
<img src="assets/sponsors/logo-sidrune-ai.png" alt="Sidrune AI —— 一個入口,接入並管理全球主流 AI 模型" width="100%">
|
|
79
79
|
</a>
|
|
80
80
|
</td>
|
|
81
81
|
<td width="75%" valign="middle">
|
|
82
82
|
|
|
83
|
-
感謝 [
|
|
83
|
+
感謝 [Sidrune AI](https://sidrune.ai/register?source=github&campaign=superpowers&promo=superpowers&aff=RQHWKAMQLX2S) 贊助本專案!一個入口,接入並管理全球主流 AI 模型。Sidrune AI 面向個人開發者、技術團隊與企業,透過統一 API 接入並管理全球主流 AI 模型;透過多線路動態調度提升可用性,模型表現、回應時間與費用透明可查。依不同模型與線路,API 呼叫成本較官方或基準價格可降低 **40%—98%**。🎁 **透過[此連結](https://sidrune.ai/register?source=github&campaign=superpowers&promo=superpowers&aff=RQHWKAMQLX2S)註冊即可獲得 $3 API 額度!**
|
|
84
84
|
|
|
85
85
|
</td>
|
|
86
86
|
</tr>
|
|
@@ -101,14 +101,14 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
|
|
|
101
101
|
</table>
|
|
102
102
|
<table>
|
|
103
103
|
<tr>
|
|
104
|
-
<td width="25%"
|
|
105
|
-
<a href="https://
|
|
106
|
-
<img src="assets/sponsors/
|
|
104
|
+
<td width="25%">
|
|
105
|
+
<a href="https://www.infistar.cc/register?aff=PDVTM2VS&ref_source=link">
|
|
106
|
+
<img src="assets/sponsors/infistar.jpg" alt="Infistar.cc 無限星河 —— 全模型 API 服務,一個 API Key 接入 Claude、ChatGPT、Gemini、Kimi、GLM、DeepSeek,價格低至官方渠道 1 折" width="100%">
|
|
107
107
|
</a>
|
|
108
108
|
</td>
|
|
109
109
|
<td width="75%" valign="middle">
|
|
110
110
|
|
|
111
|
-
感謝 [
|
|
111
|
+
感謝 [Infistar.cc 無限星河](https://www.infistar.cc/register?aff=PDVTM2VS&ref_source=link) 贊助並為 superpowers-zh 使用者提供模型服務支援!無限星河提供高可用模型通道與多節點冗餘,一個 API Key 接入 Claude、ChatGPT、Gemini、Kimi、GLM、DeepSeek 等模型,價格低至官方渠道 **1 折**,並適配 Claude Code、Codex、Cursor、Windsurf、Kiro 等 AI 編程工具。🎁 **透過[此連結](https://www.infistar.cc/register?aff=PDVTM2VS&ref_source=link)註冊並完成首次呼叫,即可領取 5 美元等值測試額度!**
|
|
112
112
|
|
|
113
113
|
</td>
|
|
114
114
|
</tr>
|
|
@@ -118,7 +118,7 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
|
|
|
118
118
|
|
|
119
119
|
## 這是什麼?
|
|
120
120
|
|
|
121
|
-
[superpowers](https://github.com/obra/superpowers) 是目前最火的 AI 編程 skills 框架(
|
|
121
|
+
[superpowers](https://github.com/obra/superpowers) 是目前最火的 AI 編程 skills 框架(300k+ stars),為 AI 編程工具提供**系統化的工作方法論**。
|
|
122
122
|
|
|
123
123
|
**superpowers-zh** 在完整翻譯的基礎上,新增了面向中國開發者的特色 skills。
|
|
124
124
|
|
|
@@ -153,7 +153,7 @@ AI:在開始實作之前,我需要了解幾個關鍵問題:
|
|
|
153
153
|
|
|
154
154
|
| 維度 | superpowers(英文上游) | superpowers-zh(中文增強版) |
|
|
155
155
|
|------|----------------------|---------------------------|
|
|
156
|
-
| ⭐ Star 數 |
|
|
156
|
+
| ⭐ Star 數 | 300k+ | — |
|
|
157
157
|
| 📦 Skills 總數 | 15 | **21**(15 翻譯 + 4 國產原創 + 2 上游歷史保留) |
|
|
158
158
|
| 🌐 語言 | 英文 | 中文(技術術語保留英文) |
|
|
159
159
|
| 🤖 **支援工具** | **6 款**:Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **26 款**:上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code / OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy(騰訊) / CodeArts(華為雲碼道) / Cline / Kilo Code / Crush / ZCode(智譜)/ DeepSeek Harness / Reasonix |
|
package/RELEASE-NOTES.zh.md
CHANGED
|
@@ -6,6 +6,52 @@
|
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
+
## v1.8.0 (2026-10-19)
|
|
10
|
+
|
|
11
|
+
**同步上游 v7.0.0,所有用户建议更新。** brainstorming 按上游从头重写,另有一批 hook、脚本和示例修复。
|
|
12
|
+
|
|
13
|
+
### 🔁 brainstorming 重写:先弄清你想要什么
|
|
14
|
+
|
|
15
|
+
- 先判断"我到底知道多少":要紧的信息都在请求里("把图标改成矢车菊蓝"),就直接做;缺了东西才开始对话
|
|
16
|
+
- 第一条消息只有两件事:告诉你可以跳过提问让它直接开始,以及一个让你开始描述的开放问题
|
|
17
|
+
- 每条消息只问一个问题,先让你描述,只在你卡住时才给选项;你说"你猜一个吧""你觉得呢",它就直接提方案
|
|
18
|
+
- 理解一部分就复述一部分(约 200-300 字),标明哪些是它的猜测,请你纠正
|
|
19
|
+
- 意图清楚后再定规模:快速明确的任务 / 小改动(对话里定)/ 需要书面设计的项目,你可以推翻
|
|
20
|
+
- 书面设计交给你之前,先由一个扮演该领域建造者的子代理检查(builder check),只把必须由你回答的问题一次性带回来;取代原来的 spec 审查(`spec-document-reviewer-prompt.md` 已删除,新增 `builder-check-prompt.md`)
|
|
21
|
+
- 不再限于软件:一场分享、一门生意、一次装修也适用
|
|
22
|
+
- 硬门槛保留:完整描述获批之前不构建;唯一例外是你同意的一次性 spike,要保留它的代码算新需求
|
|
23
|
+
|
|
24
|
+
**本 fork 的补充(上游没有):** 中文里"你看着办""你定吧"是请它拿主意,不是让它跳过提问直接动手。eval 中未加这句说明时,智能体两次把"反正你看着办吧"当成跳过流程、未经批准就开始写代码;补充后复测未再出现。
|
|
25
|
+
|
|
26
|
+
**eval 摘要:** 8 个场景(含非软件、施压、spike、"你看着办"),对比旧中文版、新中文版和上游英文原文,被测模型 claude-opus-5-5。新中文版与英文原文表现一致,都明显优于旧版:旧版普遍先给 A–E 选项菜单、一条消息问多个问题;新版一次一个开放问题并分块复述。受账号额度限制,每组样本为 1–2 次。
|
|
27
|
+
|
|
28
|
+
### 🐛 修复
|
|
29
|
+
|
|
30
|
+
- **SessionStart hook**:Claude Code 以空 PATH 启动 hook 时,不再因找不到 `dirname`/`cat` 而丢失 bootstrap;Windows 上不再误选 WSL 启动器或执行当前目录下的同名程序,hook 退出码不再丢失(同步上游 v7)
|
|
31
|
+
- **executing-plans**:测试成功但没有输出时,`task-done` 也会记账(此前返回 1 且不记账)
|
|
32
|
+
- **subagent-driven-development**:`sdd-workspace` 不再覆盖你自己的 `.superpowers/sdd/.gitignore`;Windows Git Bash 下计划标记改为仓库相对路径
|
|
33
|
+
- **视觉伴侣**:内容里的 `$&`、`$'` 等不再被当作替换模式篡改
|
|
34
|
+
- **带参数调用 skill**:Claude Code 会把正文里的 `$1` 等替换成参数。requesting-code-review 的 BASE_SHA 示例(同步上游),以及本 fork 的 chinese-code-review(参数化查询示例)、chinese-commit-conventions(husky 命令)都已改写;CI 新增检查防止再出现
|
|
35
|
+
- **systematic-debugging**:诊断示例只报告变量是否设置,不再把凭据值打印到日志
|
|
36
|
+
- **OpenCode 文档**:「固定到特定版本」示例此前写 `#v1.7.13`,这个 tag 不存在,照抄会安装失败;已改为 `#v1.7.14`,audit 会检查文档引用的 tag 是否存在
|
|
37
|
+
- **发版脚本**:`npm version` 同步了 `.kimi-plugin/plugin.json` 的版本号,但没把它加入提交
|
|
38
|
+
|
|
39
|
+
### 🌐 官网
|
|
40
|
+
|
|
41
|
+
- 繁体界面的分类标签与简介修正;skill 数、工具数、中国原创数改为构建时自动生成
|
|
42
|
+
- 404 页的样式此前被 CSP 拦截而错位,已修复,并加上英文与繁体提示
|
|
43
|
+
- 首页发布提示条此前一直显示 v1.7.12 的内容,已更正,并改为发版时必须同步更新(否则构建失败)
|
|
44
|
+
- FAQ 补充:各安装方式(npx 项目级 / 全局 / Claude Code 插件市场)的更新与卸载、装完怎么确认生效、没生效怎么排查
|
|
45
|
+
- skill 详情页:`<HARD-GATE>` 等标签块此前结构错误(结束标签落进段落,后面整页被嵌进去),现在显示为带标签名的提示框,`<Good>`/`<Bad>` 正反例分别标绿、标红
|
|
46
|
+
- 浅色主题:代码块文字此前几乎看不见(对比度 1.33:1),链接、行内代码、标签、页脚文字也偏淡,已全部调到 4.5:1 以上
|
|
47
|
+
- 手机端:此前 320px 宽度下 16 个页面需要横向滑动,现在全部 70 个页面都不会
|
|
48
|
+
|
|
49
|
+
### 📦 包体积
|
|
50
|
+
|
|
51
|
+
删除 5 张已无引用的赞助商图片,Sidrune 横幅从 924 KB 压到 19 KB(显示效果不变)。
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
9
55
|
## v1.7.14 (2026-09-26)
|
|
10
56
|
|
|
11
57
|
**同步上游 v6.4.2(含 v6.4.1),OpenCode 用户尤其建议更新。** 对应 [#133](https://github.com/jnMetaCode/superpowers-zh/issues/133)、[#131](https://github.com/jnMetaCode/superpowers-zh/issues/131)。
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/docs/README.opencode.md
CHANGED
|
@@ -100,7 +100,7 @@ OpenCode 通过一个基于 git 的包说明(package spec)安装 Superpowers
|
|
|
100
100
|
|
|
101
101
|
```json
|
|
102
102
|
{
|
|
103
|
-
"plugin": ["superpowers@git+https://github.com/jnMetaCode/superpowers-zh.git#v1.7.
|
|
103
|
+
"plugin": ["superpowers@git+https://github.com/jnMetaCode/superpowers-zh.git#v1.7.14"]
|
|
104
104
|
}
|
|
105
105
|
```
|
|
106
106
|
|
package/gemini-extension.json
CHANGED
package/hooks/run-hook.cmd
CHANGED
|
@@ -15,32 +15,48 @@ if "%~1"=="" (
|
|
|
15
15
|
exit /b 1
|
|
16
16
|
)
|
|
17
17
|
|
|
18
|
+
setlocal
|
|
18
19
|
set "HOOK_DIR=%~dp0"
|
|
20
|
+
set "BASH_EXE="
|
|
19
21
|
|
|
20
|
-
REM
|
|
21
|
-
if exist "C:\Program Files\Git\bin\bash.exe"
|
|
22
|
-
|
|
23
|
-
exit /b %ERRORLEVEL%
|
|
24
|
-
)
|
|
25
|
-
if exist "C:\Program Files (x86)\Git\bin\bash.exe" (
|
|
26
|
-
"C:\Program Files (x86)\Git\bin\bash.exe" "%HOOK_DIR%%~1" %2 %3 %4 %5 %6 %7 %8 %9
|
|
27
|
-
exit /b %ERRORLEVEL%
|
|
28
|
-
)
|
|
22
|
+
REM Git for Windows in its standard system-wide locations
|
|
23
|
+
if exist "C:\Program Files\Git\bin\bash.exe" set "BASH_EXE=C:\Program Files\Git\bin\bash.exe"
|
|
24
|
+
if not defined BASH_EXE if exist "C:\Program Files (x86)\Git\bin\bash.exe" set "BASH_EXE=C:\Program Files (x86)\Git\bin\bash.exe"
|
|
29
25
|
|
|
30
|
-
REM
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
)
|
|
26
|
+
REM Per-user Git for Windows install (no admin rights needed). The defined
|
|
27
|
+
REM check matters: with LOCALAPPDATA unset the path would collapse to
|
|
28
|
+
REM \Programs\Git\... on the current drive, where any user can create it.
|
|
29
|
+
if not defined BASH_EXE if defined LOCALAPPDATA if exist "%LOCALAPPDATA%\Programs\Git\bin\bash.exe" set "BASH_EXE=%LOCALAPPDATA%\Programs\Git\bin\bash.exe"
|
|
30
|
+
|
|
31
|
+
REM bash on PATH (MSYS2, Cygwin, a non-default Git install). where.exe is
|
|
32
|
+
REM called by full path and with $PATH: so neither it nor bash can come from
|
|
33
|
+
REM the current directory. The filters use for-variable modifiers, which never
|
|
34
|
+
REM re-expand the path, and skip extensionless matches and the WSL launchers
|
|
35
|
+
REM (System32, Sysnative, the Store alias in WindowsApps), which fail when no
|
|
36
|
+
REM Linux distro is installed.
|
|
37
|
+
if not defined BASH_EXE if defined SystemRoot for /f "delims=" %%B in ('"%SystemRoot%\System32\where.exe" $PATH:bash 2^>nul') do if not defined BASH_EXE if not "%%~xB"=="" if /i not "%%~dpB"=="%SystemRoot%\System32\" if /i not "%%~dpB"=="%SystemRoot%\Sysnative\" if /i not "%%~dpB"=="%LOCALAPPDATA%\Microsoft\WindowsApps\" set "BASH_EXE=%%B"
|
|
36
38
|
|
|
37
39
|
REM No bash found - exit silently rather than error
|
|
38
40
|
REM (plugin still works, just without SessionStart context injection)
|
|
39
|
-
exit /b 0
|
|
41
|
+
if not defined BASH_EXE exit /b 0
|
|
42
|
+
|
|
43
|
+
REM Run bash outside any parenthesized block: cmd expands %ERRORLEVEL%
|
|
44
|
+
REM inside a block when it parses the block, which would lose the hook's
|
|
45
|
+
REM exit code.
|
|
46
|
+
"%BASH_EXE%" "%HOOK_DIR%%~1" %2 %3 %4 %5 %6 %7 %8 %9
|
|
47
|
+
exit /b %ERRORLEVEL%
|
|
40
48
|
CMDBLOCK
|
|
41
49
|
|
|
42
50
|
# Unix: run the named script directly
|
|
43
|
-
|
|
51
|
+
# Splits $0 on its last / or \ (cmd passes Windows paths) instead of calling
|
|
52
|
+
# dirname, and uses $BASH (bash's own absolute path, always set once bash is
|
|
53
|
+
# running) instead of a PATH lookup for bash, so this keeps working when
|
|
54
|
+
# Claude Code spawns the SessionStart hook with a broken/empty PATH
|
|
55
|
+
# (anthropics/claude-code#43127).
|
|
56
|
+
case "$0" in
|
|
57
|
+
*/*|*\\*) SCRIPT_DIR="$(cd "${0%[/\\]*}" && pwd)" ;;
|
|
58
|
+
*) SCRIPT_DIR="$(pwd)" ;;
|
|
59
|
+
esac
|
|
44
60
|
SCRIPT_NAME="$1"
|
|
45
61
|
shift
|
|
46
|
-
exec bash "${SCRIPT_DIR}/${SCRIPT_NAME}" "$@"
|
|
62
|
+
exec "${BASH:-bash}" "${SCRIPT_DIR}/${SCRIPT_NAME}" "$@"
|
package/hooks/session-start
CHANGED
|
@@ -3,12 +3,26 @@
|
|
|
3
3
|
|
|
4
4
|
set -euo pipefail
|
|
5
5
|
|
|
6
|
-
# Determine plugin root directory
|
|
7
|
-
|
|
6
|
+
# Determine plugin root directory.
|
|
7
|
+
# Splits $0 on its last / or \ (run-hook.cmd's cmd half passes a Windows
|
|
8
|
+
# path), with no separator meaning the current directory. This avoids
|
|
9
|
+
# dirname because a SessionStart:startup hook can run with a broken/empty
|
|
10
|
+
# PATH (anthropics/claude-code#43127) before any PATH-repairing sibling hook
|
|
11
|
+
# in the same startup batch takes effect.
|
|
12
|
+
case "$0" in
|
|
13
|
+
*/*|*\\*) SCRIPT_DIR="$(cd "${0%[/\\]*}" && pwd)" ;;
|
|
14
|
+
*) SCRIPT_DIR="$(pwd)" ;;
|
|
15
|
+
esac
|
|
8
16
|
PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
|
|
9
17
|
|
|
10
|
-
# Read using-superpowers content
|
|
11
|
-
|
|
18
|
+
# Read using-superpowers content via bash's builtin $(< file) instead of
|
|
19
|
+
# cat, for the same PATH-independence reason.
|
|
20
|
+
skill_md="${PLUGIN_ROOT}/skills/using-superpowers/SKILL.md"
|
|
21
|
+
if [ -r "$skill_md" ]; then
|
|
22
|
+
using_superpowers_content="$(<"$skill_md")"
|
|
23
|
+
else
|
|
24
|
+
using_superpowers_content="Error reading using-superpowers skill"
|
|
25
|
+
fi
|
|
12
26
|
|
|
13
27
|
# Escape string for JSON embedding using bash parameter substitution.
|
|
14
28
|
# Each ${s//old/new} is a single C-level pass - orders of magnitude
|
|
@@ -36,18 +50,36 @@ session_context="<EXTREMELY_IMPORTANT>\nYou have superpowers.\n\n**Below is the
|
|
|
36
50
|
#
|
|
37
51
|
# Uses printf instead of heredoc to work around bash 5.3+ heredoc hang.
|
|
38
52
|
# See: https://github.com/obra/superpowers/issues/571
|
|
53
|
+
#
|
|
54
|
+
# emit_json pipes printf through `cat` when cat is on PATH, to absorb EPIPE
|
|
55
|
+
# on Windows. On Windows + Git Bash, the harness can close the hook's stdout
|
|
56
|
+
# before printf finishes, and Git Bash's printf reports that EPIPE as
|
|
57
|
+
# "printf: write error: Permission denied", which `set -euo pipefail` lets
|
|
58
|
+
# escape as a startup diagnostic every session. Letting cat receive the EPIPE
|
|
59
|
+
# keeps it out of the hook's error path (#1612). When PATH is broken and cat
|
|
60
|
+
# can't be found (#2310), it falls back to printf alone so context still
|
|
61
|
+
# gets injected.
|
|
62
|
+
emit_json() {
|
|
63
|
+
# shellcheck disable=SC2059 # every caller passes a literal format string
|
|
64
|
+
if command -v cat >/dev/null 2>&1; then
|
|
65
|
+
printf "$@" | cat
|
|
66
|
+
else
|
|
67
|
+
printf "$@"
|
|
68
|
+
fi
|
|
69
|
+
}
|
|
70
|
+
|
|
39
71
|
if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
|
|
40
72
|
# Cursor sets CURSOR_PLUGIN_ROOT (may also set CLAUDE_PLUGIN_ROOT)
|
|
41
|
-
|
|
73
|
+
emit_json '{\n "additional_context": "%s"\n}\n' "$session_context"
|
|
42
74
|
elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -z "${COPILOT_CLI:-}" ] && [ -z "${MUSE_PLUGIN_ROOT:-}" ]; then
|
|
43
75
|
# Claude Code sets CLAUDE_PLUGIN_ROOT without COPILOT_CLI/MUSE_PLUGIN_ROOT
|
|
44
|
-
|
|
76
|
+
emit_json '{\n "hookSpecificOutput": {\n "hookEventName": "SessionStart",\n "additionalContext": "%s"\n }\n}\n' "$session_context"
|
|
45
77
|
elif [ -n "${MUSE_PLUGIN_ROOT:-}" ]; then
|
|
46
78
|
# Muse sets MUSE_PLUGIN_ROOT — try Claude-style nested output for Muse Spark
|
|
47
|
-
|
|
79
|
+
emit_json '{\n "hookSpecificOutput": {\n "hookEventName": "SessionStart",\n "additionalContext": "%s"\n }\n}\n' "$session_context"
|
|
48
80
|
else
|
|
49
81
|
# Copilot CLI (sets COPILOT_CLI=1) or unknown platform — SDK standard format
|
|
50
|
-
|
|
82
|
+
emit_json '{\n "additionalContext": "%s"\n}\n' "$session_context"
|
|
51
83
|
fi
|
|
52
84
|
|
|
53
85
|
exit 0
|
package/package.json
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "superpowers-zh",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.8.0",
|
|
4
4
|
"engines": {
|
|
5
5
|
"node": ">=20.0.0"
|
|
6
6
|
},
|
|
7
|
-
"description": "AI 编程超能力中文增强版 — superpowers(
|
|
7
|
+
"description": "AI 编程超能力中文增强版 — superpowers(300k+ ⭐)完整汉化 + 4 个中国原创 skills,支持 Claude Code / Copilot CLI / Hermes Agent / Cursor / Claw Code / Windsurf / Kiro / Gemini CLI / Qoder 等 26 款工具",
|
|
8
8
|
"type": "module",
|
|
9
9
|
"main": ".opencode/plugins/superpowers.js",
|
|
10
10
|
"bin": {
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
"scripts": {
|
|
14
14
|
"site": "node site/build.mjs",
|
|
15
15
|
"site:deploy": "node site/build.mjs && wrangler pages deploy site/dist --project-name=superpowers-zh-site",
|
|
16
|
-
"version": "node scripts/sync-plugin-version.js && git add .claude-plugin/plugin.json .claude-plugin/marketplace.json .cursor-plugin/plugin.json .codex-plugin/plugin.json gemini-extension.json"
|
|
16
|
+
"version": "node scripts/sync-plugin-version.js && git add .claude-plugin/plugin.json .claude-plugin/marketplace.json .cursor-plugin/plugin.json .codex-plugin/plugin.json .kimi-plugin/plugin.json gemini-extension.json"
|
|
17
17
|
},
|
|
18
18
|
"files": [
|
|
19
19
|
"bin/",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: brainstorming
|
|
3
|
-
description: "
|
|
3
|
+
description: "在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能、修改行为,或筹划任何新东西,无论是软件还是软件之外(一场分享、一门生意、一次装修)。"
|
|
4
4
|
version: "1.0.0"
|
|
5
5
|
license: MIT
|
|
6
6
|
metadata:
|
|
@@ -8,221 +8,135 @@ metadata:
|
|
|
8
8
|
tags: [design, planning]
|
|
9
9
|
---
|
|
10
10
|
|
|
11
|
-
#
|
|
11
|
+
# 头脑风暴
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
你非常擅长构建。你会去构建你认为你的人类伙伴想要的东西,而这个"认为"通常比你感觉到的要单薄。这个技能的用途,是在动手构建任何东西之前,弄清他们真正想要什么、以及为什么。
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
人们常常还没想清楚自己想要什么。好的问题能帮他们把它想透。当你理解了背后的原因,那上百个他们从没提过的决定,你就会按他们自己会做的方式去做。
|
|
16
16
|
|
|
17
|
-
##
|
|
17
|
+
## 首先:你到底知道多少?
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
回复之前,先问自己:关于他们想要什么、为什么想要,我知道些什么?
|
|
20
20
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
3. **把意图带进设计。** 在所选路径的设计产出物里保留这份达成一致的理解:架构级工作是书面规格,有界工作和探路是对话里的设计或试探方案。拿这份理解去核对提出的每个功能和技术选择。
|
|
21
|
+
- **要紧的信息都在请求里了**("把图标改成矢车菊蓝")。这是一个快速、明确的任务。直接做,并说明你做了什么。
|
|
22
|
+
- **缺了某些不简单的东西。** 开始对话。
|
|
24
23
|
|
|
25
|
-
|
|
24
|
+
## 你的第一条消息
|
|
26
25
|
|
|
27
|
-
|
|
28
|
-
在采取任何实现行动之前——包括调用实现技能、编写产品代码、搭建脚手架、安装产品依赖、创建外部项目——先完成所选路径的前置条件:
|
|
26
|
+
你的第一条消息包含两件事,按这个顺序:
|
|
29
27
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
- 架构级:你的人类伙伴审阅并批准了书面规格,然后审阅书面实现计划并选定执行方式。对话中对设计的批准只允许你去写规格;对书面规格的批准只允许你去调用 writing-plans。
|
|
28
|
+
1. 一句话告诉他们:如果他们宁愿跳过提问、让你直接开始,可以直说。如果他们明确接受了这个提议,这个技能就结束了:用一句平实的话说明任何重要的"怎么做出来"的选择(平台、语言、媒介),然后按正常工作流去做他们要求的事。
|
|
29
|
+
2. 一个让他们开始描述的开放式问题。问一个真实的时刻或一个具体的画面:"你是在什么时候,会希望要是有这个东西就好了?"或者"跟我说说到时候在场的都是些什么人。"
|
|
33
30
|
|
|
34
|
-
|
|
35
|
-
|
|
31
|
+
整条消息就这些。
|
|
32
|
+
|
|
33
|
+
## 对话
|
|
34
|
+
|
|
35
|
+
每条消息都以一个问题结尾:只有一句话,后面不挂一串示例答案。用平实的语言,比你的人类伙伴当前的水平稍高一点点。贴合他们的用词;永远不要用流程术语。
|
|
36
|
+
|
|
37
|
+
清楚、简洁。先说要紧的。避免行话。汇报你发现的东西时,给他们最重要的发现,其余的问他们要不要看。
|
|
38
|
+
|
|
39
|
+
**让他们先描述。** 开放式问题优先。他们自己的话里带着意图,你给的选项承载不了这些。只有在他们卡住时,才给一份简短的选项。当他们说"你猜一个吧"、"你觉得呢?"或"你看着办吧",就提出一个具体的方案。在中文里,"你看着办""你定吧"是请你拿主意,不是让你跳过提问直接动手:提出方案,然后照常推进,完整描述获批之前不构建。
|
|
40
|
+
|
|
41
|
+
**怎么做出来。** 每个项目都建立在关于媒介、工具、材料和资源的选择之上:一个应用的平台、编程语言和库;一件艺术作品的媒介。尽早弄清:这些选择里哪些他们想自己定,哪些交给你,以及他们手头已经有什么可用。有明确想法或相关技能的人,会想好好聊一聊。指望你来定的人,需要合理的默认选择,并用平实的话说出来。已经有现成成果时,就沿用它已经在用的东西。你自己做的任何选择,都要在设计里写成你的决定,绝不写成他们同意过的东西。
|
|
42
|
+
|
|
43
|
+
**要覆盖的范围。** 这是一片要走遍的区域,不是一份台词。永远不要把这些当成问题念出来:
|
|
44
|
+
|
|
45
|
+
- 这是个什么东西,它特别在哪里
|
|
46
|
+
- 为什么是现在,以及在他们看来怎样才算成功
|
|
47
|
+
- 目标、非目标和反目标(哪怕技术上能用,也会让这件事算失败的东西)
|
|
48
|
+
- 先例:他们在别处见过的、喜欢的或讨厌的
|
|
49
|
+
- 现状:现在有什么,他们已经试过什么
|
|
50
|
+
- 他们在意的细节
|
|
51
|
+
|
|
52
|
+
**管用的问题**都锚定在具体事情上:"带我走一遍上一次……的经过"、"如果它只能把其中一件事做好,你选哪件?"、"要是我做错了什么会让你皱眉?"一个可以被纠正的猜测("我猜这是因为 X 老是坑你?")往往比一个问题更好。
|
|
53
|
+
|
|
54
|
+
**主动提出去侦察。** 一旦有了一点基础、而去看一看会有帮助,就提出去看:他们的代码库或项目、他们自己的文件和数据,或者网上。说明你打算找什么。去不去由他们决定。
|
|
55
|
+
|
|
56
|
+
**私下里想宽一点。** 在提出任何方案之前,先想出好几个点子,再丢掉弱的,包括任何和他们讲过的"为什么"相冲突的。只有在对比能帮他们做决定时,才把对比拿出来给他们看。
|
|
57
|
+
|
|
58
|
+
**展示,而不是讲述。** 只要"看到"比"读到"更有帮助,就提出使用视觉伴侣(见下文):
|
|
59
|
+
|
|
60
|
+
- 他们会去看的东西:一个屏幕、一个页面、一份打印件、一块标牌
|
|
61
|
+
- 一种布局或排布:一个屏幕的、一个房间的、一份日程的
|
|
62
|
+
- 一个流程或一串步骤
|
|
63
|
+
- 看起来会彼此不同的几个选项
|
|
64
|
+
- 看比读更容易理解的结构:一张示意图、一条时间线、一张地图
|
|
65
|
+
|
|
66
|
+
一旦他们接受,就用它来展示供他们反应的原型、并排的选项,以及他们可以点一点的一次性原型。
|
|
67
|
+
|
|
68
|
+
**用 spike 摸一摸。** 智能体做事是瀑布式的,只不过非常、非常快。一个快速的一次性构建,往往是弄清他们想要什么、或者某样东西行不行得通的最便宜的办法。在有帮助时就提出来。当他们就是想做个 spike,就别挡路。spike 不写测试或只写最少的测试,不追求万无一失,并且跳过计划、实现和审查流程。把 spike 让你学到的东西带回对话里。
|
|
69
|
+
|
|
70
|
+
## 复述给对方
|
|
36
71
|
|
|
37
|
-
|
|
72
|
+
边聊边复述。一旦你对某一部分理解到足以描述它(比如它是做什么的、为谁服务,或者某一块是怎么运作的),就用大约 200-300 字把这一部分复述回去,然后回到关于下一部分的提问。复述和提问在整场对话里交替进行;最后一段复述覆盖剩下的所有内容。
|
|
38
73
|
|
|
39
|
-
|
|
74
|
+
你猜的东西要标明是你的猜测;只有他们说过的话才算作他们的。每段复述都以询问"哪里不对或漏了什么"结尾。
|
|
40
75
|
|
|
41
|
-
|
|
42
|
-
- **有界(Bounded)** — 对**本仓库里已经存在的代码**做范围明确的改动:加一个开关、一个小接口、改一个文件的 bug。"知道这是个什么类型的应用"不算数——有界意味着**你要改的那条流程此刻就在仓库里、可以读**。如果没有现成的流程可改,这个任务就不是有界的。问那些真正重要的澄清问题,**在对话里**给出一份简短设计(几句话到几个短段落),然后**停下**。只有在你的人类伙伴对这份设计说"可以"之后,实现才开始——有界任务的批准和架构级任务的批准是同样硬的关卡。不写规格文件,不写实现计划文档。
|
|
43
|
-
- **架构级(Architectural)** — 新项目、新子系统,以及会重构组件之间关系、或改动他人依赖的接口的改动。走完整流程:提问、方案对比、分节设计、书面规格,然后交给 writing-plans 技能。
|
|
76
|
+
发出一段复述之前,先检查:它描述的是不是他们会去看的东西,比如一个页面、一个屏幕、一份日程或一份打印件?如果是,而他们还没收到过视觉伴侣的提议,就改为发送这个提议(作为单独一条消息,见下文),把这段复述留到下一条消息。一旦他们接受了,就在描述旁边放上原型。
|
|
44
77
|
|
|
45
|
-
|
|
78
|
+
## 判断工作规模
|
|
46
79
|
|
|
47
|
-
|
|
80
|
+
一旦你理解了他们想要什么,选定一个规模,并用平实的话说出来。他们可以推翻你的判断。
|
|
48
81
|
|
|
49
|
-
|
|
82
|
+
| 规模 | 完整描述 | 然后 |
|
|
83
|
+
|------|----------|------|
|
|
84
|
+
| 一个快速、明确的任务 | 请求本身 | 直接做 |
|
|
85
|
+
| 一个小改动 | 在对话里 | 走正常工作流去构建 |
|
|
86
|
+
| 一个需要书面设计的项目 | 一份书面设计文档 | 一份完整计划(软件项目:writing-plans) |
|
|
87
|
+
|
|
88
|
+
如果做到一半它变大了,停下来,说明情况,把规模升一级。
|
|
89
|
+
|
|
90
|
+
如果这其实是几个独立的项目,就直说,商定一个顺序,然后一个一个地做头脑风暴。
|
|
91
|
+
|
|
92
|
+
## 书面设计
|
|
93
|
+
|
|
94
|
+
对一个项目,写一份平实的文档,让这个领域里一位有才干的建造者,不用回头去问你的人类伙伴,就能据此做出计划。涵盖:
|
|
95
|
+
|
|
96
|
+
- 意图和背后的原因
|
|
97
|
+
- 目标、非目标、反目标
|
|
98
|
+
- 约束
|
|
99
|
+
- "怎么做"里他们自己定下的部分,照他们定下的样子写
|
|
100
|
+
- 留给建造者决定的部分
|
|
101
|
+
|
|
102
|
+
**放在哪里:** 在软件仓库里,放到 `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md` 并 commit。其他情况,问一下。你的人类伙伴的偏好优先于这两种默认。
|
|
103
|
+
|
|
104
|
+
**建造者检查(builder check):** 用本目录下的 `builder-check-prompt.md` 派发一个全新的子代理。告诉你的人类伙伴你要开始整理文档时,说明会先有一位审阅者读一遍,你可能会带着几个问题回来一次。检查结果回来之前,不要把文档交给他们。把建造者提出的问题分成三堆:
|
|
105
|
+
|
|
106
|
+
- **已经有答案的**:对话或项目里已经回答了。把答案写进文档。
|
|
107
|
+
- **次要的**:一个明智的建造者可以自行定夺,且不会改变要构建的东西。你自己定下来,并在文档里标注这是你的决定。
|
|
108
|
+
- **他们的**:只有你的人类伙伴能回答,而且答案会改变要构建的东西。
|
|
109
|
+
|
|
110
|
+
把"他们的"那一堆放在一条消息里带过去,最重要的放前面。用他们的回答更新文档,然后交给他们,附上一份你自己做了哪些决定的简短清单,方便他们阅读时核对。检查只会产生这一轮提问。如果没有子代理工具,就自己以那位建造者的身份读一遍文档。
|
|
111
|
+
|
|
112
|
+
<HARD-GATE>
|
|
113
|
+
在你的人类伙伴批准完整描述之前,什么都不构建:小改动在对话里批准,项目批准的是文档。构建包括编写产品代码、搭建脚手架、安装依赖、创建项目,以及调用实现类技能。阅读和探索没问题。
|
|
114
|
+
|
|
115
|
+
两个例外。如果他们选择了跳过提问,这个技能就结束了,这道关卡也随之结束。一个他们同意过的 spike 可以去构建;它始终标注为一次性的,而要保留它的产出是一个新的需求,要重新走这道关卡。
|
|
116
|
+
|
|
117
|
+
一个项目的文档获批之后,下一步是计划。软件项目:调用 writing-plans,不调用任何其他技能。
|
|
118
|
+
</HARD-GATE>
|
|
50
119
|
|
|
51
120
|
## 危险信号
|
|
52
121
|
|
|
53
122
|
| 心里的想法 | 实际情况 |
|
|
54
123
|
|---------|---------|
|
|
55
|
-
| "
|
|
56
|
-
| "
|
|
57
|
-
| "
|
|
58
|
-
| "
|
|
59
|
-
| "
|
|
60
|
-
| "范围是变大了,但我快做完了,不用重新分类" | 隐藏的复杂度会在任务中途升级路径。停下来,说明情况。 |
|
|
61
|
-
| "他们批准了探路,那后续改动也算批准了" | 每个任务有自己的分类,也有自己的批准。 |
|
|
62
|
-
|
|
63
|
-
## 检查清单
|
|
64
|
-
|
|
65
|
-
先分类,宣布路径,然后为你所在路径上的每个条目创建任务,并按顺序完成。
|
|
66
|
-
|
|
67
|
-
**探路(Spike):**
|
|
68
|
-
1. **探索项目上下文** — 够用来框定这次试探即可
|
|
69
|
-
2. **展示问题 + 试探计划** — 2-3 句话
|
|
70
|
-
3. **获得批准** — 一个点头就够
|
|
71
|
-
4. **动手调查** — 用不牺牲正确性的最低成本
|
|
72
|
-
5. **汇报发现** — 以建议的形式;搭出来的任何东西都标注为一次性的
|
|
73
|
-
|
|
74
|
-
**有界(Bounded):**
|
|
75
|
-
1. **探索项目上下文** — 检查文件、文档、最近的 commit
|
|
76
|
-
2. **提出澄清问题** — 每次一个,只问那些真正重要的
|
|
77
|
-
3. **在对话里展示简短设计** — 思路、会动哪些文件、怎么测
|
|
78
|
-
4. **获得批准** — **停下**并等待一个明确的"可以";展示完设计顺口就开工,等于跳过了关卡
|
|
79
|
-
5. **实现** — 走正常的开发工作流(TDD 同样适用);不写计划文档
|
|
80
|
-
|
|
81
|
-
**架构级(Architectural):**
|
|
82
|
-
1. **探索项目上下文** — 检查文件、文档、最近的 commit
|
|
83
|
-
2. **在需要时才提供视觉伴侣** — **不要一上来就提**。第一次遇到"这个问题画出来比说出来更清楚"时,才在那一刻提供(作为独立的一条消息);对方同意后,浏览器标签页会为你打开。如果自始至终没出现视觉问题,就永远不要提。参见下方"视觉伴侣"部分。
|
|
84
|
-
3. **提出澄清问题** — 每次一个,了解目的/约束/成功标准
|
|
85
|
-
4. **提出 2-3 种方案** — 附带权衡分析和你的推荐
|
|
86
|
-
5. **展示设计** — 按复杂度分节展示,每节展示后获得用户批准
|
|
87
|
-
6. **编写设计文档** — 保存到 `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md` 并 commit
|
|
88
|
-
7. **规格自检** — 快速内联检查占位符、矛盾、模糊性、范围(详见下方)
|
|
89
|
-
8. **用户审查书面规格** — 在继续之前请用户审查规格文件
|
|
90
|
-
9. **过渡到实现** — 调用 writing-plans 技能创建实现计划
|
|
91
|
-
|
|
92
|
-
## 流程图
|
|
93
|
-
|
|
94
|
-
```dot
|
|
95
|
-
digraph brainstorming {
|
|
96
|
-
"分类:探路 / 有界 / 架构级" [shape=diamond];
|
|
97
|
-
"展示问题 + 试探计划(2-3 句)" [shape=box];
|
|
98
|
-
"提出澄清问题(有界)" [shape=box];
|
|
99
|
-
"在对话里展示简短设计" [shape=box];
|
|
100
|
-
"人类伙伴批准?" [shape=diamond];
|
|
101
|
-
"动手调查;汇报建议" [shape=doublecircle];
|
|
102
|
-
"走正常工作流实现(无计划文档)" [shape=doublecircle];
|
|
103
|
-
"探索项目上下文" [shape=box];
|
|
104
|
-
"提出澄清问题" [shape=box];
|
|
105
|
-
"提出 2-3 种方案" [shape=box];
|
|
106
|
-
"分节展示设计" [shape=box];
|
|
107
|
-
"用户批准设计?" [shape=diamond];
|
|
108
|
-
"编写设计文档" [shape=box];
|
|
109
|
-
"规格自检\n(内联修复)" [shape=box];
|
|
110
|
-
"用户审查规格?" [shape=diamond];
|
|
111
|
-
"调用 writing-plans 技能" [shape=doublecircle];
|
|
112
|
-
"发现隐藏复杂度? 升级路径" [shape=box];
|
|
113
|
-
|
|
114
|
-
"分类:探路 / 有界 / 架构级" -> "展示问题 + 试探计划(2-3 句)" [label="探路"];
|
|
115
|
-
"分类:探路 / 有界 / 架构级" -> "提出澄清问题(有界)" [label="有界"];
|
|
116
|
-
"分类:探路 / 有界 / 架构级" -> "探索项目上下文" [label="架构级"];
|
|
117
|
-
"展示问题 + 试探计划(2-3 句)" -> "人类伙伴批准?";
|
|
118
|
-
"提出澄清问题(有界)" -> "在对话里展示简短设计";
|
|
119
|
-
"在对话里展示简短设计" -> "人类伙伴批准?";
|
|
120
|
-
"人类伙伴批准?" -> "动手调查;汇报建议" [label="探路:是"];
|
|
121
|
-
"人类伙伴批准?" -> "走正常工作流实现(无计划文档)" [label="有界:是"];
|
|
122
|
-
"发现隐藏复杂度? 升级路径" -> "分类:探路 / 有界 / 架构级";
|
|
123
|
-
"探索项目上下文" -> "提出澄清问题";
|
|
124
|
-
"提出澄清问题" -> "提出 2-3 种方案";
|
|
125
|
-
"提出 2-3 种方案" -> "分节展示设计";
|
|
126
|
-
"分节展示设计" -> "用户批准设计?";
|
|
127
|
-
"用户批准设计?" -> "分节展示设计" [label="否,修改"];
|
|
128
|
-
"用户批准设计?" -> "编写设计文档" [label="是"];
|
|
129
|
-
"编写设计文档" -> "规格自检\n(内联修复)";
|
|
130
|
-
"规格自检\n(内联修复)" -> "用户审查规格?";
|
|
131
|
-
"用户审查规格?" -> "编写设计文档" [label="要求修改"];
|
|
132
|
-
"用户审查规格?" -> "调用 writing-plans 技能" [label="批准"];
|
|
133
|
-
}
|
|
134
|
-
```
|
|
135
|
-
|
|
136
|
-
**终止状态跟着路径走。** 架构级:头脑风暴之后你唯一要调用的技能是 writing-plans——绝不调用 frontend-design、mcp-builder 或任何其他实现技能。有界:获得批准之后,直接走正常的开发工作流去实现,不写计划文档。探路:终止状态是一份汇报出去的建议。
|
|
137
|
-
|
|
138
|
-
## 流程详述
|
|
139
|
-
|
|
140
|
-
下面这些小节服务于**有界**和**架构级**两条路径(探路在"展示试探计划、拿到点头"就停了)。从**探索方案**往后都是架构级路径的深度——对有界的工作来说,上下文加几个问题再加一份对话里的简短设计,就是全部流程。
|
|
141
|
-
|
|
142
|
-
**理解想法:**
|
|
143
|
-
|
|
144
|
-
- 首先查看当前项目状态(文件、文档、最近的 commit)
|
|
145
|
-
- 在提出详细问题之前,先评估范围:如果需求描述了多个独立子系统(例如"构建一个包含聊天、文件存储、计费和分析的平台"),立即指出这一点。不要花时间用问题去细化一个需要先拆分的项目。
|
|
146
|
-
- 如果项目规模过大,单个规格说明无法覆盖,帮助用户分解为子项目:有哪些独立的部分,它们之间有什么关系,应该按什么顺序构建?然后通过正常的设计流程进行第一个子项目的头脑风暴。每个子项目都有自己的规格 → 计划 → 实现周期。
|
|
147
|
-
- 对于范围适当的项目,每次提一个问题来完善想法
|
|
148
|
-
- 尽量使用选择题,开放式问题也可以
|
|
149
|
-
- 每条消息只提一个问题——如果一个主题需要更多探索,拆分成多个问题
|
|
150
|
-
- 重点理解:目的、约束、成功标准
|
|
151
|
-
|
|
152
|
-
**探索方案:**
|
|
153
|
-
|
|
154
|
-
- 提出 2-3 种不同的方案及其权衡
|
|
155
|
-
- 以对话的方式展示选项,附上你的推荐和理由
|
|
156
|
-
- 先展示你推荐的方案并解释原因
|
|
157
|
-
- 严格遵循 YAGNI —— 从每个方案和设计里移除不必要的功能
|
|
158
|
-
|
|
159
|
-
**展示设计:**
|
|
160
|
-
|
|
161
|
-
- 一旦你认为理解了要构建的内容,就展示设计
|
|
162
|
-
- 每个部分的篇幅与其复杂度匹配:简单的几句话,复杂的最多 200-300 字
|
|
163
|
-
- 每个部分展示后询问是否正确
|
|
164
|
-
- 涵盖:架构、组件、数据流、错误处理、测试
|
|
165
|
-
- 随时准备回头澄清不明确的地方
|
|
166
|
-
|
|
167
|
-
**面向隔离和清晰的设计:**
|
|
168
|
-
|
|
169
|
-
- 将系统拆分为更小的单元,每个单元有一个明确的职责,通过定义良好的接口通信,可以独立理解和测试
|
|
170
|
-
- 对于每个单元,你应该能回答:它做什么,如何使用,它依赖什么?
|
|
171
|
-
- 别人能否不看内部实现就理解一个单元的功能?你能否在不影响调用者的情况下修改内部实现?如果不能,边界需要调整。
|
|
172
|
-
- 更小、边界清晰的单元也更便于你工作——你对能一次放入上下文的代码推理得更好,文件越专注你的编辑越可靠。当文件变大时,这通常意味着它承担了过多职责。
|
|
173
|
-
|
|
174
|
-
**在现有代码库中工作:**
|
|
175
|
-
|
|
176
|
-
- 在提出更改之前先探索现有结构。遵循现有模式。
|
|
177
|
-
- 如果现有代码存在影响当前工作的问题(例如文件过大、边界不清、职责纠缠),在设计中包含有针对性的改进——就像一个优秀的开发者在工作中改进经手的代码一样。
|
|
178
|
-
- 不要提议无关的重构。专注于服务当前目标的事情。
|
|
179
|
-
|
|
180
|
-
## 设计之后(架构级路径)
|
|
181
|
-
|
|
182
|
-
**文档:**
|
|
183
|
-
|
|
184
|
-
- 将验证通过的设计(规格说明)写入 `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md`
|
|
185
|
-
- (用户对规格位置的偏好优先于此默认值)
|
|
186
|
-
- 如果可用,使用 elements-of-style:writing-clearly-and-concisely 技能
|
|
187
|
-
- 将设计文档 commit 到 git
|
|
188
|
-
|
|
189
|
-
**规格自检:**
|
|
190
|
-
编写规格文档后,以全新的视角审视它:
|
|
191
|
-
|
|
192
|
-
1. **占位符扫描:** 有没有"待定"、"TODO"、未完成的章节或模糊的需求?修复它们。
|
|
193
|
-
2. **内部一致性:** 各章节之间有矛盾吗?架构和功能描述匹配吗?
|
|
194
|
-
3. **范围检查:** 这是否聚焦到可以用一个实现计划覆盖,还是需要进一步拆分?
|
|
195
|
-
4. **模糊性检查:** 有没有需求可以被两种方式理解?如果有,选择一种并明确写出来。
|
|
196
|
-
|
|
197
|
-
发现问题就直接内联修复。无需重新审查——修好继续推进。
|
|
198
|
-
|
|
199
|
-
**用户审查关卡:**
|
|
200
|
-
规格自检完成后,请用户在继续之前审查书面规格:
|
|
201
|
-
|
|
202
|
-
> "规格已编写并 commit 到 `<path>`。请审查一下,如果在我们开始编写实现计划之前你想做任何修改,请告诉我。"
|
|
203
|
-
|
|
204
|
-
等待用户回复。如果他们要求修改,做出修改并重新运行规格自检。只有在用户批准后才继续。
|
|
205
|
-
|
|
206
|
-
**实现:**
|
|
207
|
-
|
|
208
|
-
- 调用 writing-plans 技能创建详细的实现计划
|
|
209
|
-
- 不要调用任何其他技能。writing-plans 是下一步。
|
|
124
|
+
| "我给几个选项,省得他们费劲" | 选项会带偏人。先请他们自己描述。 |
|
|
125
|
+
| "我把合理的默认值填上" | 很好。把它们说出来。他们从没听到过的默认值,他们也就没法拒绝。 |
|
|
126
|
+
| "我应该先把流程讲清楚" | 问你的问题。流程自己会显现出来。 |
|
|
127
|
+
| "他们对这个想法说了'听起来不错'" | 批准只覆盖你给他们看过的东西。你还没写出来的描述,不算批准过。 |
|
|
128
|
+
| "spike 跑通了,我接着在它上面做下去" | 保留它是一个新的需求。重新走关卡。 |
|
|
210
129
|
|
|
211
130
|
## 视觉伴侣
|
|
212
131
|
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
**提供伴侣(在需要时才提):** **不要一上来就提。** 等到某个问题确实"画出来比说出来更清楚"时再提——要是真正的原型 / 布局 / 图表问题,而不仅仅是话题跟 UI 沾边。第一次出现这种情况时,就在那一刻提供,作为独立的一条消息:
|
|
216
|
-
> "接下来这部分,我展示给你看可能更容易理解——我可以在讨论过程中,在一个浏览器标签页里做原型、图表和对比。这个功能还比较新,可能会消耗较多 token。要我打开吗?我来帮你打开。"
|
|
132
|
+
一个浏览器标签页,用来展示原型、示意图和可交互的原型。它是一个工具,不是一种模式:接受了它,并不意味着每个问题都要搬到浏览器里。
|
|
217
133
|
|
|
218
|
-
|
|
134
|
+
**在需要的那一刻再提。** 上面列出的那些时刻第一次出现时才提出,绝不一上来就提。这个提议是一条单独的消息,里面不放任何别的东西:
|
|
219
135
|
|
|
220
|
-
|
|
136
|
+
> "这部分我展示给你看可能更容易。要我打开一个浏览器标签页,放几个原型给你看吗?"
|
|
221
137
|
|
|
222
|
-
|
|
223
|
-
- **使用终端** 展示文本内容——需求问题、概念选择、权衡列表、A/B/C/D 文字选项、范围决策
|
|
138
|
+
如果他们拒绝,就继续用文字,除非他们自己提起,否则不要再提。
|
|
224
139
|
|
|
225
|
-
|
|
140
|
+
**每个问题都问一下:他们看到它,会不会比读到它更容易理解?** 原型、布局、示意图和并排的设计放到浏览器里。需求、范围、权衡和概念性的选择留在文字里。一个关于 UI 话题的问题,不自动等于一个视觉问题。
|
|
226
141
|
|
|
227
|
-
|
|
228
|
-
`skills/brainstorming/visual-companion.md`
|
|
142
|
+
如果他们接受了,在启动服务之前,先阅读本目录下的 `visual-companion.md`。
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# 建造者检查提示模板
|
|
2
|
+
|
|
3
|
+
书面设计写好之后,用这段提示派发一个全新的通用子代理。填入领域和文档路径。
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
你是一位有才干的 [领域,例如"软件工程师"、"活动策划"、"烘焙店顾问"]。有人交给你一份设计文档,请你据此制定一份计划,把文档描述的东西做出来。你没有机会和写这份文档的人交流。
|
|
7
|
+
|
|
8
|
+
阅读 [DOCUMENT_PATH]。
|
|
9
|
+
|
|
10
|
+
只汇报你在能够好好制定计划之前、仍然需要得到回答的问题:那些你不得不去猜、而一旦猜错就会产生影响的地方。每一条都给出问题本身,以及为什么它的答案会改变计划。按重要程度排序。
|
|
11
|
+
|
|
12
|
+
跳过文档明确留给建造者决定的内容,以及任何你可以合理地自行决定的内容。跳过对措辞的挑剔。
|
|
13
|
+
|
|
14
|
+
如果没有剩下任何重要的问题,就回答"没有剩下重要的问题"。
|
|
15
|
+
```
|
|
@@ -261,7 +261,7 @@ function isFullDocument(html) {
|
|
|
261
261
|
}
|
|
262
262
|
|
|
263
263
|
function wrapInFrame(content) {
|
|
264
|
-
return renderBranding(frameTemplate).replace('<!-- CONTENT -->', content);
|
|
264
|
+
return renderBranding(frameTemplate).replace('<!-- CONTENT -->', () => content);
|
|
265
265
|
}
|
|
266
266
|
|
|
267
267
|
function getNewestScreen() {
|
|
@@ -58,7 +58,7 @@ metadata:
|
|
|
58
58
|
原因:攻击者可以通过 name 参数注入 `'; DROP TABLE users; --`。
|
|
59
59
|
|
|
60
60
|
建议:使用参数化查询:
|
|
61
|
-
db.query('SELECT * FROM users WHERE name =
|
|
61
|
+
db.query('SELECT * FROM users WHERE name = ?', [name])
|
|
62
62
|
|
|
63
63
|
参考:https://cheatsheetseries.owasp.org/cheatsheets/SQL_Injection_Prevention_Cheat_Sheet.html
|
|
64
64
|
```
|
|
@@ -45,7 +45,7 @@ if [ "$rc" -ne 0 ]; then
|
|
|
45
45
|
exit "$rc"
|
|
46
46
|
fi
|
|
47
47
|
|
|
48
|
-
last=$(grep -v '^[[:space:]]*$' "$log" | tail -n 1)
|
|
48
|
+
last=$(grep -v '^[[:space:]]*$' "$log" | tail -n 1) || last="(no output)"
|
|
49
49
|
[ -f "$ledger" ] || printf '# SDD ledger — plan: %s\n' "$plan" > "$ledger"
|
|
50
50
|
line="Task $n: complete (commits $(git rev-parse --short=7 "$base")..$(git rev-parse --short=7 HEAD), tests: $cmd → $last)"
|
|
51
51
|
printf '%s\n' "$line" >> "$ledger"
|
|
@@ -57,7 +57,7 @@ HEAD_SHA=$(git rev-parse HEAD)
|
|
|
57
57
|
|
|
58
58
|
你:让我在继续之前请求代码审查。
|
|
59
59
|
|
|
60
|
-
BASE_SHA=$(git log --oneline | grep "Task 1" | head -1 |
|
|
60
|
+
BASE_SHA=$(git log --oneline | grep "Task 1" | head -1 | cut -d' ' -f1)
|
|
61
61
|
HEAD_SHA=$(git rev-parse HEAD)
|
|
62
62
|
|
|
63
63
|
[派遣代码审查子代理]
|
|
@@ -42,13 +42,16 @@ slug=$(basename "$plan" .md)
|
|
|
42
42
|
[ -n "$slug" ] && [ "$slug" != "." ] && [ "$slug" != ".." ] \
|
|
43
43
|
|| { echo "cannot derive a workspace name from: $plan" >&2; exit 2; }
|
|
44
44
|
|
|
45
|
-
|
|
45
|
+
# Physical path, spelled the way pwd -P spells the plan path below: on Git
|
|
46
|
+
# Bash, rev-parse prints C:/Users/... while pwd prints /c/Users/..., and the
|
|
47
|
+
# repo-relative marker check needs both in the same form.
|
|
48
|
+
root=$(CDPATH='' cd -- "$(git rev-parse --show-toplevel)" && pwd -P)
|
|
46
49
|
base="$root/.superpowers/sdd"
|
|
47
50
|
|
|
48
51
|
# Normalize the plan path (physical directory, so relative/absolute/../
|
|
49
52
|
# spellings of one plan compare equal) and express it as the marker value:
|
|
50
53
|
# repo-relative when the plan lives under the repo root, absolute otherwise.
|
|
51
|
-
plan_dir=$(CDPATH= cd -- "$(dirname "$plan")" && pwd -P)
|
|
54
|
+
plan_dir=$(CDPATH='' cd -- "$(dirname "$plan")" && pwd -P)
|
|
52
55
|
plan_abs="$plan_dir/$(basename "$plan")"
|
|
53
56
|
case "$plan_abs" in
|
|
54
57
|
"$root"/*) plan_id=${plan_abs#"$root"/} ;;
|
|
@@ -78,5 +81,7 @@ if ! owns "$dir"; then
|
|
|
78
81
|
fi
|
|
79
82
|
fi
|
|
80
83
|
|
|
81
|
-
|
|
82
|
-
|
|
84
|
+
# Create-only: a repo may commit its own .gitignore here (e.g. to version
|
|
85
|
+
# progress.md ledgers); overwriting it would revert that on every run.
|
|
86
|
+
[ -e "$base/.gitignore" ] || printf '*\n' > "$base/.gitignore"
|
|
87
|
+
CDPATH='' cd -- "$dir" && pwd
|
|
@@ -4,7 +4,7 @@ Reference example of extracting, structuring, and bulletproofing a critical skil
|
|
|
4
4
|
|
|
5
5
|
## Source Material
|
|
6
6
|
|
|
7
|
-
Extracted debugging framework from
|
|
7
|
+
Extracted debugging framework from `~/.claude/CLAUDE.md`:
|
|
8
8
|
- 4-phase systematic process (Investigation → Pattern Analysis → Hypothesis → Implementation)
|
|
9
9
|
- Core mandate: ALWAYS find root cause, NEVER fix symptoms
|
|
10
10
|
- Rules designed to resist time pressure and rationalization
|
|
@@ -93,11 +93,11 @@ metadata:
|
|
|
93
93
|
```bash
|
|
94
94
|
# 第 1 层:工作流
|
|
95
95
|
echo "=== Secrets available in workflow: ==="
|
|
96
|
-
echo "IDENTITY: $
|
|
96
|
+
echo "IDENTITY: $([ -n "${IDENTITY:-}" ] && echo SET || echo UNSET)"
|
|
97
97
|
|
|
98
98
|
# 第 2 层:构建脚本
|
|
99
99
|
echo "=== Env vars in build script: ==="
|
|
100
|
-
|
|
100
|
+
printenv IDENTITY >/dev/null 2>&1 && echo "IDENTITY in environment" || echo "IDENTITY not in environment"
|
|
101
101
|
|
|
102
102
|
# 第 3 层:签名脚本
|
|
103
103
|
echo "=== Keychain state: ==="
|
|
@@ -14,7 +14,7 @@ metadata:
|
|
|
14
14
|
|
|
15
15
|
**编写技能就是将测试驱动开发应用于流程文档。**
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
**个人技能存放在你所用运行环境的技能目录中**(Claude Code 上是 `~/.claude/skills/`)——其他运行环境的路径见 [codex-tools.md](../using-superpowers/references/codex-tools.md) 或 [gemini-tools.md](../using-superpowers/references/gemini-tools.md)。Codex、Copilot CLI 和 Gemini CLI 也都认 `~/.agents/skills/`,作为跨运行环境的别名。
|
|
18
18
|
|
|
19
19
|
你编写测试用例(带子智能体的压力场景),观察它们失败(基线行为),编写技能(文档),观察测试通过(智能体遵守规则),然后重构(堵住漏洞)。
|
|
20
20
|
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -1,48 +0,0 @@
|
|
|
1
|
-
# 规格文档审查员提示模板
|
|
2
|
-
|
|
3
|
-
调度规格文档审查员子代理时使用此模板。
|
|
4
|
-
|
|
5
|
-
**用途:** 验证规格是否完整、一致,并为实现计划做好准备。
|
|
6
|
-
|
|
7
|
-
**调度时机:** 规格文档写入 docs/superpowers/specs/ 之后
|
|
8
|
-
|
|
9
|
-
```
|
|
10
|
-
Task tool(通用):
|
|
11
|
-
description: "审查规格文档"
|
|
12
|
-
prompt: |
|
|
13
|
-
你是一名规格文档审查员。验证此规格是否完整并准备好进行计划编写。
|
|
14
|
-
|
|
15
|
-
**待审查规格:** [SPEC_FILE_PATH]
|
|
16
|
-
|
|
17
|
-
## 检查内容
|
|
18
|
-
|
|
19
|
-
| 类别 | 检查要点 |
|
|
20
|
-
|------|----------|
|
|
21
|
-
| 完整性 | TODO、占位符、"TBD"、不完整的章节 |
|
|
22
|
-
| 一致性 | 内部矛盾、相互冲突的需求 |
|
|
23
|
-
| 清晰度 | 需求模糊到可能导致构建出错误的东西 |
|
|
24
|
-
| 范围 | 是否足够聚焦以用于单个计划——而非涵盖多个独立子系统 |
|
|
25
|
-
| YAGNI | 未请求的功能、过度设计 |
|
|
26
|
-
|
|
27
|
-
## 校准标准
|
|
28
|
-
|
|
29
|
-
**只标记会在实现计划阶段造成实际问题的事项。**
|
|
30
|
-
缺失的章节、矛盾之处、或者模糊到可能被两种不同方式理解的需求——
|
|
31
|
-
这些才是问题。措辞上的小改进、风格偏好、以及"某些章节不如其他章节详细"则不是。
|
|
32
|
-
|
|
33
|
-
除非存在会导致计划出错的严重缺陷,否则应予以通过。
|
|
34
|
-
|
|
35
|
-
## 输出格式
|
|
36
|
-
|
|
37
|
-
## 规格审查
|
|
38
|
-
|
|
39
|
-
**状态:** 通过 | 发现问题
|
|
40
|
-
|
|
41
|
-
**问题(如有):**
|
|
42
|
-
- [章节 X]:[具体问题] - [为什么这对计划编写很重要]
|
|
43
|
-
|
|
44
|
-
**建议(仅供参考,不阻止通过):**
|
|
45
|
-
- [改进建议]
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
**审查员返回:** 状态、问题(如有)、建议
|