superkit-mcp-server 1.2.4 → 1.2.6

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 (162) hide show
  1. package/ARCHITECTURE.md +102 -102
  2. package/README.md +71 -71
  3. package/SUPERKIT.md +168 -168
  4. package/agents/code-archaeologist.md +106 -106
  5. package/agents/coder.md +90 -90
  6. package/agents/data-engineer.md +28 -28
  7. package/agents/devops-engineer.md +242 -242
  8. package/agents/git-manager.md +203 -203
  9. package/agents/orchestrator.md +420 -420
  10. package/agents/penetration-tester.md +188 -188
  11. package/agents/performance-optimizer.md +187 -187
  12. package/agents/planner.md +270 -270
  13. package/agents/qa-automation-engineer.md +103 -103
  14. package/agents/quant-developer.md +32 -32
  15. package/agents/reviewer.md +100 -100
  16. package/agents/scout.md +222 -222
  17. package/agents/tester.md +274 -274
  18. package/agents/ui-designer.md +208 -208
  19. package/build/__tests__/test_apply_prompt_args.js +104 -0
  20. package/build/index.js +106 -45
  21. package/build/tools/todoTools.js +39 -39
  22. package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
  23. package/build/tools/validators/__tests__/convertRules.test.js +5 -5
  24. package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
  25. package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
  26. package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
  27. package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
  28. package/build/tools/validators/__tests__/securityScan.test.js +6 -6
  29. package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
  30. package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
  31. package/commands/README.md +122 -122
  32. package/commands/ask.toml +72 -72
  33. package/commands/brainstorm.toml +119 -119
  34. package/commands/chat.toml +77 -77
  35. package/commands/code-preview.toml +37 -37
  36. package/commands/code.toml +28 -28
  37. package/commands/content.toml +200 -200
  38. package/commands/cook.toml +77 -77
  39. package/commands/copywrite.toml +131 -131
  40. package/commands/db.toml +192 -192
  41. package/commands/debug.toml +166 -166
  42. package/commands/design.toml +158 -158
  43. package/commands/dev-rules.toml +14 -14
  44. package/commands/do.toml +117 -117
  45. package/commands/doc-rules.toml +14 -14
  46. package/commands/docs.toml +148 -148
  47. package/commands/fix.toml +440 -440
  48. package/commands/fullstack.toml +175 -175
  49. package/commands/git.toml +235 -235
  50. package/commands/help.toml +84 -84
  51. package/commands/integrate.toml +127 -127
  52. package/commands/journal.toml +136 -136
  53. package/commands/kit-setup.toml +40 -40
  54. package/commands/mcp.toml +183 -183
  55. package/commands/orchestration.toml +15 -15
  56. package/commands/plan.toml +206 -172
  57. package/commands/pm.toml +148 -148
  58. package/commands/pr.toml +50 -50
  59. package/commands/project.toml +32 -32
  60. package/commands/research.toml +117 -117
  61. package/commands/review-pr.toml +63 -63
  62. package/commands/review.toml +190 -190
  63. package/commands/scout-ext.toml +97 -97
  64. package/commands/scout.toml +79 -79
  65. package/commands/screenshot.toml +65 -65
  66. package/commands/session.toml +102 -102
  67. package/commands/skill.toml +384 -384
  68. package/commands/status.toml +22 -22
  69. package/commands/team.toml +56 -56
  70. package/commands/test.toml +164 -164
  71. package/commands/ticket.toml +70 -70
  72. package/commands/use.toml +106 -106
  73. package/commands/video.toml +83 -83
  74. package/commands/watzup.toml +71 -71
  75. package/commands/workflow.toml +14 -14
  76. package/package.json +35 -35
  77. package/skills/meta/README.md +30 -30
  78. package/skills/meta/api-design/SKILL.md +134 -134
  79. package/skills/meta/code-review/SKILL.md +44 -44
  80. package/skills/meta/code-review/checklists/pre-merge.md +25 -25
  81. package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
  82. package/skills/meta/code-review/workflows/performance-pass.md +27 -27
  83. package/skills/meta/code-review/workflows/security-pass.md +29 -29
  84. package/skills/meta/compound-docs/SKILL.md +133 -133
  85. package/skills/meta/debug/SKILL.md +40 -40
  86. package/skills/meta/debug/templates/bug-report.template.md +31 -31
  87. package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
  88. package/skills/meta/docker/SKILL.md +126 -126
  89. package/skills/meta/examples/supabase/SKILL.md +46 -46
  90. package/skills/meta/examples/supabase/references/best-practices.md +319 -319
  91. package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
  92. package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
  93. package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
  94. package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
  95. package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
  96. package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
  97. package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
  98. package/skills/meta/file-todos/SKILL.md +88 -88
  99. package/skills/meta/mobile/SKILL.md +140 -140
  100. package/skills/meta/nextjs/SKILL.md +101 -101
  101. package/skills/meta/performance/SKILL.md +130 -130
  102. package/skills/meta/react-patterns/SKILL.md +83 -83
  103. package/skills/meta/security/SKILL.md +114 -114
  104. package/skills/meta/session-resume/SKILL.md +96 -96
  105. package/skills/meta/tailwind/SKILL.md +139 -139
  106. package/skills/meta/testing/SKILL.md +43 -43
  107. package/skills/meta/testing/references/vitest-patterns.md +45 -45
  108. package/skills/meta/testing/templates/component-test.template.tsx +37 -37
  109. package/skills/tech/alpha-vantage/SKILL.md +142 -142
  110. package/skills/tech/alpha-vantage/references/commodities.md +153 -153
  111. package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
  112. package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
  113. package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
  114. package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
  115. package/skills/tech/alpha-vantage/references/options.md +93 -93
  116. package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
  117. package/skills/tech/alpha-vantage/references/time-series.md +157 -157
  118. package/skills/tech/financial-modeling/SKILL.md +18 -18
  119. package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
  120. package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
  121. package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
  122. package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
  123. package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
  124. package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
  125. package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
  126. package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
  127. package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
  128. package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
  129. package/skills/workflows/README.md +203 -203
  130. package/skills/workflows/adr.md +174 -174
  131. package/skills/workflows/changelog.md +74 -74
  132. package/skills/workflows/compound.md +323 -323
  133. package/skills/workflows/compound_health.md +74 -74
  134. package/skills/workflows/create-agent-skill.md +138 -138
  135. package/skills/workflows/cycle.md +144 -144
  136. package/skills/workflows/deploy-docs.md +84 -84
  137. package/skills/workflows/development-rules.md +42 -42
  138. package/skills/workflows/doc.md +95 -95
  139. package/skills/workflows/documentation-management.md +34 -34
  140. package/skills/workflows/explore.md +146 -146
  141. package/skills/workflows/generate_command.md +106 -106
  142. package/skills/workflows/heal-skill.md +97 -97
  143. package/skills/workflows/housekeeping.md +229 -229
  144. package/skills/workflows/kit-setup.md +102 -102
  145. package/skills/workflows/map-codebase.md +78 -78
  146. package/skills/workflows/orchestration-protocol.md +43 -43
  147. package/skills/workflows/plan-compound.md +439 -439
  148. package/skills/workflows/plan_review.md +269 -269
  149. package/skills/workflows/primary-workflow.md +37 -37
  150. package/skills/workflows/promote_pattern.md +86 -86
  151. package/skills/workflows/release-docs.md +82 -82
  152. package/skills/workflows/report-bug.md +135 -135
  153. package/skills/workflows/reproduce-bug.md +118 -118
  154. package/skills/workflows/resolve_pr.md +133 -133
  155. package/skills/workflows/resolve_todo.md +128 -128
  156. package/skills/workflows/review-compound.md +376 -376
  157. package/skills/workflows/skill-review.md +127 -127
  158. package/skills/workflows/specs.md +257 -257
  159. package/skills/workflows/triage-sprint.md +102 -102
  160. package/skills/workflows/triage.md +152 -152
  161. package/skills/workflows/work.md +399 -399
  162. package/skills/workflows/xcode-test.md +93 -93
