bobo-ai-cli 3.0.3 → 3.0.5

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 (238) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +259 -259
  3. package/bundled-skills/CORE_SKILLS.txt +18 -18
  4. package/bundled-skills/backend-expert/SKILL.md +97 -97
  5. package/bundled-skills/code-review/SKILL.md +280 -280
  6. package/bundled-skills/code-review-expert/SKILL.md +85 -85
  7. package/bundled-skills/context-budget-analyzer/SKILL.md +76 -76
  8. package/bundled-skills/context-compressor/SKILL.md +75 -75
  9. package/bundled-skills/context-optimization-suite/SKILL.md +162 -162
  10. package/bundled-skills/frontend-expert/SKILL.md +93 -93
  11. package/bundled-skills/github/SKILL.md +12 -12
  12. package/bundled-skills/high-agency/SKILL.md +473 -473
  13. package/bundled-skills/high-agency/references/builder-patterns.md +126 -126
  14. package/bundled-skills/high-agency/references/recovery-playbook.md +298 -298
  15. package/bundled-skills/memory-manager/SKILL.md +214 -214
  16. package/bundled-skills/memory-manager/references/advanced-config.md +65 -65
  17. package/bundled-skills/orchestrator/SKILL.md +681 -681
  18. package/bundled-skills/planning-with-files/SKILL.md +193 -193
  19. package/bundled-skills/skill-creator/SKILL.md +220 -220
  20. package/bundled-skills/testing-expert/SKILL.md +99 -99
  21. package/bundled-skills/verify/SKILL.md +15 -15
  22. package/dist/agent.d.ts +5 -0
  23. package/dist/agent.js +11 -1
  24. package/dist/agent.js.map +1 -1
  25. package/dist/agents/catalog.d.ts +47 -0
  26. package/dist/agents/catalog.js +63 -5
  27. package/dist/agents/catalog.js.map +1 -1
  28. package/dist/agents/router.d.ts +12 -1
  29. package/dist/agents/router.js +43 -3
  30. package/dist/agents/router.js.map +1 -1
  31. package/dist/agents/spawn.js +36 -18
  32. package/dist/agents/spawn.js.map +1 -1
  33. package/dist/autonomous.js +5 -5
  34. package/dist/cli.js +23 -21
  35. package/dist/cli.js.map +1 -1
  36. package/dist/compactor.js +39 -39
  37. package/dist/dream.js +29 -29
  38. package/dist/image-input.d.ts +44 -0
  39. package/dist/image-input.js +161 -0
  40. package/dist/image-input.js.map +1 -0
  41. package/dist/memory.js +13 -13
  42. package/dist/project.js +15 -15
  43. package/dist/repl.js +88 -0
  44. package/dist/repl.js.map +1 -1
  45. package/dist/skills.js +54 -54
  46. package/dist/sub-agents.js +65 -65
  47. package/dist/tools/browser.js +21 -21
  48. package/dist/tools/claude-code.js +10 -10
  49. package/dist/web.js +7 -7
  50. package/dist/wiki-commands.d.ts +2 -0
  51. package/dist/wiki-commands.js +249 -0
  52. package/dist/wiki-commands.js.map +1 -0
  53. package/dist/wiki.d.ts +90 -0
  54. package/dist/wiki.js +614 -0
  55. package/dist/wiki.js.map +1 -0
  56. package/knowledge/advanced-patterns.md +70 -70
  57. package/knowledge/agent-directives.md +74 -74
  58. package/knowledge/api-integration-patterns.md +102 -0
  59. package/knowledge/code-review-protocol.md +69 -0
  60. package/knowledge/dream.md +36 -36
  61. package/knowledge/engineering.md +52 -46
  62. package/knowledge/error-catalog.md +38 -33
  63. package/knowledge/event-driven-architecture.md +43 -0
  64. package/knowledge/external-alignment.md +47 -0
  65. package/knowledge/high-agency.md +73 -0
  66. package/knowledge/image-generation.md +48 -0
  67. package/knowledge/index.json +194 -169
  68. package/knowledge/llm-wiki-pattern.md +71 -0
  69. package/knowledge/long-task-management.md +79 -0
  70. package/knowledge/memory/cache-optimization-and-skill-integration.md +102 -102
  71. package/knowledge/memory/engineering-patterns.md +134 -134
  72. package/knowledge/memory/feedback_root_structure.md +15 -15
  73. package/knowledge/memory/project-contexts.md +69 -69
  74. package/knowledge/memory/tools-and-services.md +85 -85
  75. package/knowledge/memory-management.md +72 -0
  76. package/knowledge/rules/advisor-strategy.md +204 -0
  77. package/knowledge/rules/agents.md +62 -62
  78. package/knowledge/rules/blocking-rules.md +323 -323
  79. package/knowledge/rules/cache-management.md +379 -379
  80. package/knowledge/rules/capability-evolution.md +132 -132
  81. package/knowledge/rules/coding.md +126 -126
  82. package/knowledge/rules/engineering-workflows.md +225 -225
  83. package/knowledge/rules/evomap-content-guidelines.md +354 -354
  84. package/knowledge/rules/evomap-guide.md +224 -224
  85. package/knowledge/rules/external-alignment.md +22 -0
  86. package/knowledge/rules/git.md +31 -31
  87. package/knowledge/rules/hooks.md +106 -106
  88. package/knowledge/rules/performance.md +101 -101
  89. package/knowledge/rules/remotion-auto-production.md +1120 -1120
  90. package/knowledge/rules/security.md +46 -46
  91. package/knowledge/rules/testing.md +32 -32
  92. package/knowledge/rules/work-mode.md +208 -208
  93. package/knowledge/rules.md +62 -62
  94. package/knowledge/self-evolution.md +78 -0
  95. package/knowledge/self-rationalization-guard.md +52 -0
  96. package/knowledge/skills/Skill_Seekers.md +1722 -1722
  97. package/knowledge/skills/ab-test-setup.md +557 -557
  98. package/knowledge/skills/agent-sdk-dev.md +238 -238
  99. package/knowledge/skills/agent-tools.md +136 -136
  100. package/knowledge/skills/analytics-tracking.md +597 -597
  101. package/knowledge/skills/artifacts-builder.md +89 -89
  102. package/knowledge/skills/asana.md +12 -12
  103. package/knowledge/skills/backend-expert.md +97 -97
  104. package/knowledge/skills/brand-voice.md +481 -481
  105. package/knowledge/skills/browser-use.md +419 -419
  106. package/knowledge/skills/cache-optimization-skill.md +179 -179
  107. package/knowledge/skills/canvas-design.md +147 -147
  108. package/knowledge/skills/citation-validator.md +203 -203
  109. package/knowledge/skills/clangd-lsp.md +52 -52
  110. package/knowledge/skills/code-review-expert.md +85 -85
  111. package/knowledge/skills/code-review.md +280 -280
  112. package/knowledge/skills/code-simplifier.md +12 -12
  113. package/knowledge/skills/commit-commands.md +258 -258
  114. package/knowledge/skills/competitor-alternatives.md +795 -795
  115. package/knowledge/skills/content-atomizer.md +910 -910
  116. package/knowledge/skills/content-research-writer.md +605 -605
  117. package/knowledge/skills/context-optimization-suite.md +162 -162
  118. package/knowledge/skills/context7.md +12 -12
  119. package/knowledge/skills/copy-editing.md +494 -494
  120. package/knowledge/skills/copywriting.md +510 -510
  121. package/knowledge/skills/csharp-lsp.md +40 -40
  122. package/knowledge/skills/decision-making-framework.md +154 -154
  123. package/knowledge/skills/developer-growth-analysis.md +335 -335
  124. package/knowledge/skills/direct-response-copy.md +2336 -2336
  125. package/knowledge/skills/docker-expert.md +229 -229
  126. package/knowledge/skills/document-skills.md +12 -12
  127. package/knowledge/skills/documentation-expert.md +126 -126
  128. package/knowledge/skills/email-sequence.md +1061 -1061
  129. package/knowledge/skills/email-sequences.md +910 -910
  130. package/knowledge/skills/example-plugin.md +72 -72
  131. package/knowledge/skills/explanatory-output-style.md +82 -82
  132. package/knowledge/skills/feature-dev.md +458 -458
  133. package/knowledge/skills/file-organizer.md +466 -466
  134. package/knowledge/skills/firebase.disabled.md +12 -12
  135. package/knowledge/skills/form-cro.md +488 -488
  136. package/knowledge/skills/free-tool-strategy.md +636 -636
  137. package/knowledge/skills/frontend-design-offical.md +55 -55
  138. package/knowledge/skills/frontend-design.md +41 -41
  139. package/knowledge/skills/frontend-expert.md +93 -93
  140. package/knowledge/skills/github.md +12 -12
  141. package/knowledge/skills/gitlab.md +12 -12
  142. package/knowledge/skills/gopls-lsp.md +32 -32
  143. package/knowledge/skills/got-controller.md +218 -218
  144. package/knowledge/skills/greptile.md +72 -72
  145. package/knowledge/skills/hookify.md +376 -376
  146. package/knowledge/skills/image-editor.md +189 -189
  147. package/knowledge/skills/image-enhancer.md +109 -109
  148. package/knowledge/skills/jdtls-lsp.md +49 -49
  149. package/knowledge/skills/json-canvas.md +654 -654
  150. package/knowledge/skills/keyword-research.md +559 -559
  151. package/knowledge/skills/kotlin-lsp.md +28 -28
  152. package/knowledge/skills/laravel-boost.md +12 -12
  153. package/knowledge/skills/launch-strategy.md +394 -394
  154. package/knowledge/skills/lead-magnet.md +393 -393
  155. package/knowledge/skills/learning-output-style.md +106 -106
  156. package/knowledge/skills/linear.md +12 -12
  157. package/knowledge/skills/lua-lsp.md +47 -47
  158. package/knowledge/skills/marketing-ideas.md +720 -720
  159. package/knowledge/skills/marketing-psychology.md +534 -534
  160. package/knowledge/skills/mcp-builder.md +369 -369
  161. package/knowledge/skills/meeting-insights-analyzer.md +347 -347
  162. package/knowledge/skills/memory-evolution-system.md +172 -172
  163. package/knowledge/skills/multi-lens-thinking.md +407 -407
  164. package/knowledge/skills/nano-banana-pro.md +116 -116
  165. package/knowledge/skills/newsletter.md +736 -736
  166. package/knowledge/skills/notebooklm.md +296 -296
  167. package/knowledge/skills/obsidian-bases.md +634 -634
  168. package/knowledge/skills/obsidian-markdown.md +651 -651
  169. package/knowledge/skills/onboarding-cro.md +494 -494
  170. package/knowledge/skills/orchestrator.md +681 -681
  171. package/knowledge/skills/page-cro.md +379 -379
  172. package/knowledge/skills/paid-ads.md +624 -624
  173. package/knowledge/skills/paywall-upgrade-cro.md +651 -651
  174. package/knowledge/skills/php-lsp.md +36 -36
  175. package/knowledge/skills/planning-with-files.md +193 -193
  176. package/knowledge/skills/playwright.md +12 -12
  177. package/knowledge/skills/plugin-dev.md +434 -434
  178. package/knowledge/skills/popup-cro.md +520 -520
  179. package/knowledge/skills/positioning-angles.md +330 -330
  180. package/knowledge/skills/pr-review-toolkit.md +359 -359
  181. package/knowledge/skills/pricing-strategy.md +777 -777
  182. package/knowledge/skills/programmatic-seo.md +714 -714
  183. package/knowledge/skills/pyright-lsp.md +43 -43
  184. package/knowledge/skills/quality-assurance-framework.md +168 -168
  185. package/knowledge/skills/question-refiner.md +160 -160
  186. package/knowledge/skills/ralph-loop.md +205 -205
  187. package/knowledge/skills/refactoring-expert.md +103 -103
  188. package/knowledge/skills/referral-program.md +668 -668
  189. package/knowledge/skills/research-executor.md +164 -164
  190. package/knowledge/skills/review-with-security.md +12 -12
  191. package/knowledge/skills/rust-analyzer-lsp.md +50 -50
  192. package/knowledge/skills/schema-markup.md +647 -647
  193. package/knowledge/skills/security-audit-expert.md +124 -124
  194. package/knowledge/skills/security-expert.md +140 -140
  195. package/knowledge/skills/security-guidance.md +12 -12
  196. package/knowledge/skills/seedance-prompt.md +139 -139
  197. package/knowledge/skills/self-evolution.md +1160 -1160
  198. package/knowledge/skills/seo-audit.md +432 -432
  199. package/knowledge/skills/seo-content.md +787 -787
  200. package/knowledge/skills/serena.md +12 -12
  201. package/knowledge/skills/signup-flow-cro.md +409 -409
  202. package/knowledge/skills/skill-creator.md +220 -220
  203. package/knowledge/skills/skill-manager.md +226 -226
  204. package/knowledge/skills/skill-share.md +98 -98
  205. package/knowledge/skills/slack.md +12 -12
  206. package/knowledge/skills/social-content.md +878 -878
  207. package/knowledge/skills/spec-flow-skill.md +124 -124
  208. package/knowledge/skills/stripe.md +12 -12
  209. package/knowledge/skills/supabase.md +12 -12
  210. package/knowledge/skills/swift-lsp.md +40 -40
  211. package/knowledge/skills/synthesizer.md +236 -236
  212. package/knowledge/skills/template-skill.md +16 -16
  213. package/knowledge/skills/testing-expert.md +99 -99
  214. package/knowledge/skills/theme-factory.md +72 -72
  215. package/knowledge/skills/tiktok-research.md +208 -208
  216. package/knowledge/skills/typescript-lsp.md +36 -36
  217. package/knowledge/skills/ui-ux-pro-max.md +247 -247
  218. package/knowledge/skills/verify.md +15 -15
  219. package/knowledge/skills/visual-prompt-engineer.md +102 -102
  220. package/knowledge/skills/webapp-testing.md +111 -111
  221. package/knowledge/skills/wide-research.md +191 -191
  222. package/knowledge/system.md +93 -93
  223. package/knowledge/task-router.md +46 -37
  224. package/knowledge/verification.md +38 -38
  225. package/knowledge/worker-prompt-craft.md +66 -0
  226. package/knowledge/workflows/3d-viz.md +47 -47
  227. package/knowledge/workflows/data-pipeline.md +47 -47
  228. package/knowledge/workflows/db-migration.md +51 -51
  229. package/knowledge/workflows/feature-dev.md +41 -41
  230. package/knowledge/workflows/tdd-flow.md +52 -52
  231. package/knowledge/workflows/ui-verify.md +51 -51
  232. package/package.json +74 -74
  233. package/dist/claude-bridge.d.ts +0 -18
  234. package/dist/claude-bridge.js +0 -91
  235. package/dist/claude-bridge.js.map +0 -1
  236. package/dist/tools/claude-bridge-tool.d.ts +0 -4
  237. package/dist/tools/claude-bridge-tool.js +0 -44
  238. package/dist/tools/claude-bridge-tool.js.map +0 -1
