Skip to content

Commit 097be1d

Browse files
committed
feat: integrate spark-task-init-skill into spark-skills
- Move spark-task-init-skill to spark-skills/ directory - Update spark-skills/README.md with new skill documentation - Update AGENTS.md with Spark Skills section - Prepare spark-skills as personal skill collection repository Refs: #6
1 parent fee43da commit 097be1d

4 files changed

Lines changed: 147 additions & 1 deletion

File tree

.gitignore

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,5 @@ monolize
33
go.sum
44
spark
55
__pycache__/
6-
**/__pycache__/
6+
**/__pycache__/
7+
.github-task-workflow.active-issue

AGENTS.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -354,6 +354,43 @@ tasks/
354354
355355
详细文档: [docs/usage/task.md](docs/usage/task.md)
356356
357+
## Spark Skills
358+
359+
个人 Skill 集合仓库,包含多个 AI Agent Skill,用于增强 spark-cli 的功能。
360+
361+
**仓库地址**: `variableway/spark-cli` 中的 `spark-skills/` 目录
362+
363+
### 已包含 Skills
364+
365+
| Skill | 描述 | 路径 |
366+
|-------|------|------|
367+
| `github-task-workflow` | GitHub 任务工作流管理 | `spark-skills/github-task-workflow/` |
368+
| `spark-task-init` | spark task 初始化 | `spark-skills/spark-task-init-skill/` |
369+
370+
### 使用方式
371+
372+
```bash
373+
# 安装 skills 到各 Agent
374+
cd spark-skills
375+
./install.sh kimi
376+
./install.sh claude-code
377+
378+
# 项目级一键配置
379+
bash spark-skills/setup-project.sh
380+
```
381+
382+
### Skill 目录结构
383+
384+
```
385+
spark-skills/
386+
├── github-task-workflow/ # GitHub 任务工作流 Skill
387+
├── spark-task-init-skill/ # Task 初始化 Skill
388+
├── install.sh # 安装脚本
389+
└── README.md # 说明文档
390+
```
391+
392+
详细文档: [spark-skills/README.md](spark-skills/README.md)
393+
357394
## 构建与测试
358395

359396
### 构建命令

spark-skills/README.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,26 @@ kimi --agent-file github-task-workflow/agent/kimi-agent.yaml
7979

8080
详见:[github-task-workflow/SKILL.md](github-task-workflow/SKILL.md)
8181

82+
### `spark-task-init`
83+
84+
为 spark-cli 初始化任务目录结构的 Skill。
85+
86+
**功能**
87+
- 创建任务目录结构(tasks/features/, tasks/config/ 等)
88+
- 创建示例特性模板文件
89+
- 可在任意目录执行
90+
91+
**使用方式**
92+
```bash
93+
# 方式一:使用 spark 命令
94+
spark task init
95+
96+
# 方式二:使用 skill 直接执行
97+
kimi --agent-file spark-task-init-skill/SKILL.md
98+
```
99+
100+
详见:[spark-task-init-skill/SKILL.md](spark-task-init-skill/SKILL.md)
101+
82102
## 仓库结构
83103

84104
```
@@ -94,6 +114,8 @@ spark-skills/
94114
│ │ └── update_issue.py
95115
│ └── references/ # 详细参考文档
96116
│ └── workflow.md
117+
├── spark-task-init-skill/ # Skill: spark task 初始化
118+
│ └── SKILL.md # Skill 入口
97119
└── ... # 未来添加更多 skills
98120
```
99121

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
---
2+
name: spark-task-init
3+
description: Initialize spark task structure in any directory by running "spark task init"
4+
type: skill
5+
supported_agents:
6+
- claude-code
7+
- kimi
8+
- codex
9+
- opencode
10+
---
11+
12+
# Spark Task Init Skill
13+
14+
This skill enables initializing spark task structure in any directory.
15+
16+
## Usage
17+
18+
When the user wants to initialize task structure in a directory, run:
19+
20+
```bash
21+
spark task init
22+
```
23+
24+
This will create:
25+
- `tasks/features/` - Directory for feature files
26+
- `tasks/config/` - Directory for configuration tasks
27+
- `tasks/analysis/` - Directory for analysis tasks
28+
- `tasks/mindstorm/` - Directory for brainstorming tasks
29+
- `tasks/planning/` - Directory for planning tasks
30+
- `tasks/prd/` - Directory for PRD documents
31+
- `tasks/example-feature.md` - Example feature template
32+
33+
## Available Commands
34+
35+
After initialization, you can use:
36+
37+
```bash
38+
# List all tasks and features
39+
spark task list
40+
41+
# Create a new feature
42+
spark task create my-feature
43+
44+
# Create with custom content
45+
spark task create my-feature --content "Custom description"
46+
47+
# Delete a feature
48+
spark task delete my-feature
49+
50+
# Delete without confirmation
51+
spark task delete my-feature --force
52+
53+
# Implement a feature (requires kimi CLI)
54+
spark task impl my-feature
55+
56+
# Show help
57+
spark task --help
58+
```
59+
60+
## Example Workflow
61+
62+
```bash
63+
# 1. Initialize task structure
64+
spark task init
65+
66+
# 2. Create a new feature
67+
spark task create login-feature
68+
69+
# 3. List all features
70+
spark task list
71+
72+
# 4. Implement the feature (if kimi CLI is installed)
73+
spark task impl login-feature
74+
```
75+
76+
## Requirements
77+
78+
- spark CLI must be installed
79+
- For `spark task impl`: kimi CLI must be installed
80+
- For GitHub workflow: github-task-workflow must be configured
81+
82+
## Notes
83+
84+
- If directories already exist, they will be preserved
85+
- The example-feature.md serves as a template for new features
86+
- Feature files are stored in `tasks/features/` directory

0 commit comments

Comments
 (0)