Kiro Spec tasks.md 生成后 [Start Task] 按钮不出现的修复方法

问题

Kiro IDE 生成 tasks.md 后，编辑器中任务行上方没有出现 [Start Task] 装饰按钮，无法通过 UI 启动任务执行。

根本原因

格式不一致：tasks.md 中章节标题和子任务条目的格式必须完全匹配（包括冒号），[Start Task] 装饰器才能正确识别。

错误格式（缺少冒号）：

### 1.1: TypeScript Interface Definition
- 1.1 TypeScript Interface Definition

正确格式（子任务条目也要有冒号）：

### 1.1: TypeScript Interface Definition
- 1.1: TypeScript Interface Definition

注意 - 1.1 TypeScript... 和 - 1.1: TypeScript... 的差别——缺少冒号时，装饰器无法将子任务与章节标题匹配，[Start Task] 按钮不会出现。

解决方案

方案一：手动修复格式

找到 tasks.md 中所有子任务条目，确保与对应章节标题格式一致（都带冒号）：

# Tasks

## Relevant Files

## Tasks

- [ ] 1.0: 主任务标题

  ### 1.1: 子任务标题
  - 1.1: 子任务标题          ← 确保这里也有冒号
  - 1.2: 另一个子任务         ← 确保这里也有冒号

方案二：让 Kiro 重新生成

在 Chat 中告诉 Kiro 重新生成 tasks.md，同时明确说明格式要求：

重新生成 tasks.md，确保每个子任务条目（如 "- 1.1:"）都包含冒号，与章节标题（"### 1.1:"）格式完全一致。

方案三：检查缩进

除了冒号，子任务的缩进层级也影响识别。标准格式：

- [ ] 1.0: 顶层任务
  ### 1.1: 子任务组
  - 1.1: 子任务一
  - 1.2: 子任务二

常见问题

Q: 手动修改 tasks.md 后 Kiro 会覆盖我的修改吗？

A: 有时会。建议在 Spec 初始阶段就检查格式，或者在 steering 文件中告诉 Kiro tasks.md 的格式规范。

Q: 这是 Kiro 的 Bug 吗？

A: 是的，生成器应该保持子任务和章节标题格式一致。官方已知但截至目前（2026-04）尚未彻底修复。

来源：GitHub Issue #5011