@@ -1,106 +1,106 @@
1
- ---
2
- id: "hooks"
3
- title: "Hooks System"
4
- category: "root"
5
- tags: ["hooks system", "hook types", "hook files", "lifecycle coverage", "auto-accept permissions", "todowrite best practices"]
6
- source: "C:/Users/Administrator/.claude/rules/hooks.md"
7
- ---
8
-
9
- # Hooks System
10
-
11
- > **版本**: v2.0 (2026-02-10 更新)
12
-
13
- ## Hook Types
14
-
15
- - **PreToolUse**: Before tool execution (validation, parameter modification)
16
- - **PostToolUse**: After tool execution (auto-format, checks)
17
- - **Stop**: When session ends (final verification)
18
- - **SubagentStop**: When sub-agent completes
19
- - **SessionStart**: When session begins (auto-learning)
20
-
21
- ## Current Hooks (in ~/.claude/settings.json)
22
-
23
- ### PreToolUse
24
-
25
- | Hook | Matcher | Purpose |
26
- | ------------------------ | ------- | --------------------------------------- |
27
- | **pre-bash.sh** | Bash | Validate bash commands before execution |
28
- | **pre-edit.sh** | Edit | Validate file edits before applying |
29
- | **enhance-tool-call.sh** | \* | Enhance all tool calls with context |
30
- | **vibecraft-hook.js** | \* | VibeCraft integration for all tools |
31
-
32
- ### PostToolUse
33
-
34
- | Hook | Matcher | Purpose |
35
- | --------------------- | ------- | ----------------------------------------- |
36
- | **post-bash.sh** | Bash | Post-process bash output |
37
- | **post-edit.sh** | Edit | Auto-format, TypeScript check after edits |
38
- | **vibecraft-hook.js** | \* | VibeCraft post-processing |
39
-
40
- ### Stop
41
-
42
- | Hook | Purpose |
43
- | --------------------- | ---------------------- |
44
- | **vibecraft-hook.js** | Session-end processing |
45
-
46
- ### SubagentStop
47
-
48
- | Hook | Purpose |
49
- | --------------------- | ----------------------------- |
50
- | **vibecraft-hook.js** | Sub-agent completion tracking |
51
-
52
- ### SessionStart
53
-
54
- | Hook | Purpose |
55
- | ---------------------- | --------------------------------------- |
56
- | **learn-patterns.sh** | Auto-learn coding patterns from session |
57
- | **session-summary.sh** | Initialize session tracking |
58
-
59
- ## Hook Files
60
-
61
- Located in `~/.claude/hooks/`:
62
-
63
- ```
64
- ~/.claude/hooks/
65
- ├── enhance-tool-call.sh # Context enhancement for all tools
66
- ├── learn-patterns.sh # Auto-learn patterns (SessionStart)
67
- ├── post-bash.sh # Post-bash processing
68
- ├── post-edit.sh # Post-edit formatting & checks
69
- ├── pre-bash.sh # Pre-bash validation
70
- ├── pre-edit.sh # Pre-edit validation
71
- └── session-summary.sh # Session summary generation
72
- ```
73
-
74
- ## Lifecycle Coverage
75
-
76
- ```
77
- SessionStart → learn-patterns.sh (auto-learn)
78
-
79
- PreToolUse → pre-bash/pre-edit + enhance + vibecraft
80
-
81
- [Tool Execution]
82
-
83
- PostToolUse → post-bash/post-edit + vibecraft
84
-
85
- SubagentStop → vibecraft (sub-agent tracking)
86
-
87
- Stop → vibecraft (session-end)
88
- ```
89
-
90
- ## Auto-Accept Permissions
91
-
92
- Use with caution:
93
-
94
- - Enable for trusted, well-defined plans
95
- - Disable for exploratory work
96
- - Never use dangerously-skip-permissions flag
97
- - Configure `allowedTools` in `~/.claude.json` instead
98
-
99
- ## TodoWrite Best Practices
100
-
101
- Use TodoWrite tool to:
102
-
103
- - Track progress on multi-step tasks
104
- - Verify understanding of instructions
105
- - Enable real-time steering
106
- - Show granular implementation steps
1
+ ---
2
+ id: "hooks"
3
+ title: "Hooks System"
4
+ category: "root"
5
+ tags: ["hooks system", "hook types", "hook files", "lifecycle coverage", "auto-accept permissions", "todowrite best practices"]
6
+ source: "C:/Users/Administrator/.claude/rules/hooks.md"
7
+ ---
8
+
9
+ # Hooks System
10
+
11
+ > **版本**: v2.0 (2026-02-10 更新)
12
+
13
+ ## Hook Types
14
+
15
+ - **PreToolUse**: Before tool execution (validation, parameter modification)
16
+ - **PostToolUse**: After tool execution (auto-format, checks)
17
+ - **Stop**: When session ends (final verification)
18
+ - **SubagentStop**: When sub-agent completes
19
+ - **SessionStart**: When session begins (auto-learning)
20
+
21
+ ## Current Hooks (in ~/.claude/settings.json)
22
+
23
+ ### PreToolUse
24
+
25
+ | Hook | Matcher | Purpose |
26
+ | ------------------------ | ------- | --------------------------------------- |
27
+ | **pre-bash.sh** | Bash | Validate bash commands before execution |
28
+ | **pre-edit.sh** | Edit | Validate file edits before applying |
29
+ | **enhance-tool-call.sh** | \* | Enhance all tool calls with context |
30
+ | **vibecraft-hook.js** | \* | VibeCraft integration for all tools |
31
+
32
+ ### PostToolUse
33
+
34
+ | Hook | Matcher | Purpose |
35
+ | --------------------- | ------- | ----------------------------------------- |
36
+ | **post-bash.sh** | Bash | Post-process bash output |
37
+ | **post-edit.sh** | Edit | Auto-format, TypeScript check after edits |
38
+ | **vibecraft-hook.js** | \* | VibeCraft post-processing |
39
+
40
+ ### Stop
41
+
42
+ | Hook | Purpose |
43
+ | --------------------- | ---------------------- |
44
+ | **vibecraft-hook.js** | Session-end processing |
45
+
46
+ ### SubagentStop
47
+
48
+ | Hook | Purpose |
49
+ | --------------------- | ----------------------------- |
50
+ | **vibecraft-hook.js** | Sub-agent completion tracking |
51
+
52
+ ### SessionStart
53
+
54
+ | Hook | Purpose |
55
+ | ---------------------- | --------------------------------------- |
56
+ | **learn-patterns.sh** | Auto-learn coding patterns from session |
57
+ | **session-summary.sh** | Initialize session tracking |
58
+
59
+ ## Hook Files
60
+
61
+ Located in `~/.claude/hooks/`:
62
+
63
+ ```
64
+ ~/.claude/hooks/
65
+ ├── enhance-tool-call.sh # Context enhancement for all tools
66
+ ├── learn-patterns.sh # Auto-learn patterns (SessionStart)
67
+ ├── post-bash.sh # Post-bash processing
68
+ ├── post-edit.sh # Post-edit formatting & checks
69
+ ├── pre-bash.sh # Pre-bash validation
70
+ ├── pre-edit.sh # Pre-edit validation
71
+ └── session-summary.sh # Session summary generation
72
+ ```
73
+
74
+ ## Lifecycle Coverage
75
+
76
+ ```
77
+ SessionStart → learn-patterns.sh (auto-learn)
78
+
79
+ PreToolUse → pre-bash/pre-edit + enhance + vibecraft
80
+
81
+ [Tool Execution]
82
+
83
+ PostToolUse → post-bash/post-edit + vibecraft
84
+
85
+ SubagentStop → vibecraft (sub-agent tracking)
86
+
87
+ Stop → vibecraft (session-end)
88
+ ```
89
+
90
+ ## Auto-Accept Permissions
91
+
92
+ Use with caution:
93
+
94
+ - Enable for trusted, well-defined plans
95
+ - Disable for exploratory work
96
+ - Never use dangerously-skip-permissions flag
97
+ - Configure `allowedTools` in `~/.claude.json` instead
98
+
99
+ ## TodoWrite Best Practices
100
+
101
+ Use TodoWrite tool to:
102
+
103
+ - Track progress on multi-step tasks
104
+ - Verify understanding of instructions
105
+ - Enable real-time steering
106
+ - Show granular implementation steps
@@ -1,101 +1,101 @@
1
- ---
2
- id: "performance"
3
- title: "Performance Optimization"
4
- category: "root"
5
- tags: ["performance optimization", "model selection strategy", "context window management", "ultrathink + plan mode", "build troubleshooting"]
6
- source: "C:/Users/Administrator/.claude/rules/performance.md"
7
- ---
8
-
9
- # Performance Optimization
10
-
11
- > **新增**: Cache Management (2026-04-01) — 详见 `domain/cache-management.md`
12
-
13
- ## Cache & Token Optimization (优先级最高)
14
-
15
- **立即应用**:
16
-
17
- 1. **使用 cc-cache-fix** — 安装 `claude-patched` 替代 `claude`
18
- - 补丁1: Delta 附件持久化 → +30% 缓存命中
19
- - 补丁2: Hash 稳定性 → +20% 缓存命中
20
- - 补丁3: TTL 1小时 → +15% 缓存命中
21
- - **总计**: ~60% token 节省
22
-
23
- 2. **按需加载 Context** — 不全量加载 CLAUDE.md
24
- - Layer 0: 核心规则 (20KB)
25
- - Layer 1: Task Router (3KB)
26
- - Layer 2: 相关能力 (15-30KB)
27
- - Layer 3: 具体案例 (按需)
28
-
29
- 3. **会话分割** — 长任务 (>1小时) 分成 3-5 个短会话
30
- - 每个会话独立缓存
31
- - 使用 `task_plan.md` 保存进度
32
- - 总 token 节省 30-40%
33
-
34
- 4. **缓存预热** — 会话开始时加载常用上下文
35
- - 加载 CLAUDE.md + 核心规则 + 记忆
36
- - 预计算常见操作
37
- - 首次操作 token -30%
38
-
39
- **验证效果**:
40
- ```bash
41
- claude-patched
42
- python cc-cache-fix/test_cache.py
43
- python cc-cache-fix/usage_audit.py
44
- ```
45
-
46
- **预期结果**: 60-70% token 节省(相对基准)
47
-
48
- ---
49
-
50
- ## Model Selection Strategy
51
-
52
- **Haiku 4.5** (90% of Sonnet capability, 3x cost savings):
53
-
54
- - Lightweight agents with frequent invocation
55
- - Pair programming and code generation
56
- - Worker agents in multi-agent systems
57
-
58
- **Sonnet 4.5** (Best coding model):
59
-
60
- - Main development work
61
- - Orchestrating multi-agent workflows
62
- - Complex coding tasks
63
-
64
- **Opus 4.5** (Deepest reasoning):
65
-
66
- - Complex architectural decisions
67
- - Maximum reasoning requirements
68
- - Research and analysis tasks
69
-
70
- ## Context Window Management
71
-
72
- Avoid last 20% of context window for:
73
-
74
- - Large-scale refactoring
75
- - Feature implementation spanning multiple files
76
- - Debugging complex interactions
77
-
78
- Lower context sensitivity tasks:
79
-
80
- - Single-file edits
81
- - Independent utility creation
82
- - Documentation updates
83
- - Simple bug fixes
84
-
85
- ## Ultrathink + Plan Mode
86
-
87
- For complex tasks requiring deep reasoning:
88
-
89
- 1. Use `ultrathink` for enhanced thinking
90
- 2. Enable **Plan Mode** for structured approach
91
- 3. "Rev the engine" with multiple critique rounds
92
- 4. Use split role sub-agents for diverse analysis
93
-
94
- ## Build Troubleshooting
95
-
96
- If build fails:
97
-
98
- 1. Use **build-error-resolver** agent
99
- 2. Analyze error messages
100
- 3. Fix incrementally
101
- 4. Verify after each fix
1
+ ---
2
+ id: "performance"
3
+ title: "Performance Optimization"
4
+ category: "root"
5
+ tags: ["performance optimization", "model selection strategy", "context window management", "ultrathink + plan mode", "build troubleshooting"]
6
+ source: "C:/Users/Administrator/.claude/rules/performance.md"
7
+ ---
8
+
9
+ # Performance Optimization
10
+
11
+ > **新增**: Cache Management (2026-04-01) — 详见 `domain/cache-management.md`
12
+
13
+ ## Cache & Token Optimization (优先级最高)
14
+
15
+ **立即应用**:
16
+
17
+ 1. **使用 cc-cache-fix** — 安装 `claude-patched` 替代 `claude`
18
+ - 补丁1: Delta 附件持久化 → +30% 缓存命中
19
+ - 补丁2: Hash 稳定性 → +20% 缓存命中
20
+ - 补丁3: TTL 1小时 → +15% 缓存命中
21
+ - **总计**: ~60% token 节省
22
+
23
+ 2. **按需加载 Context** — 不全量加载 CLAUDE.md
24
+ - Layer 0: 核心规则 (20KB)
25
+ - Layer 1: Task Router (3KB)
26
+ - Layer 2: 相关能力 (15-30KB)
27
+ - Layer 3: 具体案例 (按需)
28
+
29
+ 3. **会话分割** — 长任务 (>1小时) 分成 3-5 个短会话
30
+ - 每个会话独立缓存
31
+ - 使用 `task_plan.md` 保存进度
32
+ - 总 token 节省 30-40%
33
+
34
+ 4. **缓存预热** — 会话开始时加载常用上下文
35
+ - 加载 CLAUDE.md + 核心规则 + 记忆
36
+ - 预计算常见操作
37
+ - 首次操作 token -30%
38
+
39
+ **验证效果**:
40
+ ```bash
41
+ claude-patched
42
+ python cc-cache-fix/test_cache.py
43
+ python cc-cache-fix/usage_audit.py
44
+ ```
45
+
46
+ **预期结果**: 60-70% token 节省(相对基准)
47
+
48
+ ---
49
+
50
+ ## Model Selection Strategy
51
+
52
+ **Haiku 4.5** (90% of Sonnet capability, 3x cost savings):
53
+
54
+ - Lightweight agents with frequent invocation
55
+ - Pair programming and code generation
56
+ - Worker agents in multi-agent systems
57
+
58
+ **Sonnet 4.5** (Best coding model):
59
+
60
+ - Main development work
61
+ - Orchestrating multi-agent workflows
62
+ - Complex coding tasks
63
+
64
+ **Opus 4.5** (Deepest reasoning):
65
+
66
+ - Complex architectural decisions
67
+ - Maximum reasoning requirements
68
+ - Research and analysis tasks
69
+
70
+ ## Context Window Management
71
+
72
+ Avoid last 20% of context window for:
73
+
74
+ - Large-scale refactoring
75
+ - Feature implementation spanning multiple files
76
+ - Debugging complex interactions
77
+
78
+ Lower context sensitivity tasks:
79
+
80
+ - Single-file edits
81
+ - Independent utility creation
82
+ - Documentation updates
83
+ - Simple bug fixes
84
+
85
+ ## Ultrathink + Plan Mode
86
+
87
+ For complex tasks requiring deep reasoning:
88
+
89
+ 1. Use `ultrathink` for enhanced thinking
90
+ 2. Enable **Plan Mode** for structured approach
91
+ 3. "Rev the engine" with multiple critique rounds
92
+ 4. Use split role sub-agents for diverse analysis
93
+
94
+ ## Build Troubleshooting
95
+
96
+ If build fails:
97
+
98
+ 1. Use **build-error-resolver** agent
99
+ 2. Analyze error messages
100
+ 3. Fix incrementally
101
+ 4. Verify after each fix