@@ -11,14 +11,14 @@ describe('reactPerformanceChecker', () => {
11
11
  name: 'Home.tsx',
12
12
  isDirectory: () => false
13
13
  }]);
14
- vi.mocked(fs.readFile).mockResolvedValue(`
15
- import { something } from '@/components/index';
16
-
17
- async function loadData() {
18
- const a = await fetchA();
19
- const b = await fetchB();
20
- return { a, b };
21
- }
14
+ vi.mocked(fs.readFile).mockResolvedValue(`
15
+ import { something } from '@/components/index';
16
+
17
+ async function loadData() {
18
+ const a = await fetchA();
19
+ const b = await fetchB();
20
+ return { a, b };
21
+ }
22
22
  `);
23
23
  const res = await runReactPerformanceChecker('.');
24
24
  console.log("RPC BAD REPORT:", res.report);
@@ -31,15 +31,15 @@ describe('reactPerformanceChecker', () => {
31
31
  name: 'App.tsx',
32
32
  isDirectory: () => false
33
33
  }]);
34
- vi.mocked(fs.readFile).mockResolvedValue(`
35
- import { useQuery } from '@tanstack/react-query';
36
- import Image from 'next/image';
37
-
38
- const App = React.memo((props: Props) => {
39
- const q = useQuery('data', fetchParallel);
40
- return <Image src="foo" alt="bar" />
41
- });
42
- export default App;
34
+ vi.mocked(fs.readFile).mockResolvedValue(`
35
+ import { useQuery } from '@tanstack/react-query';
36
+ import Image from 'next/image';
37
+
38
+ const App = React.memo((props: Props) => {
39
+ const q = useQuery('data', fetchParallel);
40
+ return <Image src="foo" alt="bar" />
41
+ });
42
+ export default App;
43
43
  `);
44
44
  const res = await runReactPerformanceChecker('.');
45
45
  console.log("RPC GOOD REPORT:", res.report);
@@ -13,8 +13,8 @@ describe('securityScan', () => {
13
13
  name: 'config.json',
14
14
  isDirectory: () => false
15
15
  }]);
