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.
- package/LICENSE +21 -21
- package/README.md +259 -259
- package/bundled-skills/CORE_SKILLS.txt +18 -18
- package/bundled-skills/backend-expert/SKILL.md +97 -97
- package/bundled-skills/code-review/SKILL.md +280 -280
- package/bundled-skills/code-review-expert/SKILL.md +85 -85
- package/bundled-skills/context-budget-analyzer/SKILL.md +76 -76
- package/bundled-skills/context-compressor/SKILL.md +75 -75
- package/bundled-skills/context-optimization-suite/SKILL.md +162 -162
- package/bundled-skills/frontend-expert/SKILL.md +93 -93
- package/bundled-skills/github/SKILL.md +12 -12
- package/bundled-skills/high-agency/SKILL.md +473 -473
- package/bundled-skills/high-agency/references/builder-patterns.md +126 -126
- package/bundled-skills/high-agency/references/recovery-playbook.md +298 -298
- package/bundled-skills/memory-manager/SKILL.md +214 -214
- package/bundled-skills/memory-manager/references/advanced-config.md +65 -65
- package/bundled-skills/orchestrator/SKILL.md +681 -681
- package/bundled-skills/planning-with-files/SKILL.md +193 -193
- package/bundled-skills/skill-creator/SKILL.md +220 -220
- package/bundled-skills/testing-expert/SKILL.md +99 -99
- package/bundled-skills/verify/SKILL.md +15 -15
- package/dist/agent.d.ts +5 -0
- package/dist/agent.js +11 -1
- package/dist/agent.js.map +1 -1
- package/dist/agents/catalog.d.ts +47 -0
- package/dist/agents/catalog.js +63 -5
- package/dist/agents/catalog.js.map +1 -1
- package/dist/agents/router.d.ts +12 -1
- package/dist/agents/router.js +43 -3
- package/dist/agents/router.js.map +1 -1
- package/dist/agents/spawn.js +36 -18
- package/dist/agents/spawn.js.map +1 -1
- package/dist/autonomous.js +5 -5
- package/dist/cli.js +23 -21
- package/dist/cli.js.map +1 -1
- package/dist/compactor.js +39 -39
- package/dist/dream.js +29 -29
- package/dist/image-input.d.ts +44 -0
- package/dist/image-input.js +161 -0
- package/dist/image-input.js.map +1 -0
- package/dist/memory.js +13 -13
- package/dist/project.js +15 -15
- package/dist/repl.js +88 -0
- package/dist/repl.js.map +1 -1
- package/dist/skills.js +54 -54
- package/dist/sub-agents.js +65 -65
- package/dist/tools/browser.js +21 -21
- package/dist/tools/claude-code.js +10 -10
- package/dist/web.js +7 -7
- package/dist/wiki-commands.d.ts +2 -0
- package/dist/wiki-commands.js +249 -0
- package/dist/wiki-commands.js.map +1 -0
- package/dist/wiki.d.ts +90 -0
- package/dist/wiki.js +614 -0
- package/dist/wiki.js.map +1 -0
- package/knowledge/advanced-patterns.md +70 -70
- package/knowledge/agent-directives.md +74 -74
- package/knowledge/api-integration-patterns.md +102 -0
- package/knowledge/code-review-protocol.md +69 -0
- package/knowledge/dream.md +36 -36
- package/knowledge/engineering.md +52 -46
- package/knowledge/error-catalog.md +38 -33
- package/knowledge/event-driven-architecture.md +43 -0
- package/knowledge/external-alignment.md +47 -0
- package/knowledge/high-agency.md +73 -0
- package/knowledge/image-generation.md +48 -0
- package/knowledge/index.json +194 -169
- package/knowledge/llm-wiki-pattern.md +71 -0
- package/knowledge/long-task-management.md +79 -0
- package/knowledge/memory/cache-optimization-and-skill-integration.md +102 -102
- package/knowledge/memory/engineering-patterns.md +134 -134
- package/knowledge/memory/feedback_root_structure.md +15 -15
- package/knowledge/memory/project-contexts.md +69 -69
- package/knowledge/memory/tools-and-services.md +85 -85
- package/knowledge/memory-management.md +72 -0
- package/knowledge/rules/advisor-strategy.md +204 -0
- package/knowledge/rules/agents.md +62 -62
- package/knowledge/rules/blocking-rules.md +323 -323
- package/knowledge/rules/cache-management.md +379 -379
- package/knowledge/rules/capability-evolution.md +132 -132
- package/knowledge/rules/coding.md +126 -126
- package/knowledge/rules/engineering-workflows.md +225 -225
- package/knowledge/rules/evomap-content-guidelines.md +354 -354
- package/knowledge/rules/evomap-guide.md +224 -224
- package/knowledge/rules/external-alignment.md +22 -0
- package/knowledge/rules/git.md +31 -31
- package/knowledge/rules/hooks.md +106 -106
- package/knowledge/rules/performance.md +101 -101
- package/knowledge/rules/remotion-auto-production.md +1120 -1120
- package/knowledge/rules/security.md +46 -46
- package/knowledge/rules/testing.md +32 -32
- package/knowledge/rules/work-mode.md +208 -208
- package/knowledge/rules.md +62 -62
- package/knowledge/self-evolution.md +78 -0
- package/knowledge/self-rationalization-guard.md +52 -0
- package/knowledge/skills/Skill_Seekers.md +1722 -1722
- package/knowledge/skills/ab-test-setup.md +557 -557
- package/knowledge/skills/agent-sdk-dev.md +238 -238
- package/knowledge/skills/agent-tools.md +136 -136
- package/knowledge/skills/analytics-tracking.md +597 -597
- package/knowledge/skills/artifacts-builder.md +89 -89
- package/knowledge/skills/asana.md +12 -12
- package/knowledge/skills/backend-expert.md +97 -97
- package/knowledge/skills/brand-voice.md +481 -481
- package/knowledge/skills/browser-use.md +419 -419
- package/knowledge/skills/cache-optimization-skill.md +179 -179
- package/knowledge/skills/canvas-design.md +147 -147
- package/knowledge/skills/citation-validator.md +203 -203
- package/knowledge/skills/clangd-lsp.md +52 -52
- package/knowledge/skills/code-review-expert.md +85 -85
- package/knowledge/skills/code-review.md +280 -280
- package/knowledge/skills/code-simplifier.md +12 -12
- package/knowledge/skills/commit-commands.md +258 -258
- package/knowledge/skills/competitor-alternatives.md +795 -795
- package/knowledge/skills/content-atomizer.md +910 -910
- package/knowledge/skills/content-research-writer.md +605 -605
- package/knowledge/skills/context-optimization-suite.md +162 -162
- package/knowledge/skills/context7.md +12 -12
- package/knowledge/skills/copy-editing.md +494 -494
- package/knowledge/skills/copywriting.md +510 -510
- package/knowledge/skills/csharp-lsp.md +40 -40
- package/knowledge/skills/decision-making-framework.md +154 -154
- package/knowledge/skills/developer-growth-analysis.md +335 -335
- package/knowledge/skills/direct-response-copy.md +2336 -2336
- package/knowledge/skills/docker-expert.md +229 -229
- package/knowledge/skills/document-skills.md +12 -12
- package/knowledge/skills/documentation-expert.md +126 -126
- package/knowledge/skills/email-sequence.md +1061 -1061
- package/knowledge/skills/email-sequences.md +910 -910
- package/knowledge/skills/example-plugin.md +72 -72
- package/knowledge/skills/explanatory-output-style.md +82 -82
- package/knowledge/skills/feature-dev.md +458 -458
- package/knowledge/skills/file-organizer.md +466 -466
- package/knowledge/skills/firebase.disabled.md +12 -12
- package/knowledge/skills/form-cro.md +488 -488
- package/knowledge/skills/free-tool-strategy.md +636 -636
- package/knowledge/skills/frontend-design-offical.md +55 -55
- package/knowledge/skills/frontend-design.md +41 -41
- package/knowledge/skills/frontend-expert.md +93 -93
- package/knowledge/skills/github.md +12 -12
- package/knowledge/skills/gitlab.md +12 -12
- package/knowledge/skills/gopls-lsp.md +32 -32
- package/knowledge/skills/got-controller.md +218 -218
- package/knowledge/skills/greptile.md +72 -72
- package/knowledge/skills/hookify.md +376 -376
- package/knowledge/skills/image-editor.md +189 -189
- package/knowledge/skills/image-enhancer.md +109 -109
- package/knowledge/skills/jdtls-lsp.md +49 -49
- package/knowledge/skills/json-canvas.md +654 -654
- package/knowledge/skills/keyword-research.md +559 -559
- package/knowledge/skills/kotlin-lsp.md +28 -28
- package/knowledge/skills/laravel-boost.md +12 -12
- package/knowledge/skills/launch-strategy.md +394 -394
- package/knowledge/skills/lead-magnet.md +393 -393
- package/knowledge/skills/learning-output-style.md +106 -106
- package/knowledge/skills/linear.md +12 -12
- package/knowledge/skills/lua-lsp.md +47 -47
- package/knowledge/skills/marketing-ideas.md +720 -720
- package/knowledge/skills/marketing-psychology.md +534 -534
- package/knowledge/skills/mcp-builder.md +369 -369
- package/knowledge/skills/meeting-insights-analyzer.md +347 -347
- package/knowledge/skills/memory-evolution-system.md +172 -172
- package/knowledge/skills/multi-lens-thinking.md +407 -407
- package/knowledge/skills/nano-banana-pro.md +116 -116
- package/knowledge/skills/newsletter.md +736 -736
- package/knowledge/skills/notebooklm.md +296 -296
- package/knowledge/skills/obsidian-bases.md +634 -634
- package/knowledge/skills/obsidian-markdown.md +651 -651
- package/knowledge/skills/onboarding-cro.md +494 -494
- package/knowledge/skills/orchestrator.md +681 -681
- package/knowledge/skills/page-cro.md +379 -379
- package/knowledge/skills/paid-ads.md +624 -624
- package/knowledge/skills/paywall-upgrade-cro.md +651 -651
- package/knowledge/skills/php-lsp.md +36 -36
- package/knowledge/skills/planning-with-files.md +193 -193
- package/knowledge/skills/playwright.md +12 -12
- package/knowledge/skills/plugin-dev.md +434 -434
- package/knowledge/skills/popup-cro.md +520 -520
- package/knowledge/skills/positioning-angles.md +330 -330
- package/knowledge/skills/pr-review-toolkit.md +359 -359
- package/knowledge/skills/pricing-strategy.md +777 -777
- package/knowledge/skills/programmatic-seo.md +714 -714
- package/knowledge/skills/pyright-lsp.md +43 -43
- package/knowledge/skills/quality-assurance-framework.md +168 -168
- package/knowledge/skills/question-refiner.md +160 -160
- package/knowledge/skills/ralph-loop.md +205 -205
- package/knowledge/skills/refactoring-expert.md +103 -103
- package/knowledge/skills/referral-program.md +668 -668
- package/knowledge/skills/research-executor.md +164 -164
- package/knowledge/skills/review-with-security.md +12 -12
- package/knowledge/skills/rust-analyzer-lsp.md +50 -50
- package/knowledge/skills/schema-markup.md +647 -647
- package/knowledge/skills/security-audit-expert.md +124 -124
- package/knowledge/skills/security-expert.md +140 -140
- package/knowledge/skills/security-guidance.md +12 -12
- package/knowledge/skills/seedance-prompt.md +139 -139
- package/knowledge/skills/self-evolution.md +1160 -1160
- package/knowledge/skills/seo-audit.md +432 -432
- package/knowledge/skills/seo-content.md +787 -787
- package/knowledge/skills/serena.md +12 -12
- package/knowledge/skills/signup-flow-cro.md +409 -409
- package/knowledge/skills/skill-creator.md +220 -220
- package/knowledge/skills/skill-manager.md +226 -226
- package/knowledge/skills/skill-share.md +98 -98
- package/knowledge/skills/slack.md +12 -12
- package/knowledge/skills/social-content.md +878 -878
- package/knowledge/skills/spec-flow-skill.md +124 -124
- package/knowledge/skills/stripe.md +12 -12
- package/knowledge/skills/supabase.md +12 -12
- package/knowledge/skills/swift-lsp.md +40 -40
- package/knowledge/skills/synthesizer.md +236 -236
- package/knowledge/skills/template-skill.md +16 -16
- package/knowledge/skills/testing-expert.md +99 -99
- package/knowledge/skills/theme-factory.md +72 -72
- package/knowledge/skills/tiktok-research.md +208 -208
- package/knowledge/skills/typescript-lsp.md +36 -36
- package/knowledge/skills/ui-ux-pro-max.md +247 -247
- package/knowledge/skills/verify.md +15 -15
- package/knowledge/skills/visual-prompt-engineer.md +102 -102
- package/knowledge/skills/webapp-testing.md +111 -111
- package/knowledge/skills/wide-research.md +191 -191
- package/knowledge/system.md +93 -93
- package/knowledge/task-router.md +46 -37
- package/knowledge/verification.md +38 -38
- package/knowledge/worker-prompt-craft.md +66 -0
- package/knowledge/workflows/3d-viz.md +47 -47
- package/knowledge/workflows/data-pipeline.md +47 -47
- package/knowledge/workflows/db-migration.md +51 -51
- package/knowledge/workflows/feature-dev.md +41 -41
- package/knowledge/workflows/tdd-flow.md +52 -52
- package/knowledge/workflows/ui-verify.md +51 -51
- package/package.json +74 -74
- package/dist/claude-bridge.d.ts +0 -18
- package/dist/claude-bridge.js +0 -91
- package/dist/claude-bridge.js.map +0 -1
- package/dist/tools/claude-bridge-tool.d.ts +0 -4
- package/dist/tools/claude-bridge-tool.js +0 -44
- 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
|
+
- 工具列表变更提示
|