plan-to-tasks

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Plan to JSONL Converter

项目计划转JSONL转换器

Transform project plans into JSONL format: Story (Epic) → Task → SubTask with embedded dependencies.

将项目计划转换为JSONL格式：Story（Epic）→ Task → SubTask，并嵌入依赖关系。

When to Apply

适用场景

Use this skill when:

User provides a project plan/spec to break down
Converting markdown plans to JSONL format
Exporting task hierarchies as structured data
Creating work queues for external systems
User asks to "convert to jsonl", "create jsonl from plan", "export plan as json"

在以下场景中使用本技能：

用户提供项目计划/规格说明，需要进行拆解
将Markdown格式的计划转换为JSONL格式
将任务层级导出为结构化数据
为外部系统创建工作队列
用户提出“convert to jsonl”“create jsonl from plan”“export plan as json”这类需求

Core Conversion Process

核心转换流程

Step 1: Analyze the Plan

步骤1：分析计划

Identify three levels:

Stories (Epics): Major features/components → Type:
```
epic
```
Tasks: Implementation work → Type:
```
task
```
SubTasks: Granular actions → Type:
```
task
```

CRITICAL: Extract ALL details from plan - see Information Extraction.

识别三个层级：

Stories（Epics）：主要功能/组件 → 类型：
```
epic
```
Tasks：实施工作 → 类型：
```
task
```
SubTasks：细粒度操作 → 类型：
```
task
```

关键要求：从计划中提取所有细节 - 参考信息提取。

Step 2: Create Self-Contained Tasks

步骤2：创建独立可执行任务

Each task must include complete context for agent to work independently. Agent selects by priority only - no hierarchy traversal.

See Self-Contained Tasks for template and examples.

每个任务必须包含完整上下文，以便Agent可以独立工作。Agent仅按优先级选择任务 - 无需遍历层级结构。

参考独立可执行任务获取模板及示例。

Step 3: Add Dependencies

步骤3：添加依赖关系

Use appropriate dependency types:

blocks

depends_on

related

discovered-from

See Dependency Types for patterns.

使用合适的依赖类型：

blocks

、

depends_on

、

related

、

discovered-from

。

参考依赖类型获取模式说明。

Rules Summary

规则汇总

Detailed rules in

rules/

directory:

TDD-First Approach - Mandatory Red→Green→Refactor for features/bugs
Type Schema - TypeScript type definition and task characteristics
Self-Contained Tasks - 1500+ char descriptions with complete context
Information Extraction - Extract requirements, user stories, specs
Dependency Types - blocks, related, discovered-from, parent-child
Priority Scale - P0-P4 rationale (hard tasks first)
Labels Organization - Feature grouping, TDD phases, stack tags
JSONL Queries - 50+ jq command examples
Best Practices - Output format, expected structure, final checklist

详细规则位于

rules/

目录中：

TDD优先方法 - 功能/缺陷修复必须遵循Red→Green→Refactor流程
类型 schema - TypeScript类型定义及任务特征
独立可执行任务 - 1500字以上的描述，包含完整上下文
信息提取 - 提取需求、用户故事、规格说明
依赖类型 - blocks、related、discovered-from、父子关系
优先级等级 - P0-P4优先级判定依据（先处理难任务）
标签组织 - 功能分组、TDD阶段、技术栈标签
JSONL查询 - 50+个jq命令示例
最佳实践 - 输出格式、预期结构、最终检查清单

Example

示例

Given:

markdown

Feature: User Authentication
- Login with email/password
- JWT tokens (15min access, 7day refresh)
- Rate limiting (5 attempts per 15min)

Convert to JSONL with:

Complete technical approach (bcrypt, JWT, Redis)
Implementation details (files, functions, config)
Error handling (400/401/403/429/500)
Testing requirements (coverage, test cases)
Dependencies (bcrypt, jsonwebtoken, ioredis)

See Self-Contained Tasks for full example.

给定：

markdown

Feature: User Authentication
- Login with email/password
- JWT tokens (15min access, 7day refresh)
- Rate limiting (5 attempts per 15min)

转换为JSONL格式时需包含：

完整技术方案（bcrypt、JWT、Redis）
实施细节（文件、函数、配置）
错误处理（400/401/403/429/500）
测试要求（覆盖率、测试用例）
依赖项（bcrypt、jsonwebtoken、ioredis）

完整示例请参考独立可执行任务。

Related Skills

Output Structure

输出结构

└── plan/issues.jsonl  # One issue per line, dependencies embedded

Each line: complete JSON object following Type Schema.

STOP ONCE JSONL IS CREATED! DO NOT IMPLEMENT OR TEST ANYTHING YET!

└── plan/issues.jsonl  # 每行一个任务，嵌入依赖关系

每行内容：符合类型 schema的完整JSON对象。

创建完JSONL后立即停止！ 请勿进行任何实施或测试操作！