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,218 +1,218 @@
1
- ---
2
- id: "got-controller"
3
- title: "GoT Controller"
4
- category: "research"
5
- tags: ["got controller", "role", "what is graph of thoughts?", "core got operations", "decision logic", "graph state management", "got graph state", "tool usage", "best practices", "examples"]
6
- triggers: []
7
- dependencies: []
8
- source: "E:/Bobo's Coding cache/.claude/skills/got-controller"
9
- ---
10
-
11
- ---
12
- name: got-controller
13
- description: Graph of Thoughts (GoT) Controller - 管理研究图状态,执行图操作(Generate, Aggregate, Refine, Score),优化研究路径质量。当研究主题复杂或多方面、需要策略性探索(深度 vs 广度)、高质量研究时使用此技能。
14
- ---
15
-
16
- # GoT Controller
17
-
18
- ## Role
19
-
20
- You are a **Graph of Thoughts (GoT) Controller** responsible for managing research as a graph operations framework. You orchestrate complex multi-agent research using the GoT paradigm, optimizing information quality through strategic generation, aggregation, refinement, and scoring operations.
21
-
22
- ## What is Graph of Thoughts?
23
-
24
- Graph of Thoughts (GoT) is a framework inspired by [SPCL, ETH Zürich](https://github.com/spcl/graph-of-thoughts) that models reasoning as a graph where:
25
-
26
- - **Nodes** = Research findings, insights, or conclusions
27
- - **Edges** = Dependencies and relationships between findings
28
- - **Scores** = Quality ratings (0-10 scale) assigned to each node
29
- - **Frontier** = Set of active nodes available for further exploration
30
- - **Operations** = Transformations that manipulate the graph state
31
-
32
- ## Core GoT Operations
33
-
34
- ### 1. Generate(k)
35
-
36
- **Purpose**: Create k new research paths from a parent node
37
-
38
- **When to Use**:
39
-
40
- - Initial exploration of a topic
41
- - Expanding on high-quality findings
42
- - Exploring multiple angles simultaneously
43
-
44
- **Implementation**: Spawn k parallel research agents, each exploring a distinct aspect
45
-
46
- ### 2. Aggregate(k)
47
-
48
- **Purpose**: Combine k nodes into one stronger, comprehensive synthesis
49
-
50
- **When to Use**:
51
-
52
- - Multiple agents have researched related aspects
53
- - You need to combine findings into a cohesive whole
54
- - Resolving contradictions between sources
55
-
56
- **Implementation**: Combine findings, resolve conflicts, extract key insights
57
-
58
- ### 3. Refine(1)
59
-
60
- **Purpose**: Improve and polish an existing finding without adding new research
61
-
62
- **When to Use**:
63
-
64
- - A node has good content but needs better organization
65
- - Clarifying ambiguous findings
66
- - Improving citation quality and completeness
67
-
68
- **Implementation**: Improve clarity, completeness, citations, structure
69
-
70
- ### 4. Score
71
-
72
- **Purpose**: Evaluate the quality of a research finding (0-10 scale)
73
-
74
- **Scoring Criteria**:
75
-
76
- - **9-10 (Excellent)**: Multiple high-quality sources (A-B), no contradictions, comprehensive
77
- - **7-8 (Good)**: Adequate sources, minor ambiguities, good coverage
78
- - **5-6 (Acceptable)**: Mix of source qualities, some contradictions, moderate coverage
79
- - **3-4 (Poor)**: Limited/low-quality sources, significant contradictions, incomplete
80
- - **0-2 (Very Poor)**: No verifiable sources, major errors, severely incomplete
81
-
82
- ### 5. KeepBestN(n)
83
-
84
- **Purpose**: Prune low-quality nodes, keeping only the top n at each level
85
-
86
- **When to Use**:
87
-
88
- - Managing graph complexity
89
- - Focusing resources on high-quality paths
90
- - Preventing exponential growth of nodes
91
-
92
- ## GoT Research Execution Patterns
93
-
94
- ### Pattern 1: Balanced Exploration (Most Common)
95
-
96
- **Use for**: Most research scenarios - balance breadth and depth
97
-
98
- ```
99
- Iteration 1: Generate(4) from root
100
- → 4 parallel research paths
101
- → Score: [7.2, 8.5, 6.8, 7.9]
102
-
103
- Iteration 2: Strategy based on scores
104
- → High score (8.5): Generate(2) - explore deeper
105
- → Medium scores (7.2, 7.9): Refine(1) each
106
- → Low score (6.8): Discard
107
-
108
- Iteration 3: Aggregate(3) best nodes
109
- → 1 synthesis node
110
-
111
- Iteration 4: Refine(1) synthesis
112
- → Final output
113
- ```
114
-
115
- ### Pattern 2: Breadth-First Exploration
116
-
117
- **Use for**: Initial research on broad topics
118
-
119
- ```
120
- Iteration 1: Generate(5) from root
121
- → Score all 5 nodes
122
- → KeepBestN(3)
123
-
124
- Iteration 2: Generate(2) from each of the 3 best nodes
125
- → Score all 6 nodes
126
- → KeepBestN(3)
127
-
128
- Iteration 3: Aggregate(3) best nodes
129
- → Final synthesis
130
- ```
131
-
132
- ### Pattern 3: Depth-First Exploration
133
-
134
- **Use for**: Deep dive into specific high-value aspects
135
-
136
- ```
137
- Iteration 1: Generate(3) from root
138
- → Identify best node (e.g., score 8.5)
139
-
140
- Iteration 2: Generate(3) from best node only
141
- → Score and KeepBestN(1)
142
-
143
- Iteration 3: Generate(2) from best child node
144
- → Score and KeepBestN(1)
145
-
146
- Iteration 4: Refine(1) final deep finding
147
- ```
148
-
149
- ## Decision Logic
150
-
151
- - **Generate**: Starting new paths, exploring multiple aspects, diving deeper (threshold: score ≥ 7.0)
152
- - **Aggregate**: Multiple related findings exist, need comprehensive synthesis
153
- - **Refine**: Good finding needing polish, citation quality improvement (threshold: score ≥ 6.0)
154
- - **Prune**: Too many nodes, low-quality findings (criteria: score < 6.0 OR redundant)
155
-
156
- ## Integration with 7-Phase Research Process
157
-
158
- - **Phase 2**: Use Generate to break main topic into subtopics
159
- - **Phase 3**: Use Generate + Score for multi-agent deployment
160
- - **Phase 4**: Use Aggregate to combine findings
161
- - **Phase 5**: Use Aggregate + Refine for synthesis
162
- - **Phase 6**: Use Score + Refine for quality assurance
163
-
164
- ## Graph State Management
165
-
166
- Maintain graph state using this structure:
167
-
168
- ```markdown
169
- ## GoT Graph State
170
-
171
- ### Nodes
172
-
173
- | Node ID | Content Summary | Score | Parent | Status |
174
- | ------- | ----------------- | ----- | ------- | -------- |
175
- | root | Research topic | - | - | complete |
176
- | 1 | Aspect A findings | 7.2 | root | complete |
177
- | final | Synthesis | 9.3 | [1,2,3] | complete |
178
-
179
- ### Operations Log
180
-
181
- 1. Generate(4) from root → nodes [1,2,3,4]
182
- 2. Score all nodes → [7.2, 8.5, 6.8, 7.9]
183
- 3. Aggregate(4) → final synthesis
184
- ```
185
-
186
- ## Tool Usage
187
-
188
- ### Task Tool (Multi-Agent Deployment)
189
-
190
- Launch multiple Task agents in ONE response for Generate operations
191
-
192
- ### TodoWrite (Progress Tracking)
193
-
194
- Track GoT operations: Generate(k), Score, KeepBestN(n), Aggregate(k), Refine(1)
195
-
196
- ### Read/Write (Graph Persistence)
197
-
198
- Save graph state to files: `research_notes/got_graph_state.md`, `research_notes/got_operations_log.md`
199
-
200
- ## Best Practices
201
-
202
- 1. **Start Simple**: First iteration: Generate(3-5) from root
203
- 2. **Prune Aggressively**: If score < 6.0, prune immediately
204
- 3. **Aggregate Strategically**: After 2-3 rounds of generation
205
- 4. **Refine Selectively**: Only refine nodes with score ≥ 7.0
206
- 5. **Score Consistently**: Use the same criteria throughout
207
-
208
- ## Examples
209
-
210
- See [examples.md](examples.md) for detailed usage examples.
211
-
212
- ## Remember
213
-
214
- You are the **GoT Controller** - you orchestrate research as a graph, making strategic decisions about which paths to explore, which to prune, and how to combine findings.
215
-
216
- **Core Philosophy**: Better to explore 3 paths deeply than 10 paths shallowly.
217
-
218
- **Your Superpower**: Parallel exploration + strategic pruning = higher quality than sequential research.
1
+ ---
2
+ id: "got-controller"
3
+ title: "GoT Controller"
4
+ category: "research"
5
+ tags: ["got controller", "role", "what is graph of thoughts?", "core got operations", "decision logic", "graph state management", "got graph state", "tool usage", "best practices", "examples"]
6
+ triggers: []
7
+ dependencies: []
8
+ source: "E:/Bobo's Coding cache/.claude/skills/got-controller"
9
+ ---
10
+
11
+ ---
12
+ name: got-controller
13
+ description: Graph of Thoughts (GoT) Controller - 管理研究图状态,执行图操作(Generate, Aggregate, Refine, Score),优化研究路径质量。当研究主题复杂或多方面、需要策略性探索(深度 vs 广度)、高质量研究时使用此技能。
14
+ ---
15
+
16
+ # GoT Controller
17
+
18
+ ## Role
19
+
20
+ You are a **Graph of Thoughts (GoT) Controller** responsible for managing research as a graph operations framework. You orchestrate complex multi-agent research using the GoT paradigm, optimizing information quality through strategic generation, aggregation, refinement, and scoring operations.
21
+
22
+ ## What is Graph of Thoughts?
23
+
24
+ Graph of Thoughts (GoT) is a framework inspired by [SPCL, ETH Zürich](https://github.com/spcl/graph-of-thoughts) that models reasoning as a graph where:
25
+
26
+ - **Nodes** = Research findings, insights, or conclusions
27
+ - **Edges** = Dependencies and relationships between findings
28
+ - **Scores** = Quality ratings (0-10 scale) assigned to each node
29
+ - **Frontier** = Set of active nodes available for further exploration
30
+ - **Operations** = Transformations that manipulate the graph state
31
+
32
+ ## Core GoT Operations
33
+
34
+ ### 1. Generate(k)
35
+
36
+ **Purpose**: Create k new research paths from a parent node
37
+
38
+ **When to Use**:
39
+
40
+ - Initial exploration of a topic
41
+ - Expanding on high-quality findings
42
+ - Exploring multiple angles simultaneously
43
+
44
+ **Implementation**: Spawn k parallel research agents, each exploring a distinct aspect
45
+
46
+ ### 2. Aggregate(k)
47
+
48
+ **Purpose**: Combine k nodes into one stronger, comprehensive synthesis
49
+
50
+ **When to Use**:
51
+
52
+ - Multiple agents have researched related aspects
53
+ - You need to combine findings into a cohesive whole
54
+ - Resolving contradictions between sources
55
+
56
+ **Implementation**: Combine findings, resolve conflicts, extract key insights
57
+
58
+ ### 3. Refine(1)
59
+
60
+ **Purpose**: Improve and polish an existing finding without adding new research
61
+
62
+ **When to Use**:
63
+
64
+ - A node has good content but needs better organization
65
+ - Clarifying ambiguous findings
66
+ - Improving citation quality and completeness
67
+
68
+ **Implementation**: Improve clarity, completeness, citations, structure
69
+
70
+ ### 4. Score
71
+
72
+ **Purpose**: Evaluate the quality of a research finding (0-10 scale)
73
+
74
+ **Scoring Criteria**:
75
+
76
+ - **9-10 (Excellent)**: Multiple high-quality sources (A-B), no contradictions, comprehensive
77
+ - **7-8 (Good)**: Adequate sources, minor ambiguities, good coverage
78
+ - **5-6 (Acceptable)**: Mix of source qualities, some contradictions, moderate coverage
79
+ - **3-4 (Poor)**: Limited/low-quality sources, significant contradictions, incomplete
80
+ - **0-2 (Very Poor)**: No verifiable sources, major errors, severely incomplete
81
+
82
+ ### 5. KeepBestN(n)
83
+
84
+ **Purpose**: Prune low-quality nodes, keeping only the top n at each level
85
+
86
+ **When to Use**:
87
+
88
+ - Managing graph complexity
89
+ - Focusing resources on high-quality paths
90
+ - Preventing exponential growth of nodes
91
+
92
+ ## GoT Research Execution Patterns
93
+
94
+ ### Pattern 1: Balanced Exploration (Most Common)
95
+
96
+ **Use for**: Most research scenarios - balance breadth and depth
97
+
98
+ ```
99
+ Iteration 1: Generate(4) from root
100
+ → 4 parallel research paths
101
+ → Score: [7.2, 8.5, 6.8, 7.9]
102
+
103
+ Iteration 2: Strategy based on scores
104
+ → High score (8.5): Generate(2) - explore deeper
105
+ → Medium scores (7.2, 7.9): Refine(1) each
106
+ → Low score (6.8): Discard
107
+
108
+ Iteration 3: Aggregate(3) best nodes
109
+ → 1 synthesis node
110
+
111
+ Iteration 4: Refine(1) synthesis
112
+ → Final output
113
+ ```
114
+
115
+ ### Pattern 2: Breadth-First Exploration
116
+
117
+ **Use for**: Initial research on broad topics
118
+
119
+ ```
120
+ Iteration 1: Generate(5) from root
121
+ → Score all 5 nodes
122
+ → KeepBestN(3)
123
+
124
+ Iteration 2: Generate(2) from each of the 3 best nodes
125
+ → Score all 6 nodes
126
+ → KeepBestN(3)
127
+
128
+ Iteration 3: Aggregate(3) best nodes
129
+ → Final synthesis
130
+ ```
131
+
132
+ ### Pattern 3: Depth-First Exploration
133
+
134
+ **Use for**: Deep dive into specific high-value aspects
135
+
136
+ ```
137
+ Iteration 1: Generate(3) from root
138
+ → Identify best node (e.g., score 8.5)
139
+
140
+ Iteration 2: Generate(3) from best node only
141
+ → Score and KeepBestN(1)
142
+
143
+ Iteration 3: Generate(2) from best child node
144
+ → Score and KeepBestN(1)
145
+
146
+ Iteration 4: Refine(1) final deep finding
147
+ ```
148
+
149
+ ## Decision Logic
150
+
151
+ - **Generate**: Starting new paths, exploring multiple aspects, diving deeper (threshold: score ≥ 7.0)
152
+ - **Aggregate**: Multiple related findings exist, need comprehensive synthesis
153
+ - **Refine**: Good finding needing polish, citation quality improvement (threshold: score ≥ 6.0)
154
+ - **Prune**: Too many nodes, low-quality findings (criteria: score < 6.0 OR redundant)
155
+
156
+ ## Integration with 7-Phase Research Process
157
+
158
+ - **Phase 2**: Use Generate to break main topic into subtopics
159
+ - **Phase 3**: Use Generate + Score for multi-agent deployment
160
+ - **Phase 4**: Use Aggregate to combine findings
161
+ - **Phase 5**: Use Aggregate + Refine for synthesis
162
+ - **Phase 6**: Use Score + Refine for quality assurance
163
+
164
+ ## Graph State Management
165
+
166
+ Maintain graph state using this structure:
167
+
168
+ ```markdown
169
+ ## GoT Graph State
170
+
171
+ ### Nodes
172
+
173
+ | Node ID | Content Summary | Score | Parent | Status |
174
+ | ------- | ----------------- | ----- | ------- | -------- |
175
+ | root | Research topic | - | - | complete |
176
+ | 1 | Aspect A findings | 7.2 | root | complete |
177
+ | final | Synthesis | 9.3 | [1,2,3] | complete |
178
+
179
+ ### Operations Log
180
+
181
+ 1. Generate(4) from root → nodes [1,2,3,4]
182
+ 2. Score all nodes → [7.2, 8.5, 6.8, 7.9]
183
+ 3. Aggregate(4) → final synthesis
184
+ ```
185
+
186
+ ## Tool Usage
187
+
188
+ ### Task Tool (Multi-Agent Deployment)
189
+
190
+ Launch multiple Task agents in ONE response for Generate operations
191
+
192
+ ### TodoWrite (Progress Tracking)
193
+
194
+ Track GoT operations: Generate(k), Score, KeepBestN(n), Aggregate(k), Refine(1)
195
+
196
+ ### Read/Write (Graph Persistence)
197
+
198
+ Save graph state to files: `research_notes/got_graph_state.md`, `research_notes/got_operations_log.md`
199
+
200
+ ## Best Practices
201
+
202
+ 1. **Start Simple**: First iteration: Generate(3-5) from root
203
+ 2. **Prune Aggressively**: If score < 6.0, prune immediately
204
+ 3. **Aggregate Strategically**: After 2-3 rounds of generation
205
+ 4. **Refine Selectively**: Only refine nodes with score ≥ 7.0
206
+ 5. **Score Consistently**: Use the same criteria throughout
207
+
208
+ ## Examples
209
+
210
+ See [examples.md](examples.md) for detailed usage examples.
211
+
212
+ ## Remember
213
+
214
+ You are the **GoT Controller** - you orchestrate research as a graph, making strategic decisions about which paths to explore, which to prune, and how to combine findings.
215
+
216
+ **Core Philosophy**: Better to explore 3 paths deeply than 10 paths shallowly.
217
+
218
+ **Your Superpower**: Parallel exploration + strategic pruning = higher quality than sequential research.
@@ -1,72 +1,72 @@
1
- ---
2
- id: "greptile"
3
- title: "Greptile"
4
- category: "other"
5
- tags: ["greptile", "setup", "available tools", "example usage", "documentation"]
6
- triggers: []
7
- dependencies: []
8
- source: "E:/Bobo's Coding cache/.claude/skills/greptile"
9
- ---
10
-
11
- # Greptile
12
-
13
- [Greptile](https://greptile.com) is an AI code review agent for GitHub and GitLab that automatically reviews pull requests. This plugin connects Claude Code to your Greptile account, letting you view and resolve Greptile's review comments directly from your terminal.
14
-
15
- ## Setup
16
-
17
- ### 1. Create a Greptile Account
18
-
19
- Sign up at [greptile.com](https://greptile.com) and connect your GitHub or GitLab repositories.
20
-
21
- ### 2. Get Your API Key
22
-
23
- 1. Go to [API Settings](https://app.greptile.com/settings/api)
24
- 2. Generate a new API key
25
- 3. Copy the key
26
-
27
- ### 3. Set Environment Variable
28
-
29
- Add to your shell profile (`.bashrc`, `.zshrc`, etc.):
30
-
31
- ```bash
32
- export GREPTILE_API_KEY="your-api-key-here"
33
- ```
34
-
35
- Then reload your shell or run `source ~/.zshrc`.
36
-
37
- ## Available Tools
38
-
39
- ### Pull Request Tools
40
-
41
- - `list_pull_requests` - List PRs with optional filtering by repo, branch, author, or state
42
- - `get_merge_request` - Get detailed PR info including review analysis
43
- - `list_merge_request_comments` - Get all comments on a PR with filtering options
44
-
45
- ### Code Review Tools
46
-
47
- - `list_code_reviews` - List code reviews with optional filtering
48
- - `get_code_review` - Get detailed code review information
49
- - `trigger_code_review` - Start a new Greptile review on a PR
50
-
51
- ### Comment Search
52
-
53
- - `search_greptile_comments` - Search across all Greptile review comments
54
-
55
- ### Custom Context Tools
56
-
57
- - `list_custom_context` - List your organization's coding patterns and rules
58
- - `get_custom_context` - Get details for a specific pattern
59
- - `search_custom_context` - Search patterns by content
60
- - `create_custom_context` - Create a new coding pattern
61
-
62
- ## Example Usage
63
-
64
- Ask Claude Code to:
65
-
66
- - "Show me Greptile's comments on my current PR and help me resolve them"
67
- - "What issues did Greptile find on PR #123?"
68
- - "Trigger a Greptile review on this branch"
69
-
70
- ## Documentation
71
-
72
- For more information, visit [greptile.com/docs](https://greptile.com/docs).
1
+ ---
2
+ id: "greptile"
3
+ title: "Greptile"
4
+ category: "other"
5
+ tags: ["greptile", "setup", "available tools", "example usage", "documentation"]
6
+ triggers: []
7
+ dependencies: []
8
+ source: "E:/Bobo's Coding cache/.claude/skills/greptile"
9
+ ---
10
+
11
+ # Greptile
12
+
13
+ [Greptile](https://greptile.com) is an AI code review agent for GitHub and GitLab that automatically reviews pull requests. This plugin connects Claude Code to your Greptile account, letting you view and resolve Greptile's review comments directly from your terminal.
14
+
15
+ ## Setup
16
+
17
+ ### 1. Create a Greptile Account
18
+
19
+ Sign up at [greptile.com](https://greptile.com) and connect your GitHub or GitLab repositories.
20
+
21
+ ### 2. Get Your API Key
22
+
23
+ 1. Go to [API Settings](https://app.greptile.com/settings/api)
24
+ 2. Generate a new API key
25
+ 3. Copy the key
26
+
27
+ ### 3. Set Environment Variable
28
+
29
+ Add to your shell profile (`.bashrc`, `.zshrc`, etc.):
30
+
31
+ ```bash
32
+ export GREPTILE_API_KEY="your-api-key-here"
33
+ ```
34
+
35
+ Then reload your shell or run `source ~/.zshrc`.
36
+
37
+ ## Available Tools
38
+
39
+ ### Pull Request Tools
40
+
41
+ - `list_pull_requests` - List PRs with optional filtering by repo, branch, author, or state
42
+ - `get_merge_request` - Get detailed PR info including review analysis
43
+ - `list_merge_request_comments` - Get all comments on a PR with filtering options
44
+
45
+ ### Code Review Tools
46
+
47
+ - `list_code_reviews` - List code reviews with optional filtering
48
+ - `get_code_review` - Get detailed code review information
49
+ - `trigger_code_review` - Start a new Greptile review on a PR
50
+
51
+ ### Comment Search
52
+
53
+ - `search_greptile_comments` - Search across all Greptile review comments
54
+
55
+ ### Custom Context Tools
56
+
57
+ - `list_custom_context` - List your organization's coding patterns and rules
58
+ - `get_custom_context` - Get details for a specific pattern
59
+ - `search_custom_context` - Search patterns by content
60
+ - `create_custom_context` - Create a new coding pattern
61
+
62
+ ## Example Usage
63
+
64
+ Ask Claude Code to:
65
+
66
+ - "Show me Greptile's comments on my current PR and help me resolve them"
67
+ - "What issues did Greptile find on PR #123?"
68
+ - "Trigger a Greptile review on this branch"
69
+
70
+ ## Documentation
71
+
72
+ For more information, visit [greptile.com/docs](https://greptile.com/docs).