Back to Details

autoclaude-task-converter

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

AutoClaude Task Converter

AutoClaude 任务转换器

Convert markdown task backlogs to AutoClaude's multi-file spec structure.
将Markdown任务待办列表转换为AutoClaude的多文件规范结构。

Input Format

输入格式

The skill accepts task files in this markdown format:
markdown
undefined
本Skill接受以下Markdown格式的任务文件：
markdown
undefined

TASK-XXX: Task Title

TASK-XXX: 任务标题

  • Description: What needs to be done
  • Area: Component/Feature area
  • Status: To Do | In Progress | Done | Blocked
  • Priority: Critical | High | Medium | Low
  • Dependencies: TASK-XXX, TASK-YYY (optional)
  • Subtasks: (optional)
    • Subtask 1
    • Subtask 2 (completed)
  • Notes: Additional context

Also supports single-line tasks: `- [ ] Simple task description`
  • 描述: 需要完成的工作内容
  • 领域: 组件/功能领域
  • 状态: 待办 | 进行中 | 已完成 | 阻塞
  • 优先级: 紧急 | 高 | 中 | 低
  • 依赖项: TASK-XXX, TASK-YYY（可选）
  • 子任务:（可选）
    • 子任务1
    • 子任务2（已完成）
  • 备注: 额外上下文信息

同时支持单行任务：`- [ ] 简单任务描述`

Output Structure

输出结构

For each task, create 
.auto-claude/specs/XXX-task-name/
containing:
FilePurpose
spec.md
Feature specification
requirements.json
Structured requirements
context.json
Codebase context (initially empty)
implementation_plan.json
Subtasks with status
针对每个任务，创建
.auto-claude/specs/XXX-task-name/
目录，包含以下文件：
文件用途
spec.md
功能规范
requirements.json
结构化需求
context.json
代码库上下文（初始为空）
implementation_plan.json
包含状态的子任务

Workflow

工作流程

Converting Existing Tasks

转换现有任务

  1. Locate task file: Find TASKS.md, TODO.md, or similar in project root
  2. Parse tasks: Extract structured data from markdown
  3. Create spec directories: Run 
    scripts/convert_tasks.py
  4. Verify output: Check 
    .auto-claude/specs/
    structure
bash
python3 scripts/convert_tasks.py --input TASKS.md --output .auto-claude/specs
  1. 定位任务文件：在项目根目录中查找TASKS.md、TODO.md或类似文件
  2. 解析任务：从Markdown中提取结构化数据
  3. 创建规范目录：运行
    scripts/convert_tasks.py
  4. 验证输出：检查
    .auto-claude/specs/
    目录结构
bash
python3 scripts/convert_tasks.py --input TASKS.md --output .auto-claude/specs

New Project Setup

新项目初始化

When no task file exists, create the AutoClaude structure:
bash
python3 scripts/convert_tasks.py --init --output .auto-claude/specs
This creates:
  • .auto-claude/specs/
    directory
  • .auto-claude/TASKS.md
    template file
  • Sample spec 
    001-project-setup/
当不存在任务文件时，创建AutoClaude结构：
bash
python3 scripts/convert_tasks.py --init --output .auto-claude/specs
此命令将创建：
  • .auto-claude/specs/
    目录
  • .auto-claude/TASKS.md
    模板文件
  • 示例规范
    001-project-setup/

Conversion Rules

转换规则

Status Mapping

状态映射

Input StatusAutoClaude Status
To Do
pending
In Progress
in_progress
Done
completed
Blocked
blocked
输入状态AutoClaude 状态
待办pending
进行中in_progress
已完成completed
阻塞blocked

Priority Mapping

优先级映射

Input PriorityAutoClaude Priority
Critical
p0
High
p1
Medium
p2
Low
p3
输入优先级AutoClaude 优先级
紧急p0
高p1
中p2
低p3

Complexity Assessment

复杂度评估

Determined by subtask count and description length:
  • simple: 0-2 subtasks, single area
  • standard: 3-6 subtasks, may span areas
  • complex: 7+ subtasks, multiple dependencies
根据子任务数量和描述长度判定：
  • 简单：0-2个子任务，单一领域
  • 标准：3-6个子任务，可能跨多个领域
  • 复杂：7个及以上子任务，存在多个依赖项

File Schemas

文件Schema

See 
references/autoclaude_schemas.md
for detailed JSON schemas for:
  • requirements.json
  • context.json
  • implementation_plan.json
详见
references/autoclaude_schemas.md
中的详细JSON schema，涵盖：
  • requirements.json
  • context.json
  • implementation_plan.json

Post-Conversion Note

转换后注意事项

IMPORTANT: After writing task specs, always inform the user:
NOTE: CURRENTLY AUTOCLAUDE MAY REQUIRE A RESTART BEFORE FULLY UTILIZING TASKS THAT HAVE BEEN WRITTEN OUT.
重要提示：编写完任务规范后，请务必告知用户：
NOTE: CURRENTLY AUTOCLAUDE MAY REQUIRE A RESTART BEFORE FULLY UTILIZING TASKS THAT HAVE BEEN WRITTEN OUT.