task-create
创建结构化任务文件以规划开发工作。当用户请求“创建任务”、“添加任务”、“规划任务”或需要记录工作项时使用。在docs/planning/tasks/目录下创建编号的Markdown文件。
📖 中文导读:创建结构化任务文件以规划开发工作。当用户请求“创建任务”、“添加任务”、“规划任务”或需要记录工作项时使用。在docs/planning/tasks/目录下创建编号的Markdown文件。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: task-create description: Create structured task files for planning dev work. Use when user asks to "create a task", "add a task", "plan a task", or needs to document work items. Creates numbered markdown files in docs/planning/tasks/.
Task Create
Create numbered task files following project conventions.
Workflow
IMPORTANT: Use the aaa binary directly, NOT bun --cwd tools run dev.
- Create file:
aaa task create <kebab-name>→ returns filepath - Write content using template below
- Link to story if applicable (add
**Story:**header)
Template
## Task: [Short descriptive name]
**Story:** [story-name](../stories/NNN-story-name.md) *(optional)*
### Goal
[One sentence: what should be true when this is done?]
### Context
[Why this matters. Current state, trigger, constraints, dependencies]
### Plan
1. [First concrete action]
2. [Second action]
3. [Continue as needed]
### Acceptance Criteria
- [ ] [Specific, testable outcome]
- [ ] [Another outcome]
### Test Plan
- [ ] [What tests to add/run]
- [ ] [Manual verification if needed]
### Scope
- **In:** [What this includes]
- **Out:** [What this explicitly excludes]
### Notes
[Optional: Technical considerations, risks, edge cases]
Required Sections
| Section | Purpose |
|---|---|
| Goal | One sentence outcome - "what's true when done?" |
| Context | The why: problem, trigger, constraints |
| Plan | Numbered concrete actions |
| Acceptance Criteria | Checkboxes for verification |
| Test Plan | What tests to add/update/run |
| Scope | Explicit In/Out boundaries |
File Location
- Default:
docs/planning/tasks/NNN-name.md - Custom:
aaa task create <name> --dir <path>