superpowers-zh 1.7.12 → 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.
Files changed (93) hide show
  1. package/.claude-plugin/marketplace.json +3 -3
  2. package/.claude-plugin/plugin.json +2 -2
  3. package/.codex-plugin/plugin.json +1 -1
  4. package/.cursor-plugin/plugin.json +2 -2
  5. package/.opencode/INSTALL.md +82 -14
  6. package/.opencode/plugins/superpowers.js +319 -31
  7. package/GEMINI.md +3 -2
  8. package/README.md +68 -36
  9. package/README.zh-Hant.md +66 -37
  10. package/RELEASE-NOTES.zh.md +154 -0
  11. package/assets/sponsors/88api.jpg +0 -0
  12. package/assets/sponsors/apinebula.png +0 -0
  13. package/assets/sponsors/logo-infistar-icon.png +0 -0
  14. package/assets/sponsors/logo-sidrune-ai.png +0 -0
  15. package/assets/sponsors/logo-volcengine-icon.png +0 -0
  16. package/assets/sponsors/volcengine.png +0 -0
  17. package/bin/superpowers-zh.js +21 -2
  18. package/docs/README.aider.md +2 -2
  19. package/docs/README.claw.md +1 -1
  20. package/docs/README.cline.md +3 -3
  21. package/docs/README.codearts.md +1 -1
  22. package/docs/README.codebuddy.md +1 -1
  23. package/docs/README.codex.md +26 -0
  24. package/docs/README.crush.md +1 -1
  25. package/docs/README.deepseek-harness.md +1 -1
  26. package/docs/README.deerflow.md +1 -1
  27. package/docs/README.hermes.md +1 -1
  28. package/docs/README.kilocode.md +3 -3
  29. package/docs/README.kiro.md +1 -1
  30. package/docs/README.opencode.md +128 -19
  31. package/docs/README.qoder.md +1 -1
  32. package/docs/README.qwen.md +1 -1
  33. package/docs/README.trae-cn.md +62 -0
  34. package/docs/README.vscode.md +1 -1
  35. package/docs/README.zcode.md +2 -2
  36. package/gemini-extension.json +1 -1
  37. package/hooks/run-hook.cmd +34 -18
  38. package/hooks/session-start +45 -9
  39. package/index.js +9 -0
  40. package/package.json +4 -3
  41. package/skills/brainstorming/SKILL.md +111 -181
  42. package/skills/brainstorming/builder-check-prompt.md +15 -0
  43. package/skills/brainstorming/scripts/server.cjs +1 -1
  44. package/skills/brainstorming/visual-companion.md +36 -33
  45. package/skills/chinese-code-review/SKILL.md +1 -1
  46. package/skills/chinese-commit-conventions/SKILL.md +1 -1
  47. package/skills/diagnosing-superpowers/SKILL.md +102 -0
  48. package/skills/diagnosing-superpowers/prompts/analyst-common.md +32 -0
  49. package/skills/diagnosing-superpowers/prompts/cost-and-time.md +20 -0
  50. package/skills/diagnosing-superpowers/prompts/plan-adherence.md +21 -0
  51. package/skills/diagnosing-superpowers/prompts/quality-evidence.md +20 -0
  52. package/skills/diagnosing-superpowers/prompts/repeated-work.md +24 -0
  53. package/skills/diagnosing-superpowers/prompts/request-conflicts.md +14 -0
  54. package/skills/diagnosing-superpowers/prompts/scrub-audit.md +26 -0
  55. package/skills/diagnosing-superpowers/prompts/scrub.md +22 -0
  56. package/skills/diagnosing-superpowers/prompts/similar-session.md +34 -0
  57. package/skills/diagnosing-superpowers/prompts/skill-timeline.md +23 -0
  58. package/skills/diagnosing-superpowers/prompts/stumbles.md +20 -0
  59. package/skills/diagnosing-superpowers/references/context-safety.md +20 -0
  60. package/skills/diagnosing-superpowers/references/github-issues.md +46 -0
  61. package/skills/diagnosing-superpowers/references/redaction-policy.md +29 -0
  62. package/skills/diagnosing-superpowers/references/session-discovery.md +23 -0
  63. package/skills/diagnosing-superpowers/templates/bundle-README.md +65 -0
  64. package/skills/diagnosing-superpowers/templates/case.md +61 -0
  65. package/skills/diagnosing-superpowers/templates/issue.md +48 -0
  66. package/skills/diagnosing-superpowers/templates/report.md +78 -0
  67. package/skills/executing-plans/SKILL.md +176 -125
  68. package/skills/executing-plans/scripts/task-done +52 -0
  69. package/skills/executing-plans/scripts/task-start +28 -0
  70. package/skills/mcp-builder/SKILL.md +1 -1
  71. package/skills/requesting-code-review/SKILL.md +2 -2
  72. package/skills/requesting-code-review/code-reviewer.md +8 -0
  73. package/skills/subagent-driven-development/SKILL.md +17 -17
  74. package/skills/subagent-driven-development/re-review-prompt.md +1 -1
  75. package/skills/subagent-driven-development/scripts/review-package +8 -1
  76. package/skills/subagent-driven-development/scripts/sdd-workspace +51 -4
  77. package/skills/subagent-driven-development/scripts/task-brief +3 -1
  78. package/skills/subagent-driven-development/task-reviewer-prompt.md +2 -2
  79. package/skills/systematic-debugging/CREATION-LOG.md +1 -1
  80. package/skills/systematic-debugging/SKILL.md +2 -2
  81. package/skills/systematic-debugging/root-cause-tracing.md +1 -1
  82. package/skills/test-driven-development/SKILL.md +2 -0
  83. package/skills/using-superpowers/SKILL.md +19 -14
  84. package/skills/using-superpowers/references/claude-code-tools.md +11 -0
  85. package/skills/using-superpowers/references/muse-tools.md +35 -0
  86. package/skills/writing-plans/SKILL.md +34 -27
  87. package/skills/writing-skills/SKILL.md +5 -3
  88. package/assets/sponsors/apimart.jpg +0 -0
  89. package/assets/sponsors/compshare.jpg +0 -0
  90. package/assets/sponsors/logo-apimart-icon.png +0 -0
  91. package/assets/sponsors/logo-compshare-icon.png +0 -0
  92. package/skills/brainstorming/spec-document-reviewer-prompt.md +0 -48
  93. package/skills/writing-plans/plan-document-reviewer-prompt.md +0 -49
