@musashishao/agent-kit 1.1.0 → 1.1.1
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 @musashishao/agent-kit might be problematic. Click here for more details.
- package/.agent/ARCHITECTURE.md +2 -2
- package/.agent/CONTEXT.md +3 -3
- package/.agent/FEATURE_ROADMAP.md +32 -32
- package/.agent/PROMPT_TEMPLATES.md +8 -8
- package/.agent/plans/codex-cli-integration.md +338 -0
- package/.agent/plans/rename-to-agent-kit.md +40 -0
- package/.agent/skills/doc.md +5 -5
- package/README.md +1 -1
- package/bin/cli.js +77 -6
- package/package.json +1 -1
package/.agent/ARCHITECTURE.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Agent Kit Architecture
|
|
2
2
|
|
|
3
3
|
> **Version 5.0** - Comprehensive AI Agent Capability Expansion Toolkit
|
|
4
4
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
## 📋 Overview
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
Agent Kit is a modular system consisting of:
|
|
10
10
|
- **16 Specialist Agents** - Role-based AI personas
|
|
11
11
|
- **40 Skills** - Domain-specific knowledge modules
|
|
12
12
|
- **11 Workflows** - Slash command procedures
|
package/.agent/CONTEXT.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Agent Kit - AI Development Context
|
|
2
2
|
|
|
3
3
|
> **Version:** 2.0.0
|
|
4
4
|
> **Last Updated:** 2026-01-21
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
## 🎯 Project Overview
|
|
10
10
|
|
|
11
|
-
**
|
|
11
|
+
**Agent Kit** là một bộ AI Agent templates bao gồm Skills, Agents, và Workflows để tăng cường khả năng của AI coding assistants.
|
|
12
12
|
|
|
13
13
|
### Tech Stack
|
|
14
14
|
| Layer | Technology |
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
|
|
23
23
|
### Project Structure
|
|
24
24
|
```
|
|
25
|
-
|
|
25
|
+
agent-kit/
|
|
26
26
|
├── .agent/ # 🧠 AI Agent System (CORE)
|
|
27
27
|
│ ├── agents/ # 16 Specialist Agents
|
|
28
28
|
│ ├── skills/ # 40 Domain Skills
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# 🚀 Feature Roadmap -
|
|
1
|
+
# 🚀 Feature Roadmap - Agent Kit
|
|
2
2
|
|
|
3
3
|
> Nghiên cứu từ: ClaudeKit, Claude Code, Task Master, Cursor Rules, và các AI Agent frameworks 2025
|
|
4
4
|
> Ngày tạo: 2026-01-21
|
|
@@ -7,12 +7,12 @@
|
|
|
7
7
|
|
|
8
8
|
## 📊 So Sánh Với Đối Thủ
|
|
9
9
|
|
|
10
|
-
| Feature | ClaudeKit | Task Master | Claude Code | **
|
|
10
|
+
| Feature | ClaudeKit | Task Master | Claude Code | **Agent Kit** |
|
|
11
11
|
|---------|-----------|-------------|-------------|---------------------|
|
|
12
12
|
| Skills/Agents | 50+ skills, 45 agents | Task-focused | Plugins | 40 skills, 16 agents |
|
|
13
13
|
| Marketplace | ✅ Plugin marketplace | ✅ npm package | ✅ Plugins dir | ❌ Manual install |
|
|
14
14
|
| MCP Support | ✅ mcp-builder, mcp-management | ✅ MCP integration | ✅ Built-in | ✅ mcp-builder skill |
|
|
15
|
-
| CLI Tool | ❌ | ✅ task-master CLI | ✅ claude CLI | ⚠️ Basic (
|
|
15
|
+
| CLI Tool | ❌ | ✅ task-master CLI | ✅ claude CLI | ⚠️ Basic (agent-kit) |
|
|
16
16
|
| Task Management | ❌ | ✅ (Core feature) | ⚠️ Basic | ❌ Missing |
|
|
17
17
|
| Web UI/Dashboard | ❌ | ❌ | ❌ | ⚠️ Docs only |
|
|
18
18
|
| Multi-AI Support | ✅ Claude-focused | ✅ Any AI chat | ✅ Claude only | ✅ Gemini + others |
|
|
@@ -52,24 +52,24 @@ Thêm:
|
|
|
52
52
|
### 1.2 📦 Plugin Marketplace System
|
|
53
53
|
**Thấy ở:** ClaudeKit, Claude Code plugins
|
|
54
54
|
|
|
55
|
-
**Hiện tại:** `npx @vudovn/
|
|
55
|
+
**Hiện tại:** `npx @vudovn/agent-kit init` chỉ install tất cả
|
|
56
56
|
|
|
57
57
|
**Đề xuất:**
|
|
58
58
|
```bash
|
|
59
59
|
# Selective install
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
60
|
+
agent-kit install skill:react-patterns
|
|
61
|
+
agent-kit install agent:frontend-specialist
|
|
62
|
+
agent-kit install workflow:debug
|
|
63
63
|
|
|
64
64
|
# Marketplace commands
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
65
|
+
agent-kit search "database"
|
|
66
|
+
agent-kit list --installed
|
|
67
|
+
agent-kit update
|
|
68
68
|
|
|
69
69
|
# Plugin bundles
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
70
|
+
agent-kit install bundle:web-dev # React + Next.js + Tailwind
|
|
71
|
+
agent-kit install bundle:backend # API + Database + DevOps
|
|
72
|
+
agent-kit install bundle:mobile # React Native + Flutter
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
**Lợi ích:**
|
|
@@ -264,36 +264,36 @@ agents/
|
|
|
264
264
|
|
|
265
265
|
### Hiện tại:
|
|
266
266
|
```bash
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
267
|
+
agent-kit init
|
|
268
|
+
agent-kit update
|
|
269
|
+
agent-kit status
|
|
270
270
|
```
|
|
271
271
|
|
|
272
272
|
### Đề xuất thêm:
|
|
273
273
|
```bash
|
|
274
274
|
# Skill management
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
275
|
+
agent-kit skills list # List all available skills
|
|
276
|
+
agent-kit skills search "api" # Search skills
|
|
277
|
+
agent-kit skills install <name> # Install specific skill
|
|
278
|
+
agent-kit skills remove <name> # Remove skill
|
|
279
|
+
agent-kit skills update # Update installed skills
|
|
280
280
|
|
|
281
281
|
# Agent management
|
|
282
|
-
|
|
283
|
-
|
|
282
|
+
agent-kit agents list
|
|
283
|
+
agent-kit agents info <name> # Show agent details
|
|
284
284
|
|
|
285
285
|
# Workflow management
|
|
286
|
-
|
|
287
|
-
|
|
286
|
+
agent-kit workflows list
|
|
287
|
+
agent-kit workflows run <name> # Run workflow programmatically
|
|
288
288
|
|
|
289
289
|
# Project analysis
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
290
|
+
agent-kit analyze # Analyze project, suggest skills
|
|
291
|
+
agent-kit doctor # Check configuration issues
|
|
292
|
+
agent-kit stats # Show usage statistics
|
|
293
293
|
|
|
294
294
|
# Export/Share
|
|
295
|
-
|
|
296
|
-
|
|
295
|
+
agent-kit export skill <name> # Export skill as standalone
|
|
296
|
+
agent-kit share # Share config to team
|
|
297
297
|
```
|
|
298
298
|
|
|
299
299
|
---
|
|
@@ -414,7 +414,7 @@ compatible_with:
|
|
|
414
414
|
2. **Add problem-solving skills** (6 frameworks) ✅ Done
|
|
415
415
|
3. **Add `mermaidjs` skill** for diagrams
|
|
416
416
|
4. **Add `context-engineering` skill** ✅ Done
|
|
417
|
-
5. **Improve CLI với `
|
|
417
|
+
5. **Improve CLI với `agent-kit skills list`**
|
|
418
418
|
6. **Add `/task` workflow** cho task management
|
|
419
419
|
|
|
420
420
|
---
|
|
@@ -428,7 +428,7 @@ compatible_with:
|
|
|
428
428
|
|
|
429
429
|
---
|
|
430
430
|
|
|
431
|
-
> **Kết luận:**
|
|
431
|
+
> **Kết luận:** Agent Kit có foundation tốt với 40 skills và 16 agents. Để cạnh tranh với ClaudeKit và Task Master, cần tập trung vào:
|
|
432
432
|
> 1. **MCP Support** (must have 2025)
|
|
433
433
|
> 2. **Plugin Marketplace** (selective install)
|
|
434
434
|
> 3. **Task Management** (workflow productivity)
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# 🎯 Prompt Templates cho
|
|
1
|
+
# 🎯 Prompt Templates cho agent Kit
|
|
2
2
|
|
|
3
3
|
> Copy-paste các prompt mẫu bên dưới để sử dụng với AI Agent
|
|
4
4
|
|
|
@@ -7,10 +7,10 @@
|
|
|
7
7
|
## 📌 PROMPT 1: Context Khởi Đầu (Dùng mỗi session mới)
|
|
8
8
|
|
|
9
9
|
```
|
|
10
|
-
Tôi đang phát triển dự án
|
|
10
|
+
Tôi đang phát triển dự án agent Kit - một bộ AI Agent templates.
|
|
11
11
|
|
|
12
12
|
## Project Info
|
|
13
|
-
- **Repo:**
|
|
13
|
+
- **Repo:** agent-kit
|
|
14
14
|
- **Tech:** Next.js 16.1.3, React 19, TypeScript, Tailwind CSS 4
|
|
15
15
|
- **Structure:**
|
|
16
16
|
- `.agent/` = AI Agent templates (16 agents, 40 skills, 11 workflows)
|
|
@@ -37,7 +37,7 @@ Hãy đọc file `.agent/CONTEXT.md` để hiểu đầy đủ context của d
|
|
|
37
37
|
## 📌 PROMPT 2: Thêm Feature Mới
|
|
38
38
|
|
|
39
39
|
```
|
|
40
|
-
Tôi muốn thêm feature mới vào
|
|
40
|
+
Tôi muốn thêm feature mới vào agent Kit.
|
|
41
41
|
|
|
42
42
|
## Feature: [TÊN FEATURE]
|
|
43
43
|
|
|
@@ -66,7 +66,7 @@ Hãy implement theo đúng code style của project (xem `.agent/CONTEXT.md`).
|
|
|
66
66
|
## 📌 PROMPT 3: Fix Bug / Debug
|
|
67
67
|
|
|
68
68
|
```
|
|
69
|
-
Tôi gặp bug trong
|
|
69
|
+
Tôi gặp bug trong agent Kit.
|
|
70
70
|
|
|
71
71
|
## Bug Description
|
|
72
72
|
[Mô tả bug]
|
|
@@ -179,7 +179,7 @@ Format xem: `.agent/ARCHITECTURE.md`
|
|
|
179
179
|
## 📌 PROMPT 7: Code Review
|
|
180
180
|
|
|
181
181
|
```
|
|
182
|
-
Hãy review code của tôi cho
|
|
182
|
+
Hãy review code của tôi cho agent Kit.
|
|
183
183
|
|
|
184
184
|
## Files to Review
|
|
185
185
|
- `[file1]`
|
|
@@ -201,7 +201,7 @@ Checklist xem: `.agent/skills/code-review-checklist/SKILL.md`
|
|
|
201
201
|
## 📌 PROMPT 8: Deploy/Release
|
|
202
202
|
|
|
203
203
|
```
|
|
204
|
-
Tôi muốn deploy/release
|
|
204
|
+
Tôi muốn deploy/release agent Kit.
|
|
205
205
|
|
|
206
206
|
## Release Type
|
|
207
207
|
- [ ] Patch (bug fixes)
|
|
@@ -229,7 +229,7 @@ Guidelines xem: `.agent/skills/deployment-procedures/SKILL.md`
|
|
|
229
229
|
|
|
230
230
|
```
|
|
231
231
|
# Homepage
|
|
232
|
-
Cải thiện homepage của
|
|
232
|
+
Cải thiện homepage của agent Kit, làm nó impressive hơn với animations.
|
|
233
233
|
|
|
234
234
|
# Performance
|
|
235
235
|
Tối ưu performance của documentation site, target Lighthouse 90+.
|
|
@@ -0,0 +1,338 @@
|
|
|
1
|
+
# Implementation Plan: Codex CLI Integration
|
|
2
|
+
|
|
3
|
+
> **Created:** 2026-01-23
|
|
4
|
+
> **Status:** Draft
|
|
5
|
+
> **Priority:** High
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 📊 Research Summary
|
|
10
|
+
|
|
11
|
+
### What is Codex CLI?
|
|
12
|
+
|
|
13
|
+
OpenAI Codex CLI là một công cụ AI coding agent chạy terminal, sử dụng file `AGENTS.md` làm context để hiểu project và thực hiện các tác vụ coding.
|
|
14
|
+
|
|
15
|
+
### Key Findings
|
|
16
|
+
|
|
17
|
+
| Aspect | Detail |
|
|
18
|
+
|--------|--------|
|
|
19
|
+
| **Config File** | `AGENTS.md` (project root) |
|
|
20
|
+
| **Format** | Plain Markdown - flexible structure |
|
|
21
|
+
| **Discovery** | Auto-reads from project root |
|
|
22
|
+
| **Monorepo** | Supports nested `AGENTS.md` files |
|
|
23
|
+
| **Adoption** | 60k+ open-source projects |
|
|
24
|
+
| **Standard** | Open standard by Linux Foundation |
|
|
25
|
+
|
|
26
|
+
### AGENTS.md Recommended Sections
|
|
27
|
+
|
|
28
|
+
1. **Project Overview** - What the project does
|
|
29
|
+
2. **Setup Commands** - Install, dev, build, test
|
|
30
|
+
3. **Code Style** - Conventions, patterns
|
|
31
|
+
4. **Testing Instructions** - How to run tests
|
|
32
|
+
5. **Security Considerations** - Guidelines
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## 🎯 Problem Analysis
|
|
37
|
+
|
|
38
|
+
### Current State (Agent Kit)
|
|
39
|
+
|
|
40
|
+
```
|
|
41
|
+
.agent/
|
|
42
|
+
├── rules/GEMINI.md # → Gemini CLI (config: .gemini/settings.json)
|
|
43
|
+
├── agents/ # 16 agents
|
|
44
|
+
├── skills/ # 40 skills
|
|
45
|
+
└── workflows/ # 11 workflows
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
**Issues:**
|
|
49
|
+
1. ❌ Không có `AGENTS.md` ở root → Codex CLI không đọc được
|
|
50
|
+
2. ❌ `GEMINI.md` chỉ cho Gemini CLI, không tương thích Codex
|
|
51
|
+
3. ❌ Thiếu cấu trúc modular cho multi-platform support
|
|
52
|
+
|
|
53
|
+
### Target State
|
|
54
|
+
|
|
55
|
+
```
|
|
56
|
+
agent-kit/
|
|
57
|
+
├── AGENTS.md # ← NEW: Universal entry point
|
|
58
|
+
├── .codex/ # ← NEW: Codex-specific config (optional)
|
|
59
|
+
│ └── instructions.md
|
|
60
|
+
├── .agent/
|
|
61
|
+
│ ├── rules/
|
|
62
|
+
│ │ ├── GEMINI.md # Gemini-specific
|
|
63
|
+
│ │ ├── CODEX.md # ← NEW: Codex-specific rules
|
|
64
|
+
│ │ └── SHARED.md # ← NEW: Common rules
|
|
65
|
+
│ └── ...
|
|
66
|
+
└── bin/cli.js # Update to generate AGENTS.md
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## 🛠️ Solution Options
|
|
72
|
+
|
|
73
|
+
### Option A: Single AGENTS.md (Recommended) ⭐
|
|
74
|
+
|
|
75
|
+
**Approach:** Tạo một `AGENTS.md` tổng hợp ở root, include/reference các rules từ `.agent/`
|
|
76
|
+
|
|
77
|
+
**Pros:**
|
|
78
|
+
- ✅ Tuân thủ chuẩn AGENTS.md
|
|
79
|
+
- ✅ Codex CLI auto-discover
|
|
80
|
+
- ✅ Dễ maintain single source of truth
|
|
81
|
+
- ✅ Compatible với 60k+ projects đang dùng
|
|
82
|
+
|
|
83
|
+
**Cons:**
|
|
84
|
+
- ⚠️ Cần sync với GEMINI.md nếu có thay đổi
|
|
85
|
+
|
|
86
|
+
**Implementation:**
|
|
87
|
+
```markdown
|
|
88
|
+
# AGENTS.md
|
|
89
|
+
|
|
90
|
+
## Project Overview
|
|
91
|
+
Agent Kit - AI Agent templates
|
|
92
|
+
|
|
93
|
+
## Setup Commands
|
|
94
|
+
...
|
|
95
|
+
|
|
96
|
+
## Rules
|
|
97
|
+
See `.agent/rules/GEMINI.md` for detailed rules.
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
### Option B: Adapter Pattern
|
|
103
|
+
|
|
104
|
+
**Approach:** Tạo script tự động generate `AGENTS.md` từ `GEMINI.md`
|
|
105
|
+
|
|
106
|
+
**Pros:**
|
|
107
|
+
- ✅ Single source of truth (GEMINI.md)
|
|
108
|
+
- ✅ Auto-sync
|
|
109
|
+
- ✅ Custom transformations
|
|
110
|
+
|
|
111
|
+
**Cons:**
|
|
112
|
+
- ⚠️ Thêm complexity
|
|
113
|
+
- ⚠️ Phải chạy script mỗi khi update
|
|
114
|
+
|
|
115
|
+
**Implementation:**
|
|
116
|
+
```javascript
|
|
117
|
+
// bin/generate-agents-md.js
|
|
118
|
+
const geminiRules = fs.readFileSync('.agent/rules/GEMINI.md');
|
|
119
|
+
const agentsMd = transformToAgentsFormat(geminiRules);
|
|
120
|
+
fs.writeFileSync('AGENTS.md', agentsMd);
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
### Option C: Symlink
|
|
126
|
+
|
|
127
|
+
**Approach:** Symlink `AGENTS.md → .agent/rules/GEMINI.md`
|
|
128
|
+
|
|
129
|
+
**Pros:**
|
|
130
|
+
- ✅ Zero maintenance
|
|
131
|
+
- ✅ Always in sync
|
|
132
|
+
|
|
133
|
+
**Cons:**
|
|
134
|
+
- ❌ GEMINI.md format không tối ưu cho Codex
|
|
135
|
+
- ❌ Windows compatibility issues
|
|
136
|
+
- ❌ Git tracking phức tạp
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
## 📋 Recommended Plan: Option A + CLI Enhancement
|
|
141
|
+
|
|
142
|
+
### Phase 1: Create AGENTS.md (Day 1)
|
|
143
|
+
|
|
144
|
+
**Task 1.1:** Create `/AGENTS.md` at project root
|
|
145
|
+
|
|
146
|
+
```markdown
|
|
147
|
+
# AGENTS.md
|
|
148
|
+
|
|
149
|
+
> Agent Kit - AI Agent Templates for Enhanced Coding Assistants
|
|
150
|
+
|
|
151
|
+
## Project Overview
|
|
152
|
+
|
|
153
|
+
A modular system of AI agent templates:
|
|
154
|
+
- **16 Specialist Agents** - Role-based AI personas
|
|
155
|
+
- **40 Skills** - Domain-specific knowledge
|
|
156
|
+
- **11 Workflows** - Slash command procedures
|
|
157
|
+
|
|
158
|
+
## Setup Commands
|
|
159
|
+
|
|
160
|
+
# Install dependencies
|
|
161
|
+
cd web && npm install
|
|
162
|
+
|
|
163
|
+
# Start dev server
|
|
164
|
+
cd web && npm run dev
|
|
165
|
+
|
|
166
|
+
# Run linting
|
|
167
|
+
cd web && npm run lint
|
|
168
|
+
|
|
169
|
+
# Install agent kit to your project
|
|
170
|
+
npx @musashishao/agent-kit init
|
|
171
|
+
|
|
172
|
+
## Code Style
|
|
173
|
+
|
|
174
|
+
- TypeScript strict mode
|
|
175
|
+
- React functional components with hooks
|
|
176
|
+
- Tailwind CSS for styling
|
|
177
|
+
- Absolute imports with @/ alias
|
|
178
|
+
- CSS variables for theming (dark/light mode)
|
|
179
|
+
|
|
180
|
+
## Project Structure
|
|
181
|
+
|
|
182
|
+
See `.agent/ARCHITECTURE.md` for full documentation.
|
|
183
|
+
|
|
184
|
+
## Testing
|
|
185
|
+
|
|
186
|
+
# Run tests (when available)
|
|
187
|
+
npm test
|
|
188
|
+
|
|
189
|
+
## Security Considerations
|
|
190
|
+
|
|
191
|
+
- All external links: rel="noopener noreferrer"
|
|
192
|
+
- No hardcoded secrets
|
|
193
|
+
- Environment variables for configs
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
**Task 1.2:** Update `.gitignore` if needed
|
|
197
|
+
|
|
198
|
+
---
|
|
199
|
+
|
|
200
|
+
### Phase 2: Refactor Rules Structure (Day 2)
|
|
201
|
+
|
|
202
|
+
**Task 2.1:** Create shared rules file
|
|
203
|
+
|
|
204
|
+
```
|
|
205
|
+
.agent/rules/
|
|
206
|
+
├── GEMINI.md # Gemini CLI specific
|
|
207
|
+
├── CODEX.md # Codex CLI specific (optional)
|
|
208
|
+
├── SHARED.md # Common rules (can be included in both)
|
|
209
|
+
└── README.md # How rules work
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
**Task 2.2:** Extract common rules from GEMINI.md to SHARED.md
|
|
213
|
+
|
|
214
|
+
Common rules to extract:
|
|
215
|
+
- Clean Code standards
|
|
216
|
+
- Socratic Gate protocol
|
|
217
|
+
- Request Classifier
|
|
218
|
+
- Tier 0/1/2 rules
|
|
219
|
+
|
|
220
|
+
---
|
|
221
|
+
|
|
222
|
+
### Phase 3: CLI Enhancement (Day 3)
|
|
223
|
+
|
|
224
|
+
**Task 3.1:** Add `codex` command to CLI
|
|
225
|
+
|
|
226
|
+
Update `bin/cli.js`:
|
|
227
|
+
```javascript
|
|
228
|
+
// New command: npx @musashishao/agent-kit codex
|
|
229
|
+
function codexCommand(options) {
|
|
230
|
+
// Generate AGENTS.md from templates
|
|
231
|
+
// Option to include/exclude rules
|
|
232
|
+
}
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
**Task 3.2:** Add `agents-md` template generation
|
|
236
|
+
|
|
237
|
+
```javascript
|
|
238
|
+
function generateAgentsMd(targetDir) {
|
|
239
|
+
const template = fs.readFileSync(
|
|
240
|
+
path.join(__dirname, '../templates/AGENTS.md')
|
|
241
|
+
);
|
|
242
|
+
// Customize based on project detection
|
|
243
|
+
fs.writeFileSync(path.join(targetDir, 'AGENTS.md'), template);
|
|
244
|
+
}
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
---
|
|
248
|
+
|
|
249
|
+
### Phase 4: Documentation (Day 4)
|
|
250
|
+
|
|
251
|
+
**Task 4.1:** Update README.md
|
|
252
|
+
|
|
253
|
+
Add section:
|
|
254
|
+
```markdown
|
|
255
|
+
## Multi-Platform Support
|
|
256
|
+
|
|
257
|
+
Agent Kit works with:
|
|
258
|
+
|
|
259
|
+
| Platform | Config File | Setup |
|
|
260
|
+
|----------|-------------|-------|
|
|
261
|
+
| Gemini CLI | `.gemini/settings.json` | `{ "contextFileName": ".agent/rules/GEMINI.md" }` |
|
|
262
|
+
| Codex CLI | `AGENTS.md` | Auto-discovered at root |
|
|
263
|
+
| Cursor | `.cursor/rules` | Copy from `.agent/rules/` |
|
|
264
|
+
| Aider | `.aider.conf.yml` | `read: AGENTS.md` |
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
**Task 4.2:** Add docs page
|
|
268
|
+
|
|
269
|
+
Create `web/src/app/docs/platforms/page.tsx`:
|
|
270
|
+
- Gemini CLI setup
|
|
271
|
+
- Codex CLI setup
|
|
272
|
+
- Cursor setup
|
|
273
|
+
- Aider setup
|
|
274
|
+
|
|
275
|
+
---
|
|
276
|
+
|
|
277
|
+
### Phase 5: Templates (Day 5)
|
|
278
|
+
|
|
279
|
+
**Task 5.1:** Create AGENTS.md templates
|
|
280
|
+
|
|
281
|
+
```
|
|
282
|
+
.agent/templates/
|
|
283
|
+
├── AGENTS.md.web # For web projects
|
|
284
|
+
├── AGENTS.md.mobile # For mobile projects
|
|
285
|
+
├── AGENTS.md.backend # For backend projects
|
|
286
|
+
└── AGENTS.md.fullstack # For fullstack projects
|
|
287
|
+
```
|
|
288
|
+
|
|
289
|
+
**Task 5.2:** CLI template selection
|
|
290
|
+
|
|
291
|
+
```bash
|
|
292
|
+
npx @musashishao/agent-kit codex --template web
|
|
293
|
+
npx @musashishao/agent-kit codex --template mobile
|
|
294
|
+
```
|
|
295
|
+
|
|
296
|
+
---
|
|
297
|
+
|
|
298
|
+
## 📊 File Changes Summary
|
|
299
|
+
|
|
300
|
+
| File | Action | Priority |
|
|
301
|
+
|------|--------|----------|
|
|
302
|
+
| `/AGENTS.md` | **CREATE** | P0 |
|
|
303
|
+
| `/bin/cli.js` | UPDATE | P1 |
|
|
304
|
+
| `/.agent/rules/SHARED.md` | CREATE | P2 |
|
|
305
|
+
| `/.agent/rules/CODEX.md` | CREATE | P2 |
|
|
306
|
+
| `/web/src/app/docs/platforms/page.tsx` | CREATE | P3 |
|
|
307
|
+
| `/README.md` | UPDATE | P3 |
|
|
308
|
+
|
|
309
|
+
---
|
|
310
|
+
|
|
311
|
+
## ✅ Success Criteria
|
|
312
|
+
|
|
313
|
+
1. [ ] `AGENTS.md` exists at project root
|
|
314
|
+
2. [ ] Codex CLI can read and use the config
|
|
315
|
+
3. [ ] CLI can generate `AGENTS.md` for user projects
|
|
316
|
+
4. [ ] Documentation covers multi-platform setup
|
|
317
|
+
5. [ ] Templates available for different project types
|
|
318
|
+
|
|
319
|
+
---
|
|
320
|
+
|
|
321
|
+
## 🚀 Quick Start (Minimal)
|
|
322
|
+
|
|
323
|
+
Nếu chỉ muốn làm nhanh, chỉ cần:
|
|
324
|
+
|
|
325
|
+
1. Tạo `/AGENTS.md` ở root (Phase 1)
|
|
326
|
+
2. Done! Codex CLI sẽ tự động đọc
|
|
327
|
+
|
|
328
|
+
**Effort:** ~30 minutes
|
|
329
|
+
**Impact:** Codex CLI compatibility ✅
|
|
330
|
+
|
|
331
|
+
---
|
|
332
|
+
|
|
333
|
+
## 📝 Notes
|
|
334
|
+
|
|
335
|
+
- AGENTS.md là open standard của Linux Foundation
|
|
336
|
+
- 60k+ GitHub repos đang sử dụng
|
|
337
|
+
- Một lần setup, hoạt động với multiple AI tools
|
|
338
|
+
- Không conflict với GEMINI.md (khác file path)
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Plan: Rename Antigravity Kit to Agent Kit
|
|
2
|
+
|
|
3
|
+
Rename all instances of "Antigravity Kit" to "Agent Kit" across the repository to unify the branding.
|
|
4
|
+
|
|
5
|
+
## 1. Analysis
|
|
6
|
+
- **Core Branding:** "Antigravity Kit" -> "Agent Kit"
|
|
7
|
+
- **Internal IDs/Slugs:** Check if "antigravity" is used in folder names or hidden files (e.g., `.antigravityignore`).
|
|
8
|
+
- **Web UI:** Hero section, titles, navigation, and documentation pages need updating.
|
|
9
|
+
- **CLI:** Ensure the CLI messages match the new branding.
|
|
10
|
+
|
|
11
|
+
## 2. Planning (Task Breakdown)
|
|
12
|
+
- [x] **Task 1: Project Metadata & Documentation**
|
|
13
|
+
- Update `README.md` (root and `web/`)
|
|
14
|
+
- Update `.agent/ARCHITECTURE.md`
|
|
15
|
+
- Update `.agent/CONTEXT.md`
|
|
16
|
+
- Update `.agent/FEATURE_ROADMAP.md`
|
|
17
|
+
- [x] **Task 2: Web Application**
|
|
18
|
+
- Update `web/src/app/page.tsx`
|
|
19
|
+
- Update `web/src/app/layout.tsx`
|
|
20
|
+
- Update `web/src/components/donate-dialog.tsx`
|
|
21
|
+
- Update `web/src/app/docs/` (all pages)
|
|
22
|
+
- Update footer and header components
|
|
23
|
+
- [x] **Task 3: CLI & Scripts**
|
|
24
|
+
- Update `bin/cli.js`
|
|
25
|
+
- Update `package.json` if needed
|
|
26
|
+
- [x] **Task 4: File System Cleanup**
|
|
27
|
+
- Rename any files containing "antigravity" in their filename.
|
|
28
|
+
|
|
29
|
+
## 3. Solutioning (Implementation Detail)
|
|
30
|
+
- Use `sed` or similar multi-replace tool for text across many files.
|
|
31
|
+
- Manual check for UI components like `AntigravityGoogle` svg/component.
|
|
32
|
+
- Case sensitivity: Standardize on "Agent Kit" (Title Case) and "agent-kit" (slug).
|
|
33
|
+
|
|
34
|
+
## 4. Implementation
|
|
35
|
+
- (To be executed via multi_replace_file_content and write_to_file)
|
|
36
|
+
|
|
37
|
+
## 5. Verification
|
|
38
|
+
- Search for "Antigravity" again to ensure 0 results.
|
|
39
|
+
- Run `npm run dev` in `web/` to check UI.
|
|
40
|
+
- Run `agent-kit status` to check CLI.
|
package/.agent/skills/doc.md
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Agent Kit Skills
|
|
2
2
|
|
|
3
|
-
> **Hướng dẫn tạo và sử dụng Skills trong
|
|
3
|
+
> **Hướng dẫn tạo và sử dụng Skills trong Agent Kit**
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
## 📋 Giới thiệu
|
|
8
8
|
|
|
9
|
-
Mặc dù các mô hình cơ bản của
|
|
9
|
+
Mặc dù các mô hình cơ bản của Agent Kit (như Gemini) là những mô hình đa năng mạnh mẽ, nhưng chúng không biết ngữ cảnh dự án cụ thể hoặc các tiêu chuẩn của nhóm bạn. Việc tải từng quy tắc hoặc công cụ vào cửa sổ ngữ cảnh của tác nhân sẽ dẫn đến tình trạng "phình to công cụ", chi phí cao hơn, độ trễ và sự nhầm lẫn.
|
|
10
10
|
|
|
11
|
-
**
|
|
11
|
+
**Agent Kit Skills** giải quyết vấn đề này thông qua tính năng **Progressive Disclosure**. Kỹ năng là một gói kiến thức chuyên biệt, ở trạng thái không hoạt động cho đến khi cần. Thông tin này chỉ được tải vào ngữ cảnh của tác nhân khi yêu cầu cụ thể của bạn khớp với nội dung mô tả của kỹ năng.
|
|
12
12
|
|
|
13
13
|
---
|
|
14
14
|
|
|
@@ -39,7 +39,7 @@ my-skill/
|
|
|
39
39
|
### Bước 1: Tạo thư mục
|
|
40
40
|
|
|
41
41
|
```bash
|
|
42
|
-
mkdir -p ~/.
|
|
42
|
+
mkdir -p ~/.agent/agent-kit/skills/code-review
|
|
43
43
|
```
|
|
44
44
|
|
|
45
45
|
### Bước 2: Tạo SKILL.md
|
package/README.md
CHANGED
package/bin/cli.js
CHANGED
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
const fs = require('fs');
|
|
4
4
|
const path = require('path');
|
|
5
|
+
const os = require('os');
|
|
5
6
|
const { execSync } = require('child_process');
|
|
6
7
|
|
|
7
8
|
const VERSION = '1.0.0';
|
|
@@ -36,24 +37,28 @@ ${colors.bright}Usage:${colors.reset}
|
|
|
36
37
|
|
|
37
38
|
${colors.bright}Commands:${colors.reset}
|
|
38
39
|
init Install .agent folder into current project
|
|
39
|
-
|
|
40
|
+
setup-codex Sync workflows with Codex CLI slash commands
|
|
41
|
+
update Update .agent folder to match current package version
|
|
40
42
|
status Check installation status
|
|
41
43
|
|
|
42
44
|
${colors.bright}Options:${colors.reset}
|
|
43
|
-
--force Overwrite existing .agent folder
|
|
45
|
+
--force Overwrite existing .agent folder (REQUIRED for update)
|
|
44
46
|
--path <dir> Install in specific directory
|
|
47
|
+
--prefix <str> Custom prefix for slash commands (default: kit-)
|
|
45
48
|
--quiet Suppress output
|
|
46
49
|
--help Show this help message
|
|
47
50
|
--version Show version
|
|
48
51
|
|
|
49
52
|
${colors.bright}Examples:${colors.reset}
|
|
50
53
|
npx ${PACKAGE_NAME} init
|
|
51
|
-
npx ${PACKAGE_NAME}
|
|
52
|
-
|
|
53
|
-
|
|
54
|
+
npx ${PACKAGE_NAME} setup-codex
|
|
55
|
+
|
|
56
|
+
${colors.yellow}# To ensure you have the latest version from NPM:${colors.reset}
|
|
57
|
+
npx ${PACKAGE_NAME}@latest update
|
|
54
58
|
`);
|
|
55
59
|
}
|
|
56
60
|
|
|
61
|
+
|
|
57
62
|
function showVersion() {
|
|
58
63
|
console.log(`${PACKAGE_NAME} v${VERSION}`);
|
|
59
64
|
}
|
|
@@ -151,6 +156,61 @@ ${colors.bright}📚 Documentation:${colors.reset}
|
|
|
151
156
|
}
|
|
152
157
|
}
|
|
153
158
|
|
|
159
|
+
function setupCodexCommand(options) {
|
|
160
|
+
const codexPromptDir = path.join(os.homedir(), '.codex', 'prompts');
|
|
161
|
+
const agentDir = path.join(process.cwd(), '.agent');
|
|
162
|
+
const workflowDir = path.join(agentDir, 'workflows');
|
|
163
|
+
const prefix = options.prefix || 'kit-';
|
|
164
|
+
|
|
165
|
+
log.title('🔗 Musa Agent Kit - Syncing with Codex CLI');
|
|
166
|
+
|
|
167
|
+
if (!fs.existsSync(agentDir)) {
|
|
168
|
+
log.error('.agent folder not found. Please run "init" first.');
|
|
169
|
+
process.exit(1);
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
if (!fs.existsSync(codexPromptDir)) {
|
|
173
|
+
log.info('Creating Codex prompt directory...');
|
|
174
|
+
fs.mkdirSync(codexPromptDir, { recursive: true });
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
const workflows = fs.readdirSync(workflowDir).filter(f => f.endsWith('.md'));
|
|
178
|
+
|
|
179
|
+
log.info(`Found ${workflows.length} workflows. Linking to ${codexPromptDir}...`);
|
|
180
|
+
|
|
181
|
+
let successCount = 0;
|
|
182
|
+
for (const wf of workflows) {
|
|
183
|
+
const src = path.join(workflowDir, wf);
|
|
184
|
+
const destName = `${prefix}${wf}`;
|
|
185
|
+
const dest = path.join(codexPromptDir, destName);
|
|
186
|
+
|
|
187
|
+
try {
|
|
188
|
+
if (fs.existsSync(dest)) {
|
|
189
|
+
if (options.force) {
|
|
190
|
+
fs.unlinkSync(dest);
|
|
191
|
+
} else {
|
|
192
|
+
continue;
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
// Use absolute path for symlink
|
|
197
|
+
fs.symlinkSync(src, dest, 'file');
|
|
198
|
+
successCount++;
|
|
199
|
+
} catch (err) {
|
|
200
|
+
// If symlink fails (e.g. on Windows without admin), copy instead
|
|
201
|
+
try {
|
|
202
|
+
fs.copyFileSync(src, dest);
|
|
203
|
+
successCount++;
|
|
204
|
+
} catch (copyErr) {
|
|
205
|
+
log.error(`Failed to sync ${wf}: ${copyErr.message}`);
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
log.success(`Successfully synced ${successCount} slash commands to Codex CLI!`);
|
|
211
|
+
log.info(`You can now use: /${prefix}${workflows[0].replace('.md', '')} in Codex CLI.`);
|
|
212
|
+
}
|
|
213
|
+
|
|
154
214
|
function statusCommand() {
|
|
155
215
|
const agentDir = path.join(process.cwd(), '.agent');
|
|
156
216
|
|
|
@@ -199,7 +259,8 @@ const command = args[0];
|
|
|
199
259
|
const options = {
|
|
200
260
|
force: args.includes('--force'),
|
|
201
261
|
quiet: args.includes('--quiet'),
|
|
202
|
-
path: null
|
|
262
|
+
path: null,
|
|
263
|
+
prefix: null
|
|
203
264
|
};
|
|
204
265
|
|
|
205
266
|
// Parse --path
|
|
@@ -208,11 +269,20 @@ if (pathIndex !== -1 && args[pathIndex + 1]) {
|
|
|
208
269
|
options.path = path.resolve(args[pathIndex + 1]);
|
|
209
270
|
}
|
|
210
271
|
|
|
272
|
+
// Parse --prefix
|
|
273
|
+
const prefixIndex = args.indexOf('--prefix');
|
|
274
|
+
if (prefixIndex !== -1 && args[prefixIndex + 1]) {
|
|
275
|
+
options.prefix = args[prefixIndex + 1];
|
|
276
|
+
}
|
|
277
|
+
|
|
211
278
|
// Execute command
|
|
212
279
|
switch (command) {
|
|
213
280
|
case 'init':
|
|
214
281
|
initCommand(options);
|
|
215
282
|
break;
|
|
283
|
+
case 'setup-codex':
|
|
284
|
+
setupCodexCommand(options);
|
|
285
|
+
break;
|
|
216
286
|
case 'update':
|
|
217
287
|
updateCommand(options);
|
|
218
288
|
break;
|
|
@@ -233,3 +303,4 @@ switch (command) {
|
|
|
233
303
|
showHelp();
|
|
234
304
|
process.exit(1);
|
|
235
305
|
}
|
|
306
|
+
|