bobo-ai-cli 3.0.4 → 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,85 +1,85 @@
1
- ---
2
- id: "code-review-expert"
3
- title: "Code Review Expert"
4
- category: "dev-tools"
5
- tags: ["code review expert", "review focus areas", "review output format", "summary", "critical issues 🔴", "warnings ⚠️", "suggestions 💡", "positive aspects ✅", "guidelines"]
6
- triggers: []
7
- dependencies: []
8
- source: "E:/Bobo's Coding cache/.claude/skills/code-review-expert"
9
- ---
10
-
11
- ---
12
- name: code-review-expert
13
- description: Comprehensive code review skill that analyzes code quality, identifies issues, and suggests improvements
14
- ---
15
-
16
- # Code Review Expert
17
-
18
- You are an expert code reviewer with deep knowledge of software engineering best practices, design patterns, and clean code principles.
19
-
20
- ## Review Focus Areas
21
-
22
- When reviewing code, analyze the following aspects:
23
-
24
- ### 1. Code Quality
25
-
26
- - Readability and clarity
27
- - Naming conventions (variables, functions, classes)
28
- - Code organization and structure
29
- - Comments and documentation
30
-
31
- ### 2. Logic and Correctness
32
-
33
- - Algorithm correctness
34
- - Edge case handling
35
- - Error handling and validation
36
- - Null/undefined safety
37
-
38
- ### 3. Performance
39
-
40
- - Time complexity
41
- - Space complexity
42
- - Unnecessary computations
43
- - Memory leaks potential
44
-
45
- ### 4. Security
46
-
47
- - Input validation
48
- - SQL injection vulnerabilities
49
- - XSS vulnerabilities
50
- - Sensitive data exposure
51
-
52
- ### 5. Maintainability
53
-
54
- - DRY (Don't Repeat Yourself)
55
- - SOLID principles
56
- - Coupling and cohesion
57
- - Testability
58
-
59
- ## Review Output Format
60
-
61
- Provide feedback in the following structure:
62
-
63
- ```
64
- ## Summary
65
- [Brief overview of the code and overall assessment]
66
-
67
- ## Critical Issues 🔴
68
- [Issues that must be fixed]
69
-
70
- ## Warnings ⚠️
71
- [Issues that should be addressed]
72
-
73
- ## Suggestions 💡
74
- [Improvements that would enhance the code]
75
-
76
- ## Positive Aspects ✅
77
- [What the code does well]
78
- ```
79
-
80
- ## Guidelines
81
-
82
- - Be constructive and specific
83
- - Provide code examples for suggested changes
84
- - Explain the reasoning behind each suggestion
85
- - Prioritize issues by severity
1
+ ---
2
+ id: "code-review-expert"
3
+ title: "Code Review Expert"
4
+ category: "dev-tools"
5
+ tags: ["code review expert", "review focus areas", "review output format", "summary", "critical issues 🔴", "warnings ⚠️", "suggestions 💡", "positive aspects ✅", "guidelines"]
6
+ triggers: []
7
+ dependencies: []
8
+ source: "E:/Bobo's Coding cache/.claude/skills/code-review-expert"
9
+ ---
10
+
11
+ ---
12
+ name: code-review-expert
13
+ description: Comprehensive code review skill that analyzes code quality, identifies issues, and suggests improvements
14
+ ---
15
+
16
+ # Code Review Expert
17
+
18
+ You are an expert code reviewer with deep knowledge of software engineering best practices, design patterns, and clean code principles.
19
+
20
+ ## Review Focus Areas
21
+
22
+ When reviewing code, analyze the following aspects:
23
+
24
+ ### 1. Code Quality
25
+
26
+ - Readability and clarity
27
+ - Naming conventions (variables, functions, classes)
28
+ - Code organization and structure
29
+ - Comments and documentation
30
+
31
+ ### 2. Logic and Correctness
32
+
33
+ - Algorithm correctness
34
+ - Edge case handling
35
+ - Error handling and validation
36
+ - Null/undefined safety
37
+
38
+ ### 3. Performance
39
+
40
+ - Time complexity
41
+ - Space complexity
42
+ - Unnecessary computations
43
+ - Memory leaks potential
44
+
45
+ ### 4. Security
46
+
47
+ - Input validation
48
+ - SQL injection vulnerabilities
49
+ - XSS vulnerabilities
50
+ - Sensitive data exposure
51
+
52
+ ### 5. Maintainability
53
+
54
+ - DRY (Don't Repeat Yourself)
55
+ - SOLID principles
56
+ - Coupling and cohesion
57
+ - Testability
58
+
59
+ ## Review Output Format
60
+
61
+ Provide feedback in the following structure:
62
+
63
+ ```
64
+ ## Summary
65
+ [Brief overview of the code and overall assessment]
66
+
67
+ ## Critical Issues 🔴
68
+ [Issues that must be fixed]
69
+
70
+ ## Warnings ⚠️
71
+ [Issues that should be addressed]
72
+
73
+ ## Suggestions 💡
74
+ [Improvements that would enhance the code]
75
+
76
+ ## Positive Aspects ✅
77
+ [What the code does well]
78
+ ```
79
+
80
+ ## Guidelines
81
+
82
+ - Be constructive and specific
83
+ - Provide code examples for suggested changes
84
+ - Explain the reasoning behind each suggestion
85
+ - Prioritize issues by severity
@@ -1,76 +1,76 @@
1
- ---
2
- name: context-budget-analyzer
3
- description: 上下文 Token 预算分析 — 按类别统计 token 使用(工具调用/用户消息/附件/重复文件读取),找出浪费点。适用于:(1) 对话快到 context 上限时诊断 (2) 优化长对话的 token 使用 (3) 发现重复文件读取等低效模式。灵感源自 Claude Code contextAnalysis.ts。
4
- ---
5
-
6
- # Context Budget Analyzer
7
-
8
- ## 核心理念
9
-
10
- > 不知道 token 花在哪里,就无法优化。
11
-
12
- ## 分析维度
13
-
14
- ### 1. 按消息类型
15
- ```
16
- Human messages: XXX tokens (XX%)
17
- Assistant messages: XXX tokens (XX%)
18
- Tool requests: XXX tokens (XX%)
19
- Tool results: XXX tokens (XX%)
20
- Attachments: XXX tokens (XX%)
21
- System/Other: XXX tokens (XX%)
22
- ─────────────────────────────────
23
- Total: XXX tokens
24
- ```
25
-
26
- ### 2. 按工具分布
27
- ```
28
- Tool Requests:
29
- BashTool: XXX tokens (N 次)
30
- FileRead: XXX tokens (N 次)
31
- FileEdit: XXX tokens (N 次)
32
- WebFetch: XXX tokens (N 次)
33
-
34
- Tool Results:
35
- BashTool: XXX tokens (N 次)
36
- FileRead: XXX tokens (N 次) ← 通常最大
37
- ```
38
-
39
- ### 3. 重复文件读取检测
40
-
41
- **最大浪费源之一:同一文件被 FileRead 多次。**
42
-
43
- ```
44
- ⚠️ Duplicate File Reads:
45
- src/auth.py: 3 次, ~2400 tokens 浪费
46
- src/config.ts: 2 次, ~800 tokens 浪费
47
- Total waste: ~3200 tokens
48
- ```
49
-
50
- ## 优化建议
51
-
52
- | 发现 | 优化 |
53
- |---|---|
54
- | 重复文件读取 | 一次读取后缓存内容,不要再读 |
55
- | Tool results 占比 >50% | 使用更精准的搜索(grep 替代全文件读取)|
56
- | Attachments 占比高 | 压缩前移除图片块 |
57
- | 单个 Bash 输出超大 | 加 `head -N` 或 `\| tail -N` 限制输出 |
58
- | Assistant 消息过长 | 减少重复解释,更简洁 |
59
-
60
- ## 使用方式
61
-
62
- 对话中感觉 context 紧张时,做一次快速分析:
63
-
64
- 1. 回顾本轮对话的工具调用次数
65
- 2. 识别是否有同一文件被多次读取
66
- 3. 检查 Bash 输出是否过长
67
- 4. 决定是否需要 compact
68
-
69
- ## 预算红线
70
-
71
- | 阈值 | 行动 |
72
- |---|---|
73
- | 总 token < 50% 上限 | 正常工作 |
74
- | 总 token 50-75% | 注意效率,避免大文件全量读取 |
75
- | 总 token > 75% | 考虑主动 compact |
76
- | 总 token > 90% | 立即 compact,否则下一轮可能截断 |
1
+ ---
2
+ name: context-budget-analyzer
3
+ description: 上下文 Token 预算分析 — 按类别统计 token 使用(工具调用/用户消息/附件/重复文件读取),找出浪费点。适用于:(1) 对话快到 context 上限时诊断 (2) 优化长对话的 token 使用 (3) 发现重复文件读取等低效模式。灵感源自 Claude Code contextAnalysis.ts。
4
+ ---
5
+
6
+ # Context Budget Analyzer
7
+
8
+ ## 核心理念
9
+
10
+ > 不知道 token 花在哪里,就无法优化。
11
+
12
+ ## 分析维度
13
+
14
+ ### 1. 按消息类型
15
+ ```
16
+ Human messages: XXX tokens (XX%)
17
+ Assistant messages: XXX tokens (XX%)
18
+ Tool requests: XXX tokens (XX%)
19
+ Tool results: XXX tokens (XX%)
20
+ Attachments: XXX tokens (XX%)
21
+ System/Other: XXX tokens (XX%)
22
+ ─────────────────────────────────
23
+ Total: XXX tokens
24
+ ```
25
+
26
+ ### 2. 按工具分布
27
+ ```
28
+ Tool Requests:
29
+ BashTool: XXX tokens (N 次)
30
+ FileRead: XXX tokens (N 次)
31
+ FileEdit: XXX tokens (N 次)
32
+ WebFetch: XXX tokens (N 次)
33
+
34
+ Tool Results:
35
+ BashTool: XXX tokens (N 次)
36
+ FileRead: XXX tokens (N 次) ← 通常最大
37
+ ```
38
+
39
+ ### 3. 重复文件读取检测
40
+
41
+ **最大浪费源之一:同一文件被 FileRead 多次。**
42
+
43
+ ```
44
+ ⚠️ Duplicate File Reads:
45
+ src/auth.py: 3 次, ~2400 tokens 浪费
46
+ src/config.ts: 2 次, ~800 tokens 浪费
47
+ Total waste: ~3200 tokens
48
+ ```
49
+
50
+ ## 优化建议
51
+
52
+ | 发现 | 优化 |
53
+ |---|---|
54
+ | 重复文件读取 | 一次读取后缓存内容,不要再读 |
55
+ | Tool results 占比 >50% | 使用更精准的搜索(grep 替代全文件读取)|
56
+ | Attachments 占比高 | 压缩前移除图片块 |
57
+ | 单个 Bash 输出超大 | 加 `head -N` 或 `\| tail -N` 限制输出 |
58
+ | Assistant 消息过长 | 减少重复解释,更简洁 |
59
+
60
+ ## 使用方式
61
+
62
+ 对话中感觉 context 紧张时,做一次快速分析:
63
+
64
+ 1. 回顾本轮对话的工具调用次数
65
+ 2. 识别是否有同一文件被多次读取
66
+ 3. 检查 Bash 输出是否过长
67
+ 4. 决定是否需要 compact
68
+
69
+ ## 预算红线
70
+
71
+ | 阈值 | 行动 |
72
+ |---|---|
73
+ | 总 token < 50% 上限 | 正常工作 |
74
+ | 总 token 50-75% | 注意效率,避免大文件全量读取 |
75
+ | 总 token > 75% | 考虑主动 compact |
76
+ | 总 token > 90% | 立即 compact,否则下一轮可能截断 |
@@ -1,75 +1,75 @@
1
- ---
2
- name: context-compressor
3
- description: 九段式上下文压缩 — 对话过长时生成结构化摘要,防止压缩后丢失关键上下文。解决"compact 后忘了之前在做什么"、"压缩后意图漂移"问题。适用于:(1) 对话接近 context 上限时 (2) 手动 /compact 时 (3) 需要生成对话摘要时。灵感源自 Claude Code Compact Prompt(prompt.ts 九段式模板)。
4
- ---
5
-
6
- # Context Compressor
7
-
8
- ## 核心理念
9
-
10
- > 压缩不是删除 — 是把 10 万 token 的对话浓缩成 5000 token 但不丢任何关键信息。
11
-
12
- ## 压缩前准备
13
-
14
- 1. **移除图片块** — 替换为 `[image was shared]` 文本标记
15
- 2. **不调用任何工具** — 压缩是纯文本任务,tool call 会浪费 turn
16
-
17
- ## 九段式摘要模板
18
-
19
- 先用 `<analysis>` 整理思路(草稿,不进入最终上下文),再输出 `<summary>`:
20
-
21
- ```
22
- <analysis>
23
- [按时间顺序分析每条消息,确保覆盖所有要点]
24
- </analysis>
25
-
26
- <summary>
27
- 1. 用户请求和意图
28
- [所有明确请求,完整详述]
29
-
30
- 2. 关键技术概念
31
- - [技术/框架/方案列表]
32
-
33
- 3. 文件和代码
34
- - [文件名]
35
- - 为什么重要
36
- - 做了什么修改
37
- - 关键代码片段
38
-
39
- 4. 错误和修复
40
- - [错误描述]
41
- - 如何修复
42
- - 用户对此的反馈(如有)
43
-
44
- 5. 问题解决
45
- [已解决的问题 + 正在排查的问题]
46
-
47
- 6. 所有用户消息
48
- - [列出全部非工具结果的用户消息]
49
- (⚠️ 这是捕捉用户意图变化的关键)
50
-
51
- 7. 待办任务
52
- - [明确被要求但未完成的任务]
53
-
54
- 8. 当前工作
55
- [压缩前正在做的事,附文件名和代码片段]
56
-
57
- 9. 下一步(可选)
58
- [必须与最近请求直接相关]
59
- > 原文引用:"用户说了什么" → 防止意图漂移
60
- </summary>
61
- ```
62
-
63
- ## 关键规则
64
-
65
- - **第 6 段(用户消息)是最重要的** — 不列用户消息 = 丢失意图变化
66
- - **第 8 段必须具体** — 不是"正在修复 bug",而是"正在修复 src/auth.py:42 的空指针,已加了 null check 但测试还没跑"
67
- - **第 9 段必须附原文引用** — 防止压缩后做跑偏的事
68
- - **不要开始新的、切线的任务** — 只延续压缩前正在做的
69
-
70
- ## 压缩后恢复
71
-
72
- 压缩完成后自动恢复:
73
- - 最近修改的文件内容(最多 5 个文件)
74
- - 活跃 Skill 的指令重注入
75
- - 工具列表变更提示
1
+ ---
2
+ name: context-compressor
3
+ description: 九段式上下文压缩 — 对话过长时生成结构化摘要,防止压缩后丢失关键上下文。解决"compact 后忘了之前在做什么"、"压缩后意图漂移"问题。适用于:(1) 对话接近 context 上限时 (2) 手动 /compact 时 (3) 需要生成对话摘要时。灵感源自 Claude Code Compact Prompt(prompt.ts 九段式模板)。
4
+ ---
5
+
6
+ # Context Compressor
7
+
8
+ ## 核心理念
9
+
10
+ > 压缩不是删除 — 是把 10 万 token 的对话浓缩成 5000 token 但不丢任何关键信息。
11
+
12
+ ## 压缩前准备
13
+
14
+ 1. **移除图片块** — 替换为 `[image was shared]` 文本标记
15
+ 2. **不调用任何工具** — 压缩是纯文本任务,tool call 会浪费 turn
16
+
17
+ ## 九段式摘要模板
18
+
19
+ 先用 `<analysis>` 整理思路(草稿,不进入最终上下文),再输出 `<summary>`:
20
+
21
+ ```
22
+ <analysis>
23
+ [按时间顺序分析每条消息,确保覆盖所有要点]
24
+ </analysis>
25
+
26
+ <summary>
27
+ 1. 用户请求和意图
28
+ [所有明确请求,完整详述]
29
+
30
+ 2. 关键技术概念
31
+ - [技术/框架/方案列表]
32
+
33
+ 3. 文件和代码
34
+ - [文件名]
35
+ - 为什么重要
36
+ - 做了什么修改
37
+ - 关键代码片段
38
+
39
+ 4. 错误和修复
40
+ - [错误描述]
41
+ - 如何修复
42
+ - 用户对此的反馈(如有)
43
+
44
+ 5. 问题解决
45
+ [已解决的问题 + 正在排查的问题]
46
+
47
+ 6. 所有用户消息
48
+ - [列出全部非工具结果的用户消息]
49
+ (⚠️ 这是捕捉用户意图变化的关键)
50
+
51
+ 7. 待办任务
52
+ - [明确被要求但未完成的任务]
53
+
54
+ 8. 当前工作
55
+ [压缩前正在做的事,附文件名和代码片段]
56
+
57
+ 9. 下一步(可选)
58
+ [必须与最近请求直接相关]
59
+ > 原文引用:"用户说了什么" → 防止意图漂移
60
+ </summary>
61
+ ```
62
+
63
+ ## 关键规则
64
+
65
+ - **第 6 段(用户消息)是最重要的** — 不列用户消息 = 丢失意图变化
66
+ - **第 8 段必须具体** — 不是"正在修复 bug",而是"正在修复 src/auth.py:42 的空指针,已加了 null check 但测试还没跑"
67
+ - **第 9 段必须附原文引用** — 防止压缩后做跑偏的事
68
+ - **不要开始新的、切线的任务** — 只延续压缩前正在做的
69
+
70
+ ## 压缩后恢复
71
+
72
+ 压缩完成后自动恢复:
73
+ - 最近修改的文件内容(最多 5 个文件)
74
+ - 活跃 Skill 的指令重注入
75
+ - 工具列表变更提示