16
- vi.mocked(fs.readFile).mockResolvedValue(`
17
- { "aws_key": "AKIA1234567890123456" }
16
+ vi.mocked(fs.readFile).mockResolvedValue(`
17
+ { "aws_key": "AKIA1234567890123456" }
18
18
  `);
19
19
  const result = await scanSecrets('/mock');
20
20
  expect(result.findings).toBeDefined();
@@ -28,10 +28,10 @@ describe('securityScan', () => {
28
28
  name: 'bad_code.js',
29
29
  isDirectory: () => false
30
30
  }]);
31
- vi.mocked(fs.readFile).mockResolvedValue(`
32
- eval('2 + 2');
33
- import { exec } from 'child_process';
34
- child_process.exec('rm -rf /');
31
+ vi.mocked(fs.readFile).mockResolvedValue(`
32
+ eval('2 + 2');
33
+ import { exec } from 'child_process';
34
+ child_process.exec('rm -rf /');
35
35
  `);
36
36
  const result = await scanCodePatterns('/mock');
37
37
  expect(result.findings.length).toBeGreaterThan(1);
@@ -11,22 +11,22 @@ describe('seoChecker', () => {
11
11
  name: 'index.tsx', // valid page layout file
12
12
  isDirectory: () => false
13
13
  }]);