@@ -0,0 +1,62 @@
1
+ # Superpowers 中文版 — TRAE CN(国内版)安装指南
2
+
3
+ TRAE 分**国际版**([trae.ai](https://www.trae.ai))与**国内版 TRAE CN**([trae.cn](https://www.trae.cn))。两版的**项目级**技能目录相同,**全局**目录不同 —— 这份文档讲的是差异部分。
4
+
5
+ ## 一句话
6
+
7
+ | 想要什么 | 命令 | 装到哪 |
8
+ |---|---|---|
9
+ | 项目级(两版通用) | `npx superpowers-zh --tool trae` | `.trae/skills/` |
10
+ | 全局(**仅国内版**) | `npx superpowers-zh --global --tool traecn` | `~/.trae-cn/skills/` |
11
+
12
+ ## 为什么全局要单独一条命令
13
+
14
+ [TRAE CN 官方文档「技能所在目录」](https://docs.trae.cn/ide/skills) 写明:
15
+
16
+ > 全局技能:macOS/Linux `~/.trae-cn/skills`,Windows `%userprofile%/.trae-cn/skills`
17
+ >
18
+ > 项目技能:项目所在路径下的 `.trae/skills/` 目录
19
+
20
+ 注意全局目录是 **`.trae-cn`**,不是 `.trae` —— 差这一个后缀,装进去 TRAE 就永远不会扫到。
21
+
22
+ 而[国际版文档](https://docs.trae.ai/ide/skills)**没有给出全局技能的磁盘路径**。按本项目一贯口径:**没有一手出处就不猜路径**,所以国际版不提供全局安装,请用项目级。
23
+
24
+ (`%userprofile%` 就是用户主目录,所以 Windows 与 macOS/Linux 在「主目录下的 `.trae-cn/skills`」这一点上是同构的,安装器不需要为它单独处理平台差异。)
25
+
26
+ ## 项目级为什么两版共用一条命令
27
+
28
+ 两版的项目级路径都是 `.trae/skills/`,所以 `--tool trae` 一条覆盖两版。
29
+
30
+ 如果你对 `TRAE CN` 用项目级安装,安装器会**明确拒绝**并告诉你该用哪条命令,而不是装到一个可能不生效的地方:
31
+
32
+ ```
33
+ ❌ TRAE CN 不支持项目级安装。
34
+
35
+ TRAE CN 的项目级技能目录与国际版 TRAE 相同(.trae/skills/),
36
+ 已经由 Trae 这一条覆盖,请直接用:
37
+ npx superpowers-zh --tool trae
38
+ 本条目只用于 TRAE CN 独有的**全局**目录(~/.trae-cn/skills)。
39
+ ```
40
+
41
+ ## 自动触发
42
+
43
+ - **项目级**安装会同时写 `.trae/rules/superpowers-zh.md`,skill 因此能自动触发。
44
+ - **全局**安装只放 skill 文件,不写规则文件 —— TRAE CN 文档没有给出全局规则文件的确切路径,不确认就不写。所以全局装完需要在对话里显式点名 skill,或者改用项目级安装。
45
+
46
+ ## 卸载
47
+
48
+ ```bash
49
+ npx superpowers-zh --global --uninstall --tool traecn # 清 ~/.trae-cn/skills
50
+ npx superpowers-zh --uninstall --tool trae # 清 .trae/skills + .trae/rules
51
+ ```
52
+
53
+ ## 别名
54
+
55
+ `traecn`、`trae-cn`、`trae-china` 三个都指向同一个目标。
56
+
57
+ ## 来源
58
+
59
+ - [TRAE CN 技能文档 · docs.trae.cn/ide/skills](https://docs.trae.cn/ide/skills) —— 全局与项目级路径(核对日期 2026-09-08)
60
+ - [TRAE 国际版技能文档 · docs.trae.ai/ide/skills](https://docs.trae.ai/ide/skills) —— 只给出 `.trae/skills/`,无全局路径
61
+
62
+ 相关 issue:[#35 建议支持 Trae CN](https://github.com/jnMetaCode/superpowers-zh/issues/35)
@@ -46,7 +46,7 @@ npx superpowers-zh --tool vscode
46
46
 
47
47
  | 位置 | 内容 | Copilot 是否自动读 |
48
48
  |---|---|---|
49
- | `.github/instructions/superpowers-zh.instructions.md` | 索引:核心规则 + 20 个 skill 的触发条件表 | **是**(`applyTo: "**"`) |
49
+ | `.github/instructions/superpowers-zh.instructions.md` | 索引:核心规则 + 21 个 skill 的触发条件表 | **是**(`applyTo: "**"`) |
50
50
  | `.github/superpowers/<name>/SKILL.md` | skill 正文 | 否,由索引引导按需读取 |
51
51
 
52
52
  **为什么不直接改 `.github/copilot-instructions.md`:** 那是你的文件。我们用自己的 `.instructions.md`,两者互不干扰,卸载时也能精确删掉而不碰你的内容。
@@ -24,7 +24,7 @@ npx superpowers-zh --global --tool zcode
24
24
 
25
25
  ZCode 里技能通过 `$skill-name` 调用:在输入框输入 `$`,选择需要的技能。也可以在 **设置 → 技能** 里查看列表、按名称搜索、用开关启用/停用。
26
26
 
27
- 装完后建议先确认:设置 → 技能 里能看到这 20 个 skill,且处于启用状态。
27
+ 装完后建议先确认:设置 → 技能 里能看到这 21 个 skill,且处于启用状态。
28
28
 
29
29
  ## 手动安装
30
30
 
@@ -42,7 +42,7 @@ cp -r superpowers-zh/skills/* ~/.zcode/skills/
42
42
  npx superpowers-zh --global --uninstall
43
43
  ```
44
44
 
45
- 只移除我们装的那 20 个技能目录,你自建的技能不受影响(已在 verify-release 里有断言守着)。
45
+ 只移除我们装的那 21 个技能目录,你自建的技能不受影响(已在 verify-release 里有断言守着)。
46
46
 
47
47
  ## 关于 AGENTS.md
48
48
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "superpowers-zh",
3
3
  "description": "AI 编程超能力中文版 — TDD、调试、代码审查等经过实战验证的工作方法论",
4
- "version": "1.7.12",
4
+ "version": "1.8.0",
5
5
  "contextFileName": "GEMINI.md"
6
6
  }
@@ -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 Try Git for Windows bash in standard locations
21
- if exist "C:\Program Files\Git\bin\bash.exe" (
22
- "C:\Program Files\Git\bin\bash.exe" "%HOOK_DIR%%~1" %2 %3 %4 %5 %6 %7 %8 %9
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 Try bash on PATH (e.g. user-installed Git Bash, MSYS2, Cygwin)
31
- where bash >nul 2>nul
32
- if %ERRORLEVEL% equ 0 (
33
- bash "%HOOK_DIR%%~1" %2 %3 %4 %5 %6 %7 %8 %9
34
- exit /b %ERRORLEVEL%
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
- SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
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}" "$@"
@@ -3,12 +3,26 @@
3
3
 
4
4
  set -euo pipefail
5
5
 
6
- # Determine plugin root directory
7
- SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
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
- using_superpowers_content=$(cat "${PLUGIN_ROOT}/skills/using-superpowers/SKILL.md" 2>&1 || echo "Error reading using-superpowers skill")
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
@@ -32,18 +46,40 @@ session_context="<EXTREMELY_IMPORTANT>\nYou have superpowers.\n\n**Below is the
32
46
  # Copilot CLI (v1.0.11+) and others expect additionalContext (top-level, SDK standard).
33
47
  # Claude Code reads BOTH additional_context and hookSpecificOutput without
34
48
  # deduplication, so we must emit only the field the current platform consumes.
49
+ # Muse sets MUSE_PLUGIN_ROOT and expects additionalContext (SDK standard).
35
50
  #
36
51
  # Uses printf instead of heredoc to work around bash 5.3+ heredoc hang.
37
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
+
38
71
  if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
39
72
  # Cursor sets CURSOR_PLUGIN_ROOT (may also set CLAUDE_PLUGIN_ROOT)
40
- printf '{\n "additional_context": "%s"\n}\n' "$session_context" | cat
41
- elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -z "${COPILOT_CLI:-}" ]; then
42
- # Claude Code sets CLAUDE_PLUGIN_ROOT without COPILOT_CLI
43
- printf '{\n "hookSpecificOutput": {\n "hookEventName": "SessionStart",\n "additionalContext": "%s"\n }\n}\n' "$session_context" | cat
73
+ emit_json '{\n "additional_context": "%s"\n}\n' "$session_context"
74
+ elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -z "${COPILOT_CLI:-}" ] && [ -z "${MUSE_PLUGIN_ROOT:-}" ]; then
75
+ # Claude Code sets CLAUDE_PLUGIN_ROOT without COPILOT_CLI/MUSE_PLUGIN_ROOT
76
+ emit_json '{\n "hookSpecificOutput": {\n "hookEventName": "SessionStart",\n "additionalContext": "%s"\n }\n}\n' "$session_context"
77
+ elif [ -n "${MUSE_PLUGIN_ROOT:-}" ]; then
78
+ # Muse sets MUSE_PLUGIN_ROOT — try Claude-style nested output for Muse Spark
79
+ emit_json '{\n "hookSpecificOutput": {\n "hookEventName": "SessionStart",\n "additionalContext": "%s"\n }\n}\n' "$session_context"
44
80
  else
45
81
  # Copilot CLI (sets COPILOT_CLI=1) or unknown platform — SDK standard format
46
- printf '{\n "additionalContext": "%s"\n}\n' "$session_context" | cat
82
+ emit_json '{\n "additionalContext": "%s"\n}\n' "$session_context"
47
83
  fi
48
84
 
49
85
  exit 0
package/index.js ADDED
@@ -0,0 +1,9 @@
1
+ // Root entrypoint for OpenCode v2 directory-form plugin registration.
2
+ //
3
+ // OpenCode V2 hosts (2.0.4 or later) require config plugin entries to be directories
4
+ // with an index entrypoint (`index.js`) and reject bare file paths
5
+ // ("configured plugin path must be a directory"). npm/git package installs
6
+ // resolve via package.json `main`; this file only serves the directory form,
7
+ // an absolute path such as `"plugins": ["/path/to/superpowers"]` (`~` is not
8
+ // expanded).
9
+ export { default } from "./.opencode/plugins/superpowers.js";
package/package.json CHANGED
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "name": "superpowers-zh",
3
- "version": "1.7.12",
3
+ "version": "1.8.0",
4
4
  "engines": {
5
5
  "node": ">=20.0.0"
6
6
  },
7
- "description": "AI 编程超能力中文增强版 — superpowers(250k+ ⭐)完整汉化 + 4 个中国原创 skills,支持 Claude Code / Copilot CLI / Hermes Agent / Cursor / Claw Code / Windsurf / Kiro / Gemini CLI / Qoder 等 26 款工具",
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/",
@@ -26,6 +26,7 @@
26
26
  ".codex-plugin/",
27
27
  ".opencode/INSTALL.md",
28
28
  ".opencode/plugins/",
29
+ "index.js",
29
30
  ".pi/extensions/",
30
31
  "CLAUDE.md",
31
32
  "GEMINI.md",
@@ -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,205 +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
- <HARD-GATE>
18
- 在你告诉你的人类伙伴你打算做什么、并得到他们批准之前,不要调用任何实现技能、编写任何代码、搭建任何项目或采取任何实现行动。这适用于下面**每一条路径上的每一个任务**——仪式感随任务大小缩放,批准这道关卡永远不缩放。
19
- </HARD-GATE>
17
+ ## 首先:你到底知道多少?
18
+
19
+ 回复之前,先问自己:关于他们想要什么、为什么想要,我知道些什么?
20
+
21
+ - **要紧的信息都在请求里了**("把图标改成矢车菊蓝")。这是一个快速、明确的任务。直接做,并说明你做了什么。
22
+ - **缺了某些不简单的东西。** 开始对话。
23
+
24
+ ## 你的第一条消息
25
+
26
+ 你的第一条消息包含两件事,按这个顺序:
27
+
28
+ 1. 一句话告诉他们:如果他们宁愿跳过提问、让你直接开始,可以直说。如果他们明确接受了这个提议,这个技能就结束了:用一句平实的话说明任何重要的"怎么做出来"的选择(平台、语言、媒介),然后按正常工作流去做他们要求的事。
29
+ 2. 一个让他们开始描述的开放式问题。问一个真实的时刻或一个具体的画面:"你是在什么时候,会希望要是有这个东西就好了?"或者"跟我说说到时候在场的都是些什么人。"
30
+
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
+ - 看比读更容易理解的结构:一张示意图、一条时间线、一张地图
20
65
 
21
- ## 三条路径
66
+ 一旦他们接受,就用它来展示供他们反应的原型、并排的选项,以及他们可以点一点的一次性原型。
22
67
 
23
- 在提出第一个问题之前,先给需求分类,并把分类**说出来**——"这个看起来是有界的,所以我会在这里直接给一份简短设计,而不是写规格文档"——好让你的人类伙伴能纠正你:
68
+ **用 spike 摸一摸。** 智能体做事是瀑布式的,只不过非常、非常快。一个快速的一次性构建,往往是弄清他们想要什么、或者某样东西行不行得通的最便宜的办法。在有帮助时就提出来。当他们就是想做个 spike,就别挡路。spike 不写测试或只写最少的测试,不追求万无一失,并且跳过计划、实现和审查流程。把 spike 让你学到的东西带回对话里。
24
69
 
25
- - **探路(Spike)** — 一个可行性问题("我们能不能……"、"有没有可能……"、"糙一点没关系"),它的产出是一个**答案**,不是要留下的代码。用 2-3 句话说明问题和你打算怎么试,得到一个点头,然后用不牺牲正确性的最低成本去弄清楚。不写设计文档,不写规格文件。以建议的形式汇报发现;过程中搭的任何东西都明确标注为一次性的。
26
- - **有界(Bounded)** — 对**本仓库里已经存在的代码**做范围明确的改动:加一个开关、一个小接口、改一个文件的 bug。"知道这是个什么类型的应用"不算数——有界意味着**你要改的那条流程此刻就在仓库里、可以读**。如果没有现成的流程可改,这个任务就不是有界的。问那些真正重要的澄清问题,**在对话里**给出一份简短设计(几句话到几个短段落),然后**停下**。只有在你的人类伙伴对这份设计说"可以"之后,实现才开始——有界任务的批准和架构级任务的批准是同样硬的关卡。不写规格文件,不写实现计划文档。
27
- - **架构级(Architectural)** — 新项目、新子系统,以及会重构组件之间关系、或改动他人依赖的接口的改动。走完整流程:提问、方案对比、分节设计、书面规格,然后交给 writing-plans 技能。
70
+ ## 复述给对方
28
71
 
29
- 在两条路径之间拿不准时,选更重的那条。这个棘轮只朝一个方向转:任务进行中发现隐藏的复杂度,就**升级**路径——停下来、说明情况、升上去。任何情况下都不在任务中途降级。
72
+ 边聊边复述。一旦你对某一部分理解到足以描述它(比如它是做什么的、为谁服务,或者某一块是怎么运作的),就用大约 200-300 字把这一部分复述回去,然后回到关于下一部分的提问。复述和提问在整场对话里交替进行;最后一段复述覆盖剩下的所有内容。
30
73
 
31
- ## 反模式:"这个太简单了,不需要批准"
74
+ 你猜的东西要标明是你的猜测;只有他们说过的话才算作他们的。每段复述都以询问"哪里不对或漏了什么"结尾。
32
75
 
33
- 每条路径的终点都是你的人类伙伴在实现之前批准你的意图。一个待办事项列表、一个单函数工具、一个配置变更——设计可以只是对话里的两句话,但你**必须**把它展示出来并获得批准。"简单"的任务恰恰是未经检验的假设造成最多浪费的地方。随简单程度缩放的是**产出物**,永远不是批准。
76
+ 发出一段复述之前,先检查:它描述的是不是他们会去看的东西,比如一个页面、一个屏幕、一份日程或一份打印件?如果是,而他们还没收到过视觉伴侣的提议,就改为发送这个提议(作为单独一条消息,见下文),把这段复述留到下一条消息。一旦他们接受了,就在描述旁边放上原型。
77
+
78
+ ## 判断工作规模
79
+
80
+ 一旦你理解了他们想要什么,选定一个规模,并用平实的话说出来。他们可以推翻你的判断。
81
+
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>
34
119
 
35
120
  ## 危险信号
36
121
 
37
122
  | 心里的想法 | 实际情况 |
38
123
  |---------|---------|
39
- | "这个太简单了,不需要设计" | 简单意味着简短的设计,不是没有设计。对话里两句话,然后获得批准。 |
40
- | "我就说它是有界的,跳过规格文档" | 为了少干活而去够一个标签,这本身就是"拿不准"——选更重的那条路径。 |
41
- | "它是有界的,设计也很显然——我一边让他们读一边开工" | 关卡是**批准**,不是设计的长度。展示完就停,直到听见"可以"。 |
42
- | "这类应用我很熟,所以它是有界的" | 有界衡量的是**仓库**,不是你的熟悉程度。新项目没有现成的流程可改——那是架构级。 |
43
- | "探路跑通了,那这些代码就留着吧" | 探路的产出是一个答案。要留下代码是一个**新的需求**——给它重新分类。 |
44
- | "范围是变大了,但我快做完了,不用重新分类" | 隐藏的复杂度会在任务中途升级路径。停下来,说明情况。 |
45
- | "他们批准了探路,那后续改动也算批准了" | 每个任务有自己的分类,也有自己的批准。 |
46
-
47
- ## 检查清单
48
-
49
- 先分类,宣布路径,然后为你所在路径上的每个条目创建任务,并按顺序完成。
50
-
51
- **探路(Spike):**
52
- 1. **探索项目上下文** — 够用来框定这次试探即可
53
- 2. **展示问题 + 试探计划** — 2-3 句话
54
- 3. **获得批准** — 一个点头就够
55
- 4. **动手调查** — 用不牺牲正确性的最低成本
56
- 5. **汇报发现** — 以建议的形式;搭出来的任何东西都标注为一次性的
57
-
58
- **有界(Bounded):**
59
- 1. **探索项目上下文** — 检查文件、文档、最近的 commit
60
- 2. **提出澄清问题** — 每次一个,只问那些真正重要的
61
- 3. **在对话里展示简短设计** — 思路、会动哪些文件、怎么测
62
- 4. **获得批准** — **停下**并等待一个明确的"可以";展示完设计顺口就开工,等于跳过了关卡
63
- 5. **实现** — 走正常的开发工作流(TDD 同样适用);不写计划文档
64
-
65
- **架构级(Architectural):**
66
- 1. **探索项目上下文** — 检查文件、文档、最近的 commit
67
- 2. **在需要时才提供视觉伴侣** — **不要一上来就提**。第一次遇到"这个问题画出来比说出来更清楚"时,才在那一刻提供(作为独立的一条消息);对方同意后,浏览器标签页会为你打开。如果自始至终没出现视觉问题,就永远不要提。参见下方"视觉伴侣"部分。
68
- 3. **提出澄清问题** — 每次一个,了解目的/约束/成功标准
69
- 4. **提出 2-3 种方案** — 附带权衡分析和你的推荐
70
- 5. **展示设计** — 按复杂度分节展示,每节展示后获得用户批准
71
- 6. **编写设计文档** — 保存到 `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md` 并 commit
72
- 7. **规格自检** — 快速内联检查占位符、矛盾、模糊性、范围(详见下方)
73
- 8. **用户审查书面规格** — 在继续之前请用户审查规格文件
74
- 9. **过渡到实现** — 调用 writing-plans 技能创建实现计划
75
-
76
- ## 流程图
77
-
78
- ```dot
79
- digraph brainstorming {
80
- "分类:探路 / 有界 / 架构级" [shape=diamond];
81
- "展示问题 + 试探计划(2-3 句)" [shape=box];
82
- "提出澄清问题(有界)" [shape=box];
83
- "在对话里展示简短设计" [shape=box];
84
- "人类伙伴批准?" [shape=diamond];
85
- "动手调查;汇报建议" [shape=doublecircle];
86
- "走正常工作流实现(无计划文档)" [shape=doublecircle];
87
- "探索项目上下文" [shape=box];
88
- "提出澄清问题" [shape=box];
89
- "提出 2-3 种方案" [shape=box];
90
- "分节展示设计" [shape=box];
91
- "用户批准设计?" [shape=diamond];
92
- "编写设计文档" [shape=box];
93
- "规格自检\n(内联修复)" [shape=box];
94
- "用户审查规格?" [shape=diamond];
95
- "调用 writing-plans 技能" [shape=doublecircle];
96
- "发现隐藏复杂度? 升级路径" [shape=box];
97
-
98
- "分类:探路 / 有界 / 架构级" -> "展示问题 + 试探计划(2-3 句)" [label="探路"];
99
- "分类:探路 / 有界 / 架构级" -> "提出澄清问题(有界)" [label="有界"];
100
- "分类:探路 / 有界 / 架构级" -> "探索项目上下文" [label="架构级"];
101
- "展示问题 + 试探计划(2-3 句)" -> "人类伙伴批准?";
102
- "提出澄清问题(有界)" -> "在对话里展示简短设计";
103
- "在对话里展示简短设计" -> "人类伙伴批准?";
104
- "人类伙伴批准?" -> "动手调查;汇报建议" [label="探路:是"];
105
- "人类伙伴批准?" -> "走正常工作流实现(无计划文档)" [label="有界:是"];
106
- "发现隐藏复杂度? 升级路径" -> "分类:探路 / 有界 / 架构级";
107
- "探索项目上下文" -> "提出澄清问题";
108
- "提出澄清问题" -> "提出 2-3 种方案";
109
- "提出 2-3 种方案" -> "分节展示设计";
110
- "分节展示设计" -> "用户批准设计?";
111
- "用户批准设计?" -> "分节展示设计" [label="否,修改"];
112
- "用户批准设计?" -> "编写设计文档" [label="是"];
113
- "编写设计文档" -> "规格自检\n(内联修复)";
114
- "规格自检\n(内联修复)" -> "用户审查规格?";
115
- "用户审查规格?" -> "编写设计文档" [label="要求修改"];
116
- "用户审查规格?" -> "调用 writing-plans 技能" [label="批准"];
117
- }
118
- ```
119
-
120
- **终止状态跟着路径走。** 架构级:头脑风暴之后你唯一要调用的技能是 writing-plans——绝不调用 frontend-design、mcp-builder 或任何其他实现技能。有界:获得批准之后,直接走正常的开发工作流去实现,不写计划文档。探路:终止状态是一份汇报出去的建议。
121
-
122
- ## 流程详述
123
-
124
- 下面这些小节服务于**有界**和**架构级**两条路径(探路在"展示试探计划、拿到点头"就停了)。从**探索方案**往后都是架构级路径的深度——对有界的工作来说,上下文加几个问题再加一份对话里的简短设计,就是全部流程。
125
-
126
- **理解想法:**
127
-
128
- - 首先查看当前项目状态(文件、文档、最近的 commit)
129
- - 在提出详细问题之前,先评估范围:如果需求描述了多个独立子系统(例如"构建一个包含聊天、文件存储、计费和分析的平台"),立即指出这一点。不要花时间用问题去细化一个需要先拆分的项目。
130
- - 如果项目规模过大,单个规格说明无法覆盖,帮助用户分解为子项目:有哪些独立的部分,它们之间有什么关系,应该按什么顺序构建?然后通过正常的设计流程进行第一个子项目的头脑风暴。每个子项目都有自己的规格 → 计划 → 实现周期。
131
- - 对于范围适当的项目,每次提一个问题来完善想法
132
- - 尽量使用选择题,开放式问题也可以
133
- - 每条消息只提一个问题——如果一个主题需要更多探索,拆分成多个问题
134
- - 重点理解:目的、约束、成功标准
135
-
136
- **探索方案:**
137
-
138
- - 提出 2-3 种不同的方案及其权衡
139
- - 以对话的方式展示选项,附上你的推荐和理由
140
- - 先展示你推荐的方案并解释原因
141
- - 严格遵循 YAGNI —— 从每个方案和设计里移除不必要的功能
142
-
143
- **展示设计:**
144
-
145
- - 一旦你认为理解了要构建的内容,就展示设计
146
- - 每个部分的篇幅与其复杂度匹配:简单的几句话,复杂的最多 200-300 字
147
- - 每个部分展示后询问是否正确
148
- - 涵盖:架构、组件、数据流、错误处理、测试
149
- - 随时准备回头澄清不明确的地方
150
-
151
- **面向隔离和清晰的设计:**
152
-
153
- - 将系统拆分为更小的单元,每个单元有一个明确的职责,通过定义良好的接口通信,可以独立理解和测试
154
- - 对于每个单元,你应该能回答:它做什么,如何使用,它依赖什么?
155
- - 别人能否不看内部实现就理解一个单元的功能?你能否在不影响调用者的情况下修改内部实现?如果不能,边界需要调整。
156
- - 更小、边界清晰的单元也更便于你工作——你对能一次放入上下文的代码推理得更好,文件越专注你的编辑越可靠。当文件变大时,这通常意味着它承担了过多职责。
157
-
158
- **在现有代码库中工作:**
159
-
160
- - 在提出更改之前先探索现有结构。遵循现有模式。
161
- - 如果现有代码存在影响当前工作的问题(例如文件过大、边界不清、职责纠缠),在设计中包含有针对性的改进——就像一个优秀的开发者在工作中改进经手的代码一样。
162
- - 不要提议无关的重构。专注于服务当前目标的事情。
163
-
164
- ## 设计之后(架构级路径)
165
-
166
- **文档:**
167
-
168
- - 将验证通过的设计(规格说明)写入 `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md`
169
- - (用户对规格位置的偏好优先于此默认值)
170
- - 如果可用,使用 elements-of-style:writing-clearly-and-concisely 技能
171
- - 将设计文档 commit 到 git
172
-
173
- **规格自检:**
174
- 编写规格文档后,以全新的视角审视它:
175
-
176
- 1. **占位符扫描:** 有没有"待定"、"TODO"、未完成的章节或模糊的需求?修复它们。
177
- 2. **内部一致性:** 各章节之间有矛盾吗?架构和功能描述匹配吗?
178
- 3. **范围检查:** 这是否聚焦到可以用一个实现计划覆盖,还是需要进一步拆分?
179
- 4. **模糊性检查:** 有没有需求可以被两种方式理解?如果有,选择一种并明确写出来。
180
-
181
- 发现问题就直接内联修复。无需重新审查——修好继续推进。
182
-
183
- **用户审查关卡:**
184
- 规格自检完成后,请用户在继续之前审查书面规格:
185
-
186
- > "规格已编写并 commit 到 `<path>`。请审查一下,如果在我们开始编写实现计划之前你想做任何修改,请告诉我。"
187
-
188
- 等待用户回复。如果他们要求修改,做出修改并重新运行规格自检。只有在用户批准后才继续。
189
-
190
- **实现:**
191
-
192
- - 调用 writing-plans 技能创建详细的实现计划
193
- - 不要调用任何其他技能。writing-plans 是下一步。
124
+ | "我给几个选项,省得他们费劲" | 选项会带偏人。先请他们自己描述。 |
125
+ | "我把合理的默认值填上" | 很好。把它们说出来。他们从没听到过的默认值,他们也就没法拒绝。 |
126
+ | "我应该先把流程讲清楚" | 问你的问题。流程自己会显现出来。 |
127
+ | "他们对这个想法说了'听起来不错'" | 批准只覆盖你给他们看过的东西。你还没写出来的描述,不算批准过。 |
128
+ | "spike 跑通了,我接着在它上面做下去" | 保留它是一个新的需求。重新走关卡。 |
194
129
 
195
130
  ## 视觉伴侣
196
131
 
197
- 一个基于浏览器的伴侣工具,用于在头脑风暴过程中展示原型、图表和视觉选项。它是一个工具——不是一种模式。接受伴侣意味着它可用于适合视觉呈现的问题;并不意味着每个问题都要通过浏览器。
198
-
199
- **提供伴侣(在需要时才提):** **不要一上来就提。** 等到某个问题确实"画出来比说出来更清楚"时再提——要是真正的原型 / 布局 / 图表问题,而不仅仅是话题跟 UI 沾边。第一次出现这种情况时,就在那一刻提供,作为独立的一条消息:
200
- > "接下来这部分,我展示给你看可能更容易理解——我可以在讨论过程中,在一个浏览器标签页里做原型、图表和对比。这个功能还比较新,可能会消耗较多 token。要我打开吗?我来帮你打开。"
132
+ 一个浏览器标签页,用来展示原型、示意图和可交互的原型。它是一个工具,不是一种模式:接受了它,并不意味着每个问题都要搬到浏览器里。
201
133
 
202
- **此提议必须是一条独立的消息。** 只有这条提议——不含澄清问题、内容摘要或任何其他内容。等待用户回复。如果他们接受,用 `--open` 启动服务,浏览器会自动打开到第一屏。如果他们拒绝,继续纯文本进行,并且不要再提,除非他们自己提起。
134
+ **在需要的那一刻再提。** 上面列出的那些时刻第一次出现时才提出,绝不一上来就提。这个提议是一条单独的消息,里面不放任何别的东西:
203
135
 
204
- **逐问题决策:** 即使用户接受了,也要对每个问题单独决定是使用浏览器还是终端。判断标准:**用户看到它是否比读到它更容易理解?**
136
+ > "这部分我展示给你看可能更容易。要我打开一个浏览器标签页,放几个原型给你看吗?"
205
137
 
206
- - **使用浏览器** 展示本身就是视觉的内容——原型、线框图、布局对比、架构图、并排视觉设计
207
- - **使用终端** 展示文本内容——需求问题、概念选择、权衡列表、A/B/C/D 文字选项、范围决策
138
+ 如果他们拒绝,就继续用文字,除非他们自己提起,否则不要再提。
208
139
 
209
- 关于 UI 主题的问题不一定是视觉问题。"在这个上下文中个性化是什么意思?"是一个概念问题——使用终端。"哪种向导布局更好?"是一个视觉问题——使用浏览器。
140
+ **每个问题都问一下:他们看到它,会不会比读到它更容易理解?** 原型、布局、示意图和并排的设计放到浏览器里。需求、范围、权衡和概念性的选择留在文字里。一个关于 UI 话题的问题,不自动等于一个视觉问题。
210
141
 
211
- 如果他们同意使用伴侣,在继续之前阅读详细指南:
212
- `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
+ ```