moai-adk 0.4.7__py3-none-any.whl → 0.4.8__py3-none-any.whl
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.
Potentially problematic release.
This version of moai-adk might be problematic. Click here for more details.
- moai_adk/templates/.claude/agents/alfred/cc-manager.md +188 -954
- moai_adk/templates/.claude/agents/alfred/debug-helper.md +4 -5
- moai_adk/templates/.claude/agents/alfred/doc-syncer.md +2 -2
- moai_adk/templates/.claude/agents/alfred/git-manager.md +2 -2
- moai_adk/templates/.claude/agents/alfred/implementation-planner.md +3 -3
- moai_adk/templates/.claude/agents/alfred/project-manager.md +6 -6
- moai_adk/templates/.claude/agents/alfred/quality-gate.md +4 -6
- moai_adk/templates/.claude/agents/alfred/skill-factory.md +36 -36
- moai_adk/templates/.claude/agents/alfred/spec-builder.md +2 -2
- moai_adk/templates/.claude/agents/alfred/tag-agent.md +2 -2
- moai_adk/templates/.claude/agents/alfred/tdd-implementer.md +3 -3
- moai_adk/templates/.claude/agents/alfred/trust-checker.md +5 -5
- moai_adk/templates/.claude/commands/alfred/0-project.md +98 -42
- moai_adk/templates/.claude/commands/alfred/1-plan.md +7 -7
- moai_adk/templates/.claude/commands/alfred/2-run.md +36 -36
- moai_adk/templates/.claude/commands/alfred/3-sync.md +10 -10
- moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py +14 -1
- moai_adk/templates/.claude/hooks/alfred/core/__init__.py +115 -33
- moai_adk/templates/.claude/hooks/alfred/handlers/session.py +8 -9
- moai_adk/templates/.claude/hooks/alfred/handlers/tool.py +6 -6
- moai_adk/templates/.claude/hooks/alfred/handlers/user.py +5 -4
- moai_adk/templates/.claude/output-styles/alfred/agentic-coding.md +1 -1
- moai_adk/templates/.claude/output-styles/alfred/moai-adk-learning.md +1 -1
- moai_adk/templates/.claude/output-styles/alfred/study-with-alfred.md +1 -1
- moai_adk/templates/.claude/settings.json +42 -2
- moai_adk/templates/.claude/skills/moai-alfred-interactive-questions/SKILL.md +480 -0
- moai_adk/templates/.claude/skills/moai-alfred-interactive-questions/examples.md +257 -0
- moai_adk/templates/.claude/skills/moai-alfred-interactive-questions/reference.md +120 -0
- moai_adk/templates/.claude/skills/moai-cc-agents/SKILL.md +249 -0
- moai_adk/templates/.claude/skills/moai-cc-agents/templates/agent-template.md +32 -0
- moai_adk/templates/.claude/skills/moai-cc-claude-md/SKILL.md +278 -0
- moai_adk/templates/.claude/skills/moai-cc-claude-md/templates/CLAUDE-template.md +26 -0
- moai_adk/templates/.claude/skills/moai-cc-commands/SKILL.md +287 -0
- moai_adk/templates/.claude/skills/moai-cc-commands/templates/command-template.md +21 -0
- moai_adk/templates/.claude/skills/moai-cc-hooks/SKILL.md +232 -0
- moai_adk/templates/.claude/skills/moai-cc-hooks/scripts/pre-bash-check.sh +19 -0
- moai_adk/templates/.claude/skills/moai-cc-hooks/scripts/preserve-permissions.sh +19 -0
- moai_adk/templates/.claude/skills/moai-cc-hooks/scripts/validate-bash-command.py +24 -0
- moai_adk/templates/.claude/skills/moai-cc-mcp-plugins/SKILL.md +179 -0
- moai_adk/templates/.claude/skills/moai-cc-mcp-plugins/templates/settings-mcp-template.json +39 -0
- moai_adk/templates/.claude/skills/moai-cc-memory/SKILL.md +296 -0
- moai_adk/templates/.claude/skills/moai-cc-memory/templates/session-summary-template.md +18 -0
- moai_adk/templates/.claude/skills/moai-cc-settings/SKILL.md +243 -0
- moai_adk/templates/.claude/skills/moai-cc-settings/templates/settings-complete-template.json +30 -0
- moai_adk/templates/.claude/skills/moai-cc-skills/SKILL.md +271 -0
- moai_adk/templates/.claude/skills/moai-cc-skills/templates/SKILL-template.md +15 -0
- moai_adk/templates/.claude/skills/moai-skill-factory/EXAMPLES.md +261 -35
- moai_adk/templates/.claude/skills/moai-skill-factory/INTERACTIVE-DISCOVERY.md +15 -15
- moai_adk/templates/.claude/skills/moai-skill-factory/PARALLEL-ANALYSIS-REPORT.md +429 -0
- moai_adk/templates/.claude/skills/moai-skill-factory/PYTHON-VERSION-MATRIX.md +391 -0
- moai_adk/templates/.claude/skills/moai-skill-factory/SKILL-FACTORY-WORKFLOW.md +431 -0
- moai_adk/templates/.claude/skills/moai-skill-factory/SKILL.md +33 -33
- moai_adk/templates/.claude/skills/moai-skill-factory/STEP-BY-STEP-GUIDE.md +466 -0
- moai_adk/templates/.claude/skills/moai-skill-factory/reference.md +438 -42
- moai_adk/templates/.claude/skills/moai-spec-authoring/README.md +129 -0
- moai_adk/templates/.claude/skills/moai-spec-authoring/SKILL.md +1300 -0
- moai_adk/templates/.claude/skills/moai-spec-authoring/examples/validate-spec.sh +161 -0
- moai_adk/templates/CLAUDE.md +101 -93
- {moai_adk-0.4.7.dist-info → moai_adk-0.4.8.dist-info}/METADATA +537 -146
- {moai_adk-0.4.7.dist-info → moai_adk-0.4.8.dist-info}/RECORD +63 -73
- moai_adk/templates/.claude/skills/moai-alfred-code-reviewer/SKILL.md +0 -113
- moai_adk/templates/.claude/skills/moai-alfred-code-reviewer/examples.md +0 -29
- moai_adk/templates/.claude/skills/moai-alfred-code-reviewer/reference.md +0 -28
- moai_adk/templates/.claude/skills/moai-alfred-debugger-pro/SKILL.md +0 -113
- moai_adk/templates/.claude/skills/moai-alfred-debugger-pro/examples.md +0 -29
- moai_adk/templates/.claude/skills/moai-alfred-debugger-pro/reference.md +0 -28
- moai_adk/templates/.claude/skills/moai-alfred-performance-optimizer/SKILL.md +0 -113
- moai_adk/templates/.claude/skills/moai-alfred-performance-optimizer/examples.md +0 -29
- moai_adk/templates/.claude/skills/moai-alfred-performance-optimizer/reference.md +0 -28
- moai_adk/templates/.claude/skills/moai-alfred-refactoring-coach/SKILL.md +0 -113
- moai_adk/templates/.claude/skills/moai-alfred-refactoring-coach/examples.md +0 -29
- moai_adk/templates/.claude/skills/moai-alfred-refactoring-coach/reference.md +0 -28
- moai_adk/templates/.claude/skills/moai-alfred-tui-survey/SKILL.md +0 -635
- moai_adk/templates/.claude/skills/moai-alfred-tui-survey/examples.md +0 -992
- moai_adk/templates/.claude/skills/moai-alfred-tui-survey/reference.md +0 -801
- moai_adk/templates/.claude/skills/moai-claude-code/SKILL.md +0 -121
- moai_adk/templates/.claude/skills/moai-claude-code/examples.md +0 -29
- moai_adk/templates/.claude/skills/moai-claude-code/reference.md +0 -28
- moai_adk/templates/.claude/skills/moai-claude-code/templates/agent-full.md +0 -332
- moai_adk/templates/.claude/skills/moai-claude-code/templates/command-full.md +0 -384
- moai_adk/templates/.claude/skills/moai-claude-code/templates/plugin-full.json +0 -363
- moai_adk/templates/.claude/skills/moai-claude-code/templates/settings-full.json +0 -595
- moai_adk/templates/.claude/skills/moai-claude-code/templates/skill-full.md +0 -496
- moai_adk/templates/.claude/skills/moai-lang-clojure/SKILL.md +0 -123
- moai_adk/templates/.claude/skills/moai-lang-clojure/examples.md +0 -29
- moai_adk/templates/.claude/skills/moai-lang-clojure/reference.md +0 -30
- moai_adk/templates/.claude/skills/moai-lang-elixir/SKILL.md +0 -124
- moai_adk/templates/.claude/skills/moai-lang-elixir/examples.md +0 -29
- moai_adk/templates/.claude/skills/moai-lang-elixir/reference.md +0 -31
- moai_adk/templates/.claude/skills/moai-lang-haskell/SKILL.md +0 -124
- moai_adk/templates/.claude/skills/moai-lang-haskell/examples.md +0 -29
- moai_adk/templates/.claude/skills/moai-lang-haskell/reference.md +0 -31
- moai_adk/templates/.claude/skills/moai-lang-julia/SKILL.md +0 -123
- moai_adk/templates/.claude/skills/moai-lang-julia/examples.md +0 -29
- moai_adk/templates/.claude/skills/moai-lang-julia/reference.md +0 -30
- moai_adk/templates/.claude/skills/moai-lang-lua/SKILL.md +0 -123
- moai_adk/templates/.claude/skills/moai-lang-lua/examples.md +0 -29
- moai_adk/templates/.claude/skills/moai-lang-lua/reference.md +0 -30
- {moai_adk-0.4.7.dist-info → moai_adk-0.4.8.dist-info}/WHEEL +0 -0
- {moai_adk-0.4.7.dist-info → moai_adk-0.4.8.dist-info}/entry_points.txt +0 -0
- {moai_adk-0.4.7.dist-info → moai_adk-0.4.8.dist-info}/licenses/LICENSE +0 -0
|
@@ -1,496 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: {skill-name}
|
|
3
|
-
description: {Capability + trigger phrases (<=1024 chars, aim for <=200)}
|
|
4
|
-
allowed-tools: # optional; remove if full tool access is acceptable
|
|
5
|
-
- Read
|
|
6
|
-
- Bash
|
|
7
|
-
- Write
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
# {Skill Title}
|
|
11
|
-
|
|
12
|
-
> {One-sentence compelling summary of value proposition}
|
|
13
|
-
|
|
14
|
-
---
|
|
15
|
-
|
|
16
|
-
## 🎯 Purpose of this skill
|
|
17
|
-
|
|
18
|
-
{Comprehensive explanation covering:
|
|
19
|
-
- Problem statement and context
|
|
20
|
-
- How this skill addresses the problem
|
|
21
|
-
- Unique value proposition
|
|
22
|
-
- Integration with broader workflows}
|
|
23
|
-
|
|
24
|
-
**Problem**: {Detailed problem description with examples}
|
|
25
|
-
**Solution**: {Comprehensive solution approach}
|
|
26
|
-
**Impact**: {Measurable benefits and improvements}
|
|
27
|
-
|
|
28
|
-
---
|
|
29
|
-
|
|
30
|
-
## 🏗️ MoAI-ADK integration
|
|
31
|
-
|
|
32
|
-
### Alfred auto-selection conditions
|
|
33
|
-
|
|
34
|
-
Alfred automatically activates this skill under the following conditions:
|
|
35
|
-
|
|
36
|
-
- {Specific automatic trigger condition 1 with context}
|
|
37
|
-
- {Specific automatic trigger condition 2 with keywords}
|
|
38
|
-
- {Specific automatic trigger condition 3 with workflow state}
|
|
39
|
-
|
|
40
|
-
### Workflow location
|
|
41
|
-
|
|
42
|
-
```
|
|
43
|
-
/alfred:1-plan → /alfred:2-run → /alfred:3-sync
|
|
44
|
-
↑
|
|
45
|
-
Automatically activate this skill
|
|
46
|
-
({when activated})
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
**Integration Point**:
|
|
50
|
-
- **Phase**: {Which phase of MoAI-ADK workflow}
|
|
51
|
-
- **Trigger**: {What triggers automatic invocation}
|
|
52
|
-
- **Role**: {What this skill contributes to the workflow}
|
|
53
|
-
|
|
54
|
-
---
|
|
55
|
-
|
|
56
|
-
## 📋 Core features
|
|
57
|
-
|
|
58
|
-
### 1. {Major Feature 1 Name}
|
|
59
|
-
|
|
60
|
-
{Detailed multi-paragraph description of this feature}
|
|
61
|
-
|
|
62
|
-
**How to implement**:
|
|
63
|
-
```{language}
|
|
64
|
-
# {Implementation detail 1}
|
|
65
|
-
{code-example-1}
|
|
66
|
-
|
|
67
|
-
# {Implementation detail 2}
|
|
68
|
-
{code-example-2}
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
**Output**:
|
|
72
|
-
- **{Output 1}**: {Detailed description with format}
|
|
73
|
-
- **{Output 2}**: {Description with validation criteria}
|
|
74
|
-
- **{Output 3}**: {Description with usage notes}
|
|
75
|
-
|
|
76
|
-
**verification**:
|
|
77
|
-
```bash
|
|
78
|
-
# {Verification method}
|
|
79
|
-
{verification-command}
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
---
|
|
83
|
-
|
|
84
|
-
### 2. {Major Feature 2 Name}
|
|
85
|
-
|
|
86
|
-
{Comprehensive feature description}
|
|
87
|
-
|
|
88
|
-
**Algorithm**:
|
|
89
|
-
1. {Step 1 of algorithm}
|
|
90
|
-
2. {Step 2 with details}
|
|
91
|
-
3. {Step 3 and expected outcome}
|
|
92
|
-
|
|
93
|
-
**Implementation example**:
|
|
94
|
-
```{language}
|
|
95
|
-
{detailed-code-example}
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
---
|
|
99
|
-
|
|
100
|
-
### 3. {Major Feature 3 Name}
|
|
101
|
-
|
|
102
|
-
{Feature description with use cases}
|
|
103
|
-
|
|
104
|
-
**Use Scenario**:
|
|
105
|
-
- **{Scenario A}**: {When and why to use}
|
|
106
|
-
- **{Scenario B}**: {Alternative use case}
|
|
107
|
-
|
|
108
|
-
---
|
|
109
|
-
|
|
110
|
-
## 💡 Usage Pattern
|
|
111
|
-
|
|
112
|
-
### Pattern 1: Manual call
|
|
113
|
-
|
|
114
|
-
**Example User Request**:
|
|
115
|
-
```
|
|
116
|
-
"Please execute {skill-name}"
|
|
117
|
-
"{natural-language-trigger-phrase}"
|
|
118
|
-
```
|
|
119
|
-
|
|
120
|
-
**Alfred Action**:
|
|
121
|
-
1. {What Alfred does in step 1}
|
|
122
|
-
2. {What Alfred does in step 2}
|
|
123
|
-
3. {Final action and result}
|
|
124
|
-
|
|
125
|
-
---
|
|
126
|
-
|
|
127
|
-
### Pattern 2: Automatic activation
|
|
128
|
-
|
|
129
|
-
**Trigger condition**: {When automatic activation occurs}
|
|
130
|
-
|
|
131
|
-
**Alfred detection scenario**:
|
|
132
|
-
```
|
|
133
|
-
User: "{example-user-request}"
|
|
134
|
-
→ Alfred Analysis: {how Alfred recognizes this needs the skill}
|
|
135
|
-
→ Autoplay: {what happens automatically}
|
|
136
|
-
→ Result: {what user receives}
|
|
137
|
-
```
|
|
138
|
-
|
|
139
|
-
---
|
|
140
|
-
|
|
141
|
-
### Pattern 3: Command integration
|
|
142
|
-
|
|
143
|
-
**Related command**: `/{command-name}`
|
|
144
|
-
|
|
145
|
-
**Integrated Flow**:
|
|
146
|
-
```
|
|
147
|
-
Run /{command-name}
|
|
148
|
-
↓
|
|
149
|
-
{When skill is invoked during command}
|
|
150
|
-
↓
|
|
151
|
-
Automatically call this skill
|
|
152
|
-
↓
|
|
153
|
-
{What skill contributes}
|
|
154
|
-
↓
|
|
155
|
-
Continue command
|
|
156
|
-
```
|
|
157
|
-
|
|
158
|
-
---
|
|
159
|
-
|
|
160
|
-
## ⚙️ Settings and configuration
|
|
161
|
-
|
|
162
|
-
### Configuration file location
|
|
163
|
-
|
|
164
|
-
Configure in `.moai/config.json`:
|
|
165
|
-
|
|
166
|
-
```json
|
|
167
|
-
{
|
|
168
|
-
"{skill-config-section}": {
|
|
169
|
-
"{option1}": {default-value},
|
|
170
|
-
"{option2}": {default-value},
|
|
171
|
-
"{option3}": {
|
|
172
|
-
"{sub-option1}": {value},
|
|
173
|
-
"{sub-option2}": {value}
|
|
174
|
-
}
|
|
175
|
-
}
|
|
176
|
-
}
|
|
177
|
-
```
|
|
178
|
-
|
|
179
|
-
### Setting option details
|
|
180
|
-
|
|
181
|
-
| Options | Type | default | Required | Description |
|
|
182
|
-
| ----------- | ------ | ----------- | -------- | --------------------------- |
|
|
183
|
-
| `{option1}` | {type} | `{default}` | ✅/⚠️ | {Comprehensive description} |
|
|
184
|
-
| `{option2}` | {type} | `{default}` | ⚠️ | {What this controls} |
|
|
185
|
-
| `{option3}` | {type} | `{default}` | ⚠️ | {Usage notes} |
|
|
186
|
-
|
|
187
|
-
### Environment variables (optional)
|
|
188
|
-
|
|
189
|
-
```bash
|
|
190
|
-
# {Environment variable 1}
|
|
191
|
-
export {VAR_NAME_1}="{value}"
|
|
192
|
-
|
|
193
|
-
# {Environment variable 2}
|
|
194
|
-
export {VAR_NAME_2}="{value}"
|
|
195
|
-
```
|
|
196
|
-
|
|
197
|
-
---
|
|
198
|
-
|
|
199
|
-
## 📁 Directory Structure
|
|
200
|
-
|
|
201
|
-
```
|
|
202
|
-
.claude/skills/{skill-name}/
|
|
203
|
-
├── SKILL.md # Main skill definition (this file)
|
|
204
|
-
├── reference.md # Detailed reference document
|
|
205
|
-
├── examples.md # Collection of practical examples
|
|
206
|
-
├── scripts/ # Utility script
|
|
207
|
-
│ ├── {helper-1}.py
|
|
208
|
-
│ └── {helper-2}.py
|
|
209
|
-
└── templates/ # template file
|
|
210
|
-
├── {template-1}.txt
|
|
211
|
-
└── {template-2}.json
|
|
212
|
-
```
|
|
213
|
-
|
|
214
|
-
### Additional file descriptions
|
|
215
|
-
|
|
216
|
-
- **reference.md**: {What additional documentation it contains}
|
|
217
|
-
- **examples.md**: {What examples are provided}
|
|
218
|
-
- **scripts/**: {What utility scripts do}
|
|
219
|
-
- **templates/**: {What templates are included}
|
|
220
|
-
|
|
221
|
-
---
|
|
222
|
-
|
|
223
|
-
## ✅ Verification Checklist
|
|
224
|
-
|
|
225
|
-
### Validation before execution
|
|
226
|
-
|
|
227
|
-
- [ ] {Pre-execution check 1}
|
|
228
|
-
- [ ] {Pre-execution check 2}
|
|
229
|
-
- [ ] {Pre-execution check 3}
|
|
230
|
-
|
|
231
|
-
### Verify after execution
|
|
232
|
-
|
|
233
|
-
- [ ] {Post-execution validation 1 with criteria}
|
|
234
|
-
- [ ] {Post-execution validation 2 with expected state}
|
|
235
|
-
- [ ] {Post-execution validation 3 with deliverable}
|
|
236
|
-
- [ ] {Check MoAI-ADK workflow integration}
|
|
237
|
-
|
|
238
|
-
### Verification command
|
|
239
|
-
|
|
240
|
-
```bash
|
|
241
|
-
# {Validation script 1}
|
|
242
|
-
uv run .claude/skills/{skill-name}/scripts/validate.py
|
|
243
|
-
|
|
244
|
-
# {Validation check 2}
|
|
245
|
-
{verification-command}
|
|
246
|
-
|
|
247
|
-
# {Integration test}
|
|
248
|
-
{integration-test-command}
|
|
249
|
-
```
|
|
250
|
-
|
|
251
|
-
---
|
|
252
|
-
|
|
253
|
-
## 🚨 Error handling
|
|
254
|
-
|
|
255
|
-
### Error classification
|
|
256
|
-
|
|
257
|
-
#### 1. {Error Category 1}
|
|
258
|
-
|
|
259
|
-
**Symptom**: {How this error manifests}
|
|
260
|
-
|
|
261
|
-
**cause**:
|
|
262
|
-
- {Possible cause 1}
|
|
263
|
-
- {Possible cause 2}
|
|
264
|
-
|
|
265
|
-
**Solution**:
|
|
266
|
-
```bash
|
|
267
|
-
# {Solution step 1}
|
|
268
|
-
{command-1}
|
|
269
|
-
|
|
270
|
-
# {Solution step 2}
|
|
271
|
-
{command-2}
|
|
272
|
-
```
|
|
273
|
-
|
|
274
|
-
---
|
|
275
|
-
|
|
276
|
-
#### 2. {Error Category 2}
|
|
277
|
-
|
|
278
|
-
**Symptom**: {Error description}
|
|
279
|
-
|
|
280
|
-
**Debugging**:
|
|
281
|
-
```bash
|
|
282
|
-
# {How to debug}
|
|
283
|
-
{debug-command}
|
|
284
|
-
```
|
|
285
|
-
|
|
286
|
-
**correction**:
|
|
287
|
-
1. {Fix step 1}
|
|
288
|
-
2. {Fix step 2}
|
|
289
|
-
|
|
290
|
-
---
|
|
291
|
-
|
|
292
|
-
### Logging and Debugging
|
|
293
|
-
|
|
294
|
-
**Log Location**: `{log-file-path}`
|
|
295
|
-
|
|
296
|
-
**Log level settings**:
|
|
297
|
-
```bash
|
|
298
|
-
# {How to enable debug logging}
|
|
299
|
-
{logging-config-command}
|
|
300
|
-
```
|
|
301
|
-
|
|
302
|
-
**Check log**:
|
|
303
|
-
```bash
|
|
304
|
-
# {How to view logs}
|
|
305
|
-
tail -f {log-file-path}
|
|
306
|
-
```
|
|
307
|
-
|
|
308
|
-
---
|
|
309
|
-
|
|
310
|
-
## 🔗 Related agents/commands
|
|
311
|
-
|
|
312
|
-
### Related commands
|
|
313
|
-
|
|
314
|
-
- **/{command-1}** - {How this skill supports the command}
|
|
315
|
-
- **/{command-2}** - {Integration point}
|
|
316
|
-
|
|
317
|
-
### Associated Agent
|
|
318
|
-
|
|
319
|
-
- **@agent-{agent-1}** - {How they work together}
|
|
320
|
-
- **@agent-{agent-2}** - {Collaboration scenario}
|
|
321
|
-
|
|
322
|
-
### Related skills
|
|
323
|
-
|
|
324
|
-
- **{skill-1}** - {Complementary functionality}
|
|
325
|
-
- **{skill-2}** - {When to use together}
|
|
326
|
-
|
|
327
|
-
---
|
|
328
|
-
|
|
329
|
-
## 📊 Performance and Metrics
|
|
330
|
-
|
|
331
|
-
### Performance characteristics
|
|
332
|
-
|
|
333
|
-
- **Execution time**: {Typical execution time}
|
|
334
|
-
- **Memory usage**: {Expected memory usage}
|
|
335
|
-
- **Disk I/O**: {File operations count}
|
|
336
|
-
- **Network**: {External API calls if any}
|
|
337
|
-
|
|
338
|
-
### Optimization tips
|
|
339
|
-
|
|
340
|
-
1. **{Optimization 1}**: {How to improve performance}
|
|
341
|
-
2. **{Optimization 2}**: {Configuration tweak}
|
|
342
|
-
3. **{Optimization 3}**: {Best practice}
|
|
343
|
-
|
|
344
|
-
---
|
|
345
|
-
|
|
346
|
-
## 🎓 Best Practices
|
|
347
|
-
|
|
348
|
-
### 1. {Practice Category 1}
|
|
349
|
-
|
|
350
|
-
**Recommendation**:
|
|
351
|
-
```{language}
|
|
352
|
-
# {Good practice example}
|
|
353
|
-
{recommended-code}
|
|
354
|
-
```
|
|
355
|
-
|
|
356
|
-
**What to avoid**:
|
|
357
|
-
```{language}
|
|
358
|
-
# {Anti-pattern example}
|
|
359
|
-
{avoid-this-code}
|
|
360
|
-
```
|
|
361
|
-
|
|
362
|
-
**Reason**: {Why this is best practice}
|
|
363
|
-
|
|
364
|
-
---
|
|
365
|
-
|
|
366
|
-
### 2. {Practice Category 2}
|
|
367
|
-
|
|
368
|
-
**Tip**: {Helpful tip}
|
|
369
|
-
|
|
370
|
-
**example**:
|
|
371
|
-
```bash
|
|
372
|
-
{example-of-best-practice}
|
|
373
|
-
```
|
|
374
|
-
|
|
375
|
-
---
|
|
376
|
-
|
|
377
|
-
### 3. {Practice Category 3}
|
|
378
|
-
|
|
379
|
-
**Caution**: {Important consideration}
|
|
380
|
-
|
|
381
|
-
---
|
|
382
|
-
|
|
383
|
-
## 📖 Practical examples
|
|
384
|
-
|
|
385
|
-
### Example 1: {Common Use Case}
|
|
386
|
-
|
|
387
|
-
**Purpose**: {What this example demonstrates}
|
|
388
|
-
|
|
389
|
-
**input**:
|
|
390
|
-
```{format}
|
|
391
|
-
{example-input}
|
|
392
|
-
```
|
|
393
|
-
|
|
394
|
-
**execution**:
|
|
395
|
-
```bash
|
|
396
|
-
{commands-to-run}
|
|
397
|
-
```
|
|
398
|
-
|
|
399
|
-
**output of power**:
|
|
400
|
-
```{format}
|
|
401
|
-
{example-output}
|
|
402
|
-
```
|
|
403
|
-
|
|
404
|
-
**Explanation**: {What happened and why}
|
|
405
|
-
|
|
406
|
-
---
|
|
407
|
-
|
|
408
|
-
### Example 2: {Advanced Use Case}
|
|
409
|
-
|
|
410
|
-
**Purpose**: {Advanced scenario}
|
|
411
|
-
|
|
412
|
-
**Scenario**: {Detailed scenario description}
|
|
413
|
-
|
|
414
|
-
**avatar**:
|
|
415
|
-
```{language}
|
|
416
|
-
{implementation-code}
|
|
417
|
-
```
|
|
418
|
-
|
|
419
|
-
**Result**: {What you achieve}
|
|
420
|
-
|
|
421
|
-
---
|
|
422
|
-
|
|
423
|
-
### Example 3: {Edge Case}
|
|
424
|
-
|
|
425
|
-
**Scenario**: {Unusual but important scenario}
|
|
426
|
-
|
|
427
|
-
**How to handle**: {How skill handles this}
|
|
428
|
-
|
|
429
|
-
---
|
|
430
|
-
|
|
431
|
-
## 🔧 Customization
|
|
432
|
-
|
|
433
|
-
### Extension points
|
|
434
|
-
|
|
435
|
-
Areas where you can customize this skill to fit your project:
|
|
436
|
-
|
|
437
|
-
1. **{Extension Point 1}**
|
|
438
|
-
- File: `{file-to-modify}`
|
|
439
|
-
- How to modify: {How to customize}
|
|
440
|
-
|
|
441
|
-
2. **{Extension Point 2}**
|
|
442
|
-
- Settings: `{config-key}`
|
|
443
|
-
- Options: {Available options}
|
|
444
|
-
|
|
445
|
-
### Plugin system (advanced)
|
|
446
|
-
|
|
447
|
-
```python
|
|
448
|
-
# {How to create plugins for this skill}
|
|
449
|
-
{plugin-example-code}
|
|
450
|
-
```
|
|
451
|
-
|
|
452
|
-
---
|
|
453
|
-
|
|
454
|
-
## 📚 References
|
|
455
|
-
|
|
456
|
-
### Official Documentation
|
|
457
|
-
- **Claude Code Skills**: https://docs.claude.com/en/docs/claude-code/skills
|
|
458
|
-
- **{Related Doc}**: {URL}
|
|
459
|
-
|
|
460
|
-
### MoAI-ADK Resources
|
|
461
|
-
- **Development Guide**: `.moai/memory/development-guide.md`
|
|
462
|
-
- **SPEC Metadata**: `.moai/memory/spec-metadata.md`
|
|
463
|
-
|
|
464
|
-
### Community
|
|
465
|
-
- **GitHub Issues**: {Link}
|
|
466
|
-
- **Discussion**: {Link}
|
|
467
|
-
|
|
468
|
-
---
|
|
469
|
-
|
|
470
|
-
## 🔄 Update log
|
|
471
|
-
|
|
472
|
-
### v1.0.0 (Initial)
|
|
473
|
-
- {Feature 1 introduced}
|
|
474
|
-
- {Feature 2 implemented}
|
|
475
|
-
- {Initial release notes}
|
|
476
|
-
|
|
477
|
-
---
|
|
478
|
-
|
|
479
|
-
**Template Level**: Full
|
|
480
|
-
**Best For**: Production MoAI-ADK integration, enterprise workflows
|
|
481
|
-
**Features**:
|
|
482
|
-
- Alfred auto-selection
|
|
483
|
-
- Workflow integration
|
|
484
|
-
- Detailed settings
|
|
485
|
-
- Verification automation
|
|
486
|
-
- Error handling
|
|
487
|
-
- Performance optimization
|
|
488
|
-
|
|
489
|
-
**Directory Structure**: Full (SKILL.md + reference.md + examples.md + scripts/ + templates/)
|
|
490
|
-
**Estimated Setup Time**: 45-60 minutes
|
|
491
|
-
**Maintenance**: Regular updates as workflow evolves
|
|
492
|
-
**Support**: Full MoAI-ADK integration support
|
|
493
|
-
|
|
494
|
-
---
|
|
495
|
-
|
|
496
|
-
This skill provides the highest level of automation in {domain}.
|
|
@@ -1,123 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: moai-lang-clojure
|
|
3
|
-
version: 2.0.0
|
|
4
|
-
created: 2025-10-22
|
|
5
|
-
updated: 2025-10-22
|
|
6
|
-
status: active
|
|
7
|
-
description: Clojure 1.12+ best practices with clojure.test, Leiningen 2.11, and immutable data structures.
|
|
8
|
-
keywords: ['clojure', 'clojure.test', 'leiningen', 'immutable']
|
|
9
|
-
allowed-tools:
|
|
10
|
-
- Read
|
|
11
|
-
- Bash
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
# Lang Clojure Skill
|
|
15
|
-
|
|
16
|
-
## Skill Metadata
|
|
17
|
-
|
|
18
|
-
| Field | Value |
|
|
19
|
-
| ----- | ----- |
|
|
20
|
-
| **Skill Name** | moai-lang-clojure |
|
|
21
|
-
| **Version** | 2.0.0 (2025-10-22) |
|
|
22
|
-
| **Allowed tools** | Read (read_file), Bash (terminal) |
|
|
23
|
-
| **Auto-load** | On demand when keywords detected |
|
|
24
|
-
| **Tier** | Language |
|
|
25
|
-
|
|
26
|
-
---
|
|
27
|
-
|
|
28
|
-
## What It Does
|
|
29
|
-
|
|
30
|
-
Clojure 1.12+ best practices with clojure.test, Leiningen 2.11, and immutable data structures.
|
|
31
|
-
|
|
32
|
-
**Key capabilities**:
|
|
33
|
-
- ✅ Best practices enforcement for language domain
|
|
34
|
-
- ✅ TRUST 5 principles integration
|
|
35
|
-
- ✅ Latest tool versions (2025-10-22)
|
|
36
|
-
- ✅ TDD workflow support
|
|
37
|
-
|
|
38
|
-
---
|
|
39
|
-
|
|
40
|
-
## When to Use
|
|
41
|
-
|
|
42
|
-
**Automatic triggers**:
|
|
43
|
-
- Related code discussions and file patterns
|
|
44
|
-
- SPEC implementation (`/alfred:2-run`)
|
|
45
|
-
- Code review requests
|
|
46
|
-
|
|
47
|
-
**Manual invocation**:
|
|
48
|
-
- Review code for TRUST 5 compliance
|
|
49
|
-
- Design new features
|
|
50
|
-
- Troubleshoot issues
|
|
51
|
-
|
|
52
|
-
---
|
|
53
|
-
|
|
54
|
-
## Tool Version Matrix (2025-10-22)
|
|
55
|
-
|
|
56
|
-
| Tool | Version | Purpose | Status |
|
|
57
|
-
|------|---------|---------|--------|
|
|
58
|
-
| **Clojure** | 1.12.0 | Primary | ✅ Current |
|
|
59
|
-
| **Leiningen** | 2.11.2 | Primary | ✅ Current |
|
|
60
|
-
| **clojure.test** | 1.12.0 | Primary | ✅ Current |
|
|
61
|
-
|
|
62
|
-
---
|
|
63
|
-
|
|
64
|
-
## Inputs
|
|
65
|
-
|
|
66
|
-
- Language-specific source directories
|
|
67
|
-
- Configuration files
|
|
68
|
-
- Test suites and sample data
|
|
69
|
-
|
|
70
|
-
## Outputs
|
|
71
|
-
|
|
72
|
-
- Test/lint execution plan
|
|
73
|
-
- TRUST 5 review checkpoints
|
|
74
|
-
- Migration guidance
|
|
75
|
-
|
|
76
|
-
## Failure Modes
|
|
77
|
-
|
|
78
|
-
- When required tools are not installed
|
|
79
|
-
- When dependencies are missing
|
|
80
|
-
- When test coverage falls below 85%
|
|
81
|
-
|
|
82
|
-
## Dependencies
|
|
83
|
-
|
|
84
|
-
- Access to project files via Read/Bash tools
|
|
85
|
-
- Integration with `moai-foundation-langs` for language detection
|
|
86
|
-
- Integration with `moai-foundation-trust` for quality gates
|
|
87
|
-
|
|
88
|
-
---
|
|
89
|
-
|
|
90
|
-
## References (Latest Documentation)
|
|
91
|
-
|
|
92
|
-
_Documentation links updated 2025-10-22_
|
|
93
|
-
|
|
94
|
-
---
|
|
95
|
-
|
|
96
|
-
## Changelog
|
|
97
|
-
|
|
98
|
-
- **v2.0.0** (2025-10-22): Major update with latest tool versions, comprehensive best practices, TRUST 5 integration
|
|
99
|
-
- **v1.0.0** (2025-03-29): Initial Skill release
|
|
100
|
-
|
|
101
|
-
---
|
|
102
|
-
|
|
103
|
-
## Works Well With
|
|
104
|
-
|
|
105
|
-
- `moai-foundation-trust` (quality gates)
|
|
106
|
-
- `moai-alfred-code-reviewer` (code review)
|
|
107
|
-
- `moai-essentials-debug` (debugging support)
|
|
108
|
-
|
|
109
|
-
---
|
|
110
|
-
|
|
111
|
-
## Best Practices
|
|
112
|
-
|
|
113
|
-
✅ **DO**:
|
|
114
|
-
- Follow language best practices
|
|
115
|
-
- Use latest stable tool versions
|
|
116
|
-
- Maintain test coverage ≥85%
|
|
117
|
-
- Document all public APIs
|
|
118
|
-
|
|
119
|
-
❌ **DON'T**:
|
|
120
|
-
- Skip quality gates
|
|
121
|
-
- Use deprecated tools
|
|
122
|
-
- Ignore security warnings
|
|
123
|
-
- Mix testing frameworks
|
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
# moai-lang-clojure - Working Examples
|
|
2
|
-
|
|
3
|
-
_Last updated: 2025-10-22_
|
|
4
|
-
|
|
5
|
-
## Example 1: Basic Setup
|
|
6
|
-
|
|
7
|
-
```bash
|
|
8
|
-
# Setup commands
|
|
9
|
-
# ...
|
|
10
|
-
```
|
|
11
|
-
|
|
12
|
-
## Example 2: TDD Workflow
|
|
13
|
-
|
|
14
|
-
```bash
|
|
15
|
-
# RED: Write failing test
|
|
16
|
-
# GREEN: Implement feature
|
|
17
|
-
# REFACTOR: Improve code
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
## Example 3: Quality Gate
|
|
21
|
-
|
|
22
|
-
```bash
|
|
23
|
-
# Run quality checks
|
|
24
|
-
# Verify coverage ≥85%
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
---
|
|
28
|
-
|
|
29
|
-
_For more examples, see SKILL.md reference section_
|
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
# moai-lang-clojure - CLI Reference
|
|
2
|
-
|
|
3
|
-
_Last updated: 2025-10-22_
|
|
4
|
-
|
|
5
|
-
## Quick Reference
|
|
6
|
-
|
|
7
|
-
### Installation
|
|
8
|
-
|
|
9
|
-
```bash
|
|
10
|
-
# Installation commands
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
### Common Commands
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
# Test
|
|
17
|
-
# Lint
|
|
18
|
-
# Format
|
|
19
|
-
# Build
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
## Tool Versions (2025-10-22)
|
|
23
|
-
|
|
24
|
-
- **Clojure**: 1.12.0
|
|
25
|
-
- **Leiningen**: 2.11.2
|
|
26
|
-
- **clojure.test**: 1.12.0
|
|
27
|
-
|
|
28
|
-
---
|
|
29
|
-
|
|
30
|
-
_For detailed usage, see SKILL.md_
|