14
- vi.mocked(fs.readFile).mockResolvedValue(`
15
- export default function Index() {
16
- return (
17
- <html>
18
- <head>
19
- <title>Oops missing description and og</title>
20
- </head>
21
- <body>
22
- <h1>Title</h1>
23
- <h1>Duplicate Title</h1>
24
- <img src="foo" />
25
- <img src="bar" alt="" />
26
- </body>
27
- </html>
28
- )
29
- }
14
+ vi.mocked(fs.readFile).mockResolvedValue(`
15
+ export default function Index() {
16
+ return (
17
+ <html>
18
+ <head>
19
+ <title>Oops missing description and og</title>
20
+ </head>
21
+ <body>
22
+ <h1>Title</h1>
23
+ <h1>Duplicate Title</h1>
24
+ <img src="foo" />
25
+ <img src="bar" alt="" />
26
+ </body>
27
+ </html>
28
+ )
29
+ }
30
30
  `);
31
31
  const res = await runSeoChecker('.');
32
32
  expect(res.passed).toBe(false);
@@ -14,9 +14,9 @@ describe('typeCoverage', () => {
14
14
  isDirectory: () => false
15
15
  }]);
16
16
  // Mock readFile to return a snippet with an untyped function and an "any"
17
- vi.mocked(fs.readFile).mockResolvedValue(`
18
- function test(): any { return 1; }
19
- const test2 = (x) => console.log(x);
17
+ vi.mocked(fs.readFile).mockResolvedValue(`
18
+ function test(): any { return 1; }
19
+ const test2 = (x) => console.log(x);
20
20
  `);
21
21
  const result = await checkTypescriptCoverage('/mock/folder');
22
22
  expect(result.type).toBe('typescript');
@@ -29,8 +29,8 @@ describe('typeCoverage', () => {
29
29
  name: 'good.ts',
30
30
  isDirectory: () => false
31
31
  }]);
