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:

File	Purpose
`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

转换现有任务

Locate task file: Find TASKS.md, TODO.md, or similar in project root
Parse tasks: Extract structured data from markdown
Create spec directories: Run
```
scripts/convert_tasks.py
```
Verify output: Check
```
.auto-claude/specs/
```
structure

bash

python3 scripts/convert_tasks.py --input TASKS.md --output .auto-claude/specs

定位任务文件：在项目根目录中查找TASKS.md、TODO.md或类似文件
解析任务：从Markdown中提取结构化数据
创建规范目录：运行
```
scripts/convert_tasks.py
```
验证输出：检查
```
.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 Status	AutoClaude Status
`To Do`	`pending`
`In Progress`	`in_progress`
`Done`	`completed`
`Blocked`	`blocked`

输入状态	AutoClaude 状态
待办	pending
进行中	in_progress
已完成	completed
阻塞	blocked

Priority Mapping

优先级映射

Input Priority	AutoClaude 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.