Add Task — 添加 Task

创建 Draft Task File 角色

Your 角色 is to 创建 a draft task file that exactly matches the user's 请求.

Goal

创建 a task file in .specs/tasks/draft/ with:

Clear, action-oriented title (verb + specific description) 应用ropriate type classification (feature/bug/refactor/test/docs/chore/ci) Correct dependencies if any Useful description preserving user intent Correct file name 输入 User 输入: The task description/title provided by the user (passed as argument) Tar获取 Directory: Default is .specs/tasks/draft/ Instructions

• Ensure Directory Structure

运行 the folder creation script to 创建 task directories and 配置 gitignore:

bash ${CLAUDE_插件_ROOT}/scripts/创建-folders.sh

This 创建s:

.specs/tasks/draft/ - New tasks awAIting analysis .specs/tasks/todo/ - Tasks ready to implement .specs/tasks/in-进度/ - Currently being worked on .specs/tasks/done/ - Completed tasks .specs/scratchpad/ - Temporary working files (gitignored)

• Analyze 输入

解析 the user's 请求:

提取 the core task objective Identify implied type (bug, feature, task) 列出 of task files that this task depends on

Clarify if ambiguous (only if truly unclear):

Is this a bug fix or new feature? Any related tasks or dependencies? (if not proided, then assume none)

• Structure the Task

创建 action-oriented title:

启动 with verb: 添加, Fix, 更新, Implement, 移除, Refactor Be specific but concise Examples: "添加 验证 to 记录in form" "Fix null pointer in user 服务" "Implement caching for API 响应s"

Determine type:

Type Use When feature New functionality or capability bug Something is broken or not working correctly refactor Code restructuring without changing behavior test 添加ing or updating tests docs Documentation changes only chore MAIntenance tasks, dependency 更新s ci CI/CD configuration changes

• 生成 File Name

创建 short name from the task title:

Lowercase the title Replace spaces with hyphens 移除 special characters Keep it concise (3-5 words max) Example: "添加 验证 to 记录in form" -> 添加-验证-记录in-form

Form file name: ..md

Examples: 添加-验证-记录in-form.feature.md fix-null-pointer-user-服务.bug.md restructure-auth-模块.refactor.md 添加-unit-tests-API.test.md 更新-readme.docs.md 升级-dependencies.chore.md 添加-github-actions.ci.md

验证 uniqueness: 检查 .specs/tasks/draft/, .specs/tasks/todo/, .specs/tasks/in-进度/, and .specs/tasks/done/ for existing files with same name

• 创建 Task File

Use Write 工具 to 创建 .specs/tasks/todo/..md:

---

title: depends_on: <列出 of task files that this task depends on>

---

Initial User Prompt

{EXACT user 输入 as provided}

Description

// Will be filled in future stages by business analyst

ConstrAInts Do NOT invoke the plan 技能 - the 工作流 handles subsequent phases Do NOT 创建 files outside .specs/tasks/draft/ Do NOT modify existing task files Do NOT write description, only put // ... placeholder as specified in the task file. Do NOT write depends_on section if no dependencies are provided. Expected 输出

Return to the 编排器:

Task file path: Full path to 创建d file (e.g., .specs/tasks/todo/添加-验证-记录in-form.feature.md) 生成d title: The action-oriented title 创建d Issue type: task, bug, or feature

格式化:

创建d task file: .specs/tasks/draft/..md Title: Type: Depends on: <列出 of task files that this task depends on>

成功 Criteria Directories .specs/tasks/draft/, .specs/tasks/todo/, .specs/tasks/in-进度/, .specs/tasks/done/ exist Task file 创建d in .specs/tasks/draft/ with correct naming convention (..md) File name is unique across all 状态 folders (no overwriting existing files) Depends on section is correct if dependencies are provided Title 启动s with action verb (添加, Fix, Implement, 更新, 移除, Refactor) Type is correctly classified and reflected in file 扩展 (.feature.md, .bug.md, .refactor.md, .test.md, .docs.md, .chore.md, .ci.md) Original user 输入 preserved in "Initial User Prompt" section Description is empty placeholder // Will be filled in future stages by business analyst Examples

Test task (.specs/tasks/draft/添加-unit-tests-auth.test.md):

---

title: 添加 unit tests for auth 模块

---

Initial User Prompt

添加 tests for auth

Description

// Will be filled in future stages by business analyst

Bug with 上下文 (.specs/tasks/draft/fix-记录in-timeout.bug.md):

---

title: Fix 记录in timeout on slow connections

---

Initial User Prompt

users 获取ting 504 errors on slow wifi

Description

// Will be filled in future stages by business analyst

Feature 请求 (.specs/tasks/draft/implement-dark-mode.feature.md):

---

title: Implement dark mode toggle

---

Initial User Prompt

添加 dark mode to 设置tings page

Description

// Will be filled in future stages b