32
- vi.mocked(fs.readFile).mockResolvedValue(`
33
- function typedFunc(val: string): number { return val.length; }
32
+ vi.mocked(fs.readFile).mockResolvedValue(`
33
+ function typedFunc(val: string): number { return val.length; }
34
34
  `);
35
35
  const result = await checkTypescriptCoverage('/mock/good');
36
36
  expect(result.stats.any_count).toBe(0);
@@ -44,15 +44,15 @@ describe('typeCoverage', () => {
44
44
  name: 'script.py',
45
45
  isDirectory: () => false
46
46
  }]);
47
- vi.mocked(fs.readFile).mockResolvedValue(`
48
- def bad_func(arg):
49
- pass
50
-
51
- def good_func(arg: str) -> bool:
52
- return True
53
-
54
- def any_func(arg: Any) -> Any:
55
- pass
47
+ vi.mocked(fs.readFile).mockResolvedValue(`
48
+ def bad_func(arg):
49
+ pass
50
+
51
+ def good_func(arg: str) -> bool:
52
+ return True
53
+
54
+ def any_func(arg: Any) -> Any:
55
+ pass
56
56
  `);
57
57
  const result = await checkPythonCoverage('/mock/py');
58
58
  expect(result.stats.any_count).toBeGreaterThan(0);
@@ -1,122 +1,122 @@
1
- # Commands
2
-
3
- This directory contains all **custom slash commands** for the Super-Kit extension. Commands are defined as TOML files and automatically loaded by the AI agent client.
4
-
5
- ## Overview
6
-
7
- Commands extend Super-Kit's capabilities by providing specialized prompts for specific tasks. Each command file follows the TOML format with `description` and `prompt` fields.
8
-
9
- ## Command Categories
10
-
11
- | Category | Commands | Purpose |
12
- |----------|----------|---------|
13
- | **Planning** | `plan`, `brainstorm` | Create implementation plans |
14
- | **Coding** | `code`, `fix`, `debug`, `fullstack` | Write and debug code |
15
- | **Review** | `review`, `review-pr`, `pr` | Code review and PR management |
16
- | **Documentation** | `docs`, `doc-rules`, `help` | Documentation tasks |
17
- | **Project** | `project`, `pm`, `status` | Project management |
18
- | **Git** | `git`, `session` | Git and session management |
19
- | **Research** | `research`, `scout`, `scout-ext` | Codebase exploration |
20
- | **Content** | `content`, `copywrite`, `chat` | Content creation |
21
- | **Database** | `db` | Database operations |
22
- | **Design** | `design` | UI/UX design tasks |
23
- | **Testing** | `test` | Testing and QA |
24
- | **Tools** | `mcp`, `skill`, `screenshot`, `video` | Tool integrations |
25
-
26
- ## Components
27
-
28
- | Component | Purpose | Status |
29
- |-----------|---------|--------|
30
- | `ask.toml` | General Q&A with context | ✅ Active |
31
- | `brainstorm.toml` | Creative ideation | ✅ Active |
32
- | `chat.toml` | Conversational interactions | ✅ Active |
33
- | `code.toml` | Code implementation | ✅ Active |
34
- | `code-preview.toml` | Code preview mode | ✅ Active |
35
- | `content.toml` | Content creation | ✅ Active |
36
- | `cook.toml` | Execute plans step-by-step | ✅ Active |
37
- | `copywrite.toml` | Marketing copy | ✅ Active |
38
- | `db.toml` | Database operations | ✅ Active |
39
- | `debug.toml` | Debugging assistance | ✅ Active |
40
- | `design.toml` | UI/UX design | ✅ Active |
41
- | `dev-rules.toml` | Development rules loader | ✅ Active |
42
- | `do.toml` | Quick task execution | ✅ Active |
43
- | `doc-rules.toml` | Documentation rules | ✅ Active |
44
- | `docs.toml` | Documentation management | ✅ Active |
45
- | `fix.toml` | Bug fixing | ✅ Active |
46
- | `fullstack.toml` | Full-stack development | ✅ Active |
47
- | `git.toml` | Git operations | ✅ Active |
48
- | `help.toml` | Help and guidance | ✅ Active |
49
- | `integrate.toml` | Integration tasks | ✅ Active |
50
- | `journal.toml` | Session journaling | ✅ Active |
51
- | `kit-setup.toml` | Project setup wizard | ✅ Active |
52
- | `mcp.toml` | MCP server management | ✅ Active |
53
- | `orchestration.toml` | Multi-agent orchestration | ✅ Active |
54
- | `plan.toml` | Implementation planning | ✅ Active |
55
- | `pm.toml` | Project management | ✅ Active |
56
- | `pr.toml` | Pull request creation | ✅ Active |
57
- | `project.toml` | Project context | ✅ Active |
58
- | `research.toml` | Research tasks | ✅ Active |
59
- | `review-pr.toml` | PR review | ✅ Active |
60
- | `review.toml` | Code review | ✅ Active |
61
- | `scout-ext.toml` | Extended codebase exploration | ✅ Active |
62
- | `scout.toml` | Codebase scout | ✅ Active |
63
- | `screenshot.toml` | Screenshot capture | ✅ Active |
64
- | `session.toml` | Session management | ✅ Active |
65
- | `skill.toml` | Skill creation | ✅ Active |
66
- | `status.toml` | Status reporting | ✅ Active |
67
- | `team.toml` | Team coordination | ✅ Active |
68
- | `test.toml` | Testing tasks | ✅ Active |
69
- | `ticket.toml` | Issue/ticket management | ✅ Active |
70
- | `use.toml` | Use existing patterns | ✅ Active |
71
- | `video.toml` | Video processing | ✅ Active |
72
- | `watzup.toml` | Quick status check | ✅ Active |
73
- | `workflow.toml` | Workflow management | ✅ Active |
74
-
75
- ## TOML Structure
76
-
77
- Each command file follows this structure:
78
-
79
- ```toml
80
- description = "Brief description shown in command list"
81
-
82
- prompt = '''
83
- # Command Name
84
-
85
- {{args}} - User input passed to the command
86
-
87
- ## Instructions
88
- ...
89
- '''
90
- ```
91
-
92
- ### String Types
93
-
94
- - **Basic string** (`"""..."""`): Processes escape sequences
95
- - **Literal string** (`'''...'''`): Raw content, no escape processing (preferred for complex prompts with code blocks)
96
-
97
- > [!NOTE]
98
- > Use literal strings (`'''`) when your prompt contains nested markdown code blocks to avoid TOML parsing issues.
99
-
100
- ## Usage
101
-
102
- ```bash
103
- # In Gemini CLI
104
- /command-name [arguments]
105
-
106
- # Examples
107
- /plan Add user authentication
108
- /code Implement login form
109
- /review @src/auth/login.ts
110
- ```
111
-
112
- ## Changelog
113
-
114
- ### 2026-01-24
115
- - Fixed TOML parsing failure in `docs.toml` by switching from basic strings (`"""`) to literal strings (`'''`) - Issue #9
116
-
117
- ---
118
-
119
- ## References
120
-
121
- - [Gemini CLI Commands Documentation](https://ai.google.dev/gemini-api/docs/gemini-cli)
122
- - [TOML Specification](https://toml.io/en/)
1
+ # Commands
2
+
3
+ This directory contains all **custom slash commands** for the Super-Kit extension. Commands are defined as TOML files and automatically loaded by the AI agent client.
4
+
5
+ ## Overview
6
+
7
+ Commands extend Super-Kit's capabilities by providing specialized prompts for specific tasks. Each command file follows the TOML format with `description` and `prompt` fields.
8
+
9
+ ## Command Categories
10
+
11
+ | Category | Commands | Purpose |
12
+ |----------|----------|---------|
13
+ | **Planning** | `plan`, `brainstorm` | Create implementation plans |
14
+ | **Coding** | `code`, `fix`, `debug`, `fullstack` | Write and debug code |
15
+ | **Review** | `review`, `review-pr`, `pr` | Code review and PR management |
16
+ | **Documentation** | `docs`, `doc-rules`, `help` | Documentation tasks |
17
+ | **Project** | `project`, `pm`, `status` | Project management |
18
+ | **Git** | `git`, `session` | Git and session management |
19
+ | **Research** | `research`, `scout`, `scout-ext` | Codebase exploration |
20
+ | **Content** | `content`, `copywrite`, `chat` | Content creation |
21
+ | **Database** | `db` | Database operations |
22
+ | **Design** | `design` | UI/UX design tasks |
23
+ | **Testing** | `test` | Testing and QA |
24
+ | **Tools** | `mcp`, `skill`, `screenshot`, `video` | Tool integrations |
25
+
26
+ ## Components
27
+
28
+ | Component | Purpose | Status |
29
+ |-----------|---------|--------|
30
+ | `ask.toml` | General Q&A with context | ✅ Active |
31
+ | `brainstorm.toml` | Creative ideation | ✅ Active |
32
+ | `chat.toml` | Conversational interactions | ✅ Active |
33
+ | `code.toml` | Code implementation | ✅ Active |
34
+ | `code-preview.toml` | Code preview mode | ✅ Active |
35
+ | `content.toml` | Content creation | ✅ Active |
36
+ | `cook.toml` | Execute plans step-by-step | ✅ Active |
37
+ | `copywrite.toml` | Marketing copy | ✅ Active |
38
+ | `db.toml` | Database operations | ✅ Active |
39
+ | `debug.toml` | Debugging assistance | ✅ Active |
40
+ | `design.toml` | UI/UX design | ✅ Active |
41
+ | `dev-rules.toml` | Development rules loader | ✅ Active |
42
+ | `do.toml` | Quick task execution | ✅ Active |
43
+ | `doc-rules.toml` | Documentation rules | ✅ Active |
44
+ | `docs.toml` | Documentation management | ✅ Active |
45
+ | `fix.toml` | Bug fixing | ✅ Active |
46
+ | `fullstack.toml` | Full-stack development | ✅ Active |
47
+ | `git.toml` | Git operations | ✅ Active |
48
+ | `help.toml` | Help and guidance | ✅ Active |
49
+ | `integrate.toml` | Integration tasks | ✅ Active |
50
+ | `journal.toml` | Session journaling | ✅ Active |
51
+ | `kit-setup.toml` | Project setup wizard | ✅ Active |
52
+ | `mcp.toml` | MCP server management | ✅ Active |
53
+ | `orchestration.toml` | Multi-agent orchestration | ✅ Active |
54
+ | `plan.toml` | Implementation planning | ✅ Active |
55
+ | `pm.toml` | Project management | ✅ Active |
56
+ | `pr.toml` | Pull request creation | ✅ Active |
57
+ | `project.toml` | Project context | ✅ Active |
58
+ | `research.toml` | Research tasks | ✅ Active |
59
+ | `review-pr.toml` | PR review | ✅ Active |
60
+ | `review.toml` | Code review | ✅ Active |
61
+ | `scout-ext.toml` | Extended codebase exploration | ✅ Active |
62
+ | `scout.toml` | Codebase scout | ✅ Active |
63
+ | `screenshot.toml` | Screenshot capture | ✅ Active |
64
+ | `session.toml` | Session management | ✅ Active |
65
+ | `skill.toml` | Skill creation | ✅ Active |
66
+ | `status.toml` | Status reporting | ✅ Active |
67
+ | `team.toml` | Team coordination | ✅ Active |
68
+ | `test.toml` | Testing tasks | ✅ Active |
69
+ | `ticket.toml` | Issue/ticket management | ✅ Active |
70
+ | `use.toml` | Use existing patterns | ✅ Active |
71
+ | `video.toml` | Video processing | ✅ Active |
72
+ | `watzup.toml` | Quick status check | ✅ Active |
73
+ | `workflow.toml` | Workflow management | ✅ Active |
74
+
75
+ ## TOML Structure
76
+
77
+ Each command file follows this structure:
78
+
79
+ ```toml
80
+ description = "Brief description shown in command list"
81
+
82
+ prompt = '''
83
+ # Command Name
84
+
85
+ {{args}} - User input passed to the command
86
+
87
+ ## Instructions
88
+ ...
89
+ '''
90
+ ```
91
+
92
+ ### String Types
93
+
94
+ - **Basic string** (`"""..."""`): Processes escape sequences
95
+ - **Literal string** (`'''...'''`): Raw content, no escape processing (preferred for complex prompts with code blocks)
96
+
97
+ > [!NOTE]
98
+ > Use literal strings (`'''`) when your prompt contains nested markdown code blocks to avoid TOML parsing issues.
99
+
100
+ ## Usage
101
+
102
+ ```bash
103
+ # In Gemini CLI
104
+ /command-name [arguments]
105
+
106
+ # Examples
107
+ /plan Add user authentication
108
+ /code Implement login form
109
+ /review @src/auth/login.ts
110
+ ```
111
+
112
+ ## Changelog
113
+
114
+ ### 2026-01-24
115
+ - Fixed TOML parsing failure in `docs.toml` by switching from basic strings (`"""`) to literal strings (`'''`) - Issue #9
116
+
117
+ ---
118
+
119
+ ## References
120
+
121
+ - [Gemini CLI Commands Documentation](https://ai.google.dev/gemini-api/docs/gemini-cli)
122
+ - [TOML Specification](https://toml.io/en/)
package/commands/ask.toml CHANGED
@@ -1,72 +1,72 @@
1
- # Ask - Ask About Codebase
2
- # Usage: /ask <question>
3
- # Ask questions about the codebase, AI will search and answer
4
-
5
- description = "Ask questions about the codebase, AI will search and answer"
6
-
7
- prompt = """
8
- {{#if args}}
9
- # ❓ Ask About Codebase
10
-
11
- **Question:** {{args}}
12
-
13
- ## Instructions:
14
-
15
- 1. **Search the codebase** to find relevant files and code
16
- 2. **Analyze** the code structure and patterns
17
- 3. **Answer** the question based on actual code
18
-
19
- ## Search Strategy:
20
- - Look for files related to the question keywords
21
- - Read relevant source files
22
- - Check imports and dependencies
23
- - Look at tests for usage examples
24
-
25
- ## Answer Format:
26
-
27
- ### 📋 Answer
28
- [Direct answer to the question]
29
-
30
- ### 📁 Relevant Files
31
- - `file1.ts` - [description]
32
- - `file2.ts` - [description]
33
-
34
- ### 💡 Code Examples
35
- ```typescript
36
- // relevant code snippets
37
- ```
38
-
39
- ### 🔗 Related
40
- - [other related concepts or files]
41
-
42
- ---
43
-
44
- Now search the codebase and answer: "{{args}}"
45
- {{else}}
46
- # ❓ Ask About Codebase
47
-
48
- Ask any question about the codebase and get AI-powered answers.
49
-
50
- ## Usage:
51
- ```
52
- /ask <your question>
53
- ```
54
-
55
- ## Examples:
56
- ```
57
- /ask How does authentication work?
58
- /ask Where is the user model defined?
59
- /ask What API endpoints are available?
60
- /ask How do I add a new route?
61
- /ask Where are database queries made?
62
- ```
63
-
64
- ## What it does:
65
- 1. Searches codebase for relevant files
66
- 2. Analyzes code structure and patterns
67
- 3. Provides answer based on actual code
68
- 4. Shows relevant code snippets
69
-
70
- Ask your question!
71
- {{/if}}
72
- """
1
+ # Ask - Ask About Codebase
2
+ # Usage: /ask <question>
3
+ # Ask questions about the codebase, AI will search and answer
4
+
5
+ description = "Ask questions about the codebase, AI will search and answer"
6
+
7
+ prompt = """
8
+ {{#if args}}
9
+ # ❓ Ask About Codebase
10
+
11
+ **Question:** {{args}}
12
+
13
+ ## Instructions:
14
+
15
+ 1. **Search the codebase** to find relevant files and code
16
+ 2. **Analyze** the code structure and patterns
17
+ 3. **Answer** the question based on actual code
18
+
19
+ ## Search Strategy:
20
+ - Look for files related to the question keywords
21
+ - Read relevant source files
22
+ - Check imports and dependencies
23
+ - Look at tests for usage examples
24
+
25
+ ## Answer Format:
26
+
27
+ ### 📋 Answer
28
+ [Direct answer to the question]
29
+
30
+ ### 📁 Relevant Files
31
+ - `file1.ts` - [description]
32
+ - `file2.ts` - [description]
33
+
34
+ ### 💡 Code Examples
35
+ ```typescript
36
+ // relevant code snippets
37
+ ```
38
+
39
+ ### 🔗 Related
40
+ - [other related concepts or files]
41
+
42
+ ---
43
+
44
+ Now search the codebase and answer: "{{args}}"
45
+ {{else}}
46
+ # ❓ Ask About Codebase
47
+
48
+ Ask any question about the codebase and get AI-powered answers.
49
+
50
+ ## Usage:
51
+ ```
52
+ /ask <your question>
53
+ ```
54
+
55
+ ## Examples:
56
+ ```
57
+ /ask How does authentication work?
58
+ /ask Where is the user model defined?
59
+ /ask What API endpoints are available?
60
+ /ask How do I add a new route?
61
+ /ask Where are database queries made?
62
+ ```
63
+
64
+ ## What it does:
65
+ 1. Searches codebase for relevant files
66
+ 2. Analyzes code structure and patterns
67
+ 3. Provides answer based on actual code
68
+ 4. Shows relevant code snippets
69
+
70
+ Ask your question!
71
+ {{/if}}
72
+ """