xtask-safe

name	xtask-safe
description	Safe xtask task management with enforced constraints. Use this skill WHENEVER the user asks to update task status, create subtasks, split tasks, derive tasks from parent tasks, or perform any xtask task maintenance operations. Always invoke this skill for any task-related changes to ensure CLI safety, inheritance rules, and deletion prevention.

xtask-safe

通过 xtask CLI 安全管理任务的约束流程。

何时使用

当用户提到以下任何操作时，立即使用此技能：

• 更新任务状态（如标记完成、进行中）
• 创建子任务或派生任务
• 任务拆分
• 修改任务属性
• 任何涉及 xtask 任务维护的操作

四条强制规则

1. 仅用 CLI：任务变更必须走 xtask 命令，严禁直接编辑 YAML
2. 子任务继承：创建子任务必须继承父任务 milestone 和 labels，并追加 parent:<父ID> 和 agent:codex 标签
3. 禁止删除：严禁执行任何 xtask delete 命令
4. 完成需确认：将任务状态改为 done 前，必须先获得用户明确确认

工作流程

更新任务状态

xtask task update <task-id> --status <new-status>
# 可用状态仅为: todo | in_progress | done | blocked

当目标状态为 done 时，先向用户确认，再执行命令。

创建子任务（完整流程）

1. 先查询父任务信息获取 milestone 和 labels：

xtask task show <parent-id>

2. 使用继承的属性创建子任务：

xtask task create "子任务标题" \
  --milestone <父任务的milestone> \
  --labels <父任务的labels>,parent:<parent-id>,agent:codex

任务拆分

1. 标记原任务为父任务：

xtask task update <parent-id> --labels <原labels>,parent-task

2. 为每个子任务创建记录（继承父任务属性）：

xtask task create "子任务1" --milestone <M> --labels <继承>,parent:<parent-id>,agent:codex
xtask task create "子任务2" --milestone <M> --labels <继承>,parent:<parent-id>,agent:codex

示例场景

场景1：标记任务完成

# 先得到用户明确确认，再执行：
xtask task update T-001 --status done

场景2：从父任务创建子任务

# 父任务 T-001: milestone=M1, labels=backend,api
xtask task create "实现用户认证API" \
  --milestone M1 \
  --labels backend,api,parent:T-001,agent:codex

场景3：拆分大任务

# 1. 标记父任务
xtask task update T-001 --labels backend,api,parent-task

# 2. 创建子任务
xtask task create "设计数据库schema" --milestone M1 --labels backend,api,parent:T-001,agent:codex
xtask task create "实现API端点" --milestone M1 --labels backend,api,parent:T-001,agent:codex
xtask task create "编写单元测试" --milestone M1 --labels backend,api,parent:T-001,agent:codex