agent-infra: Skill for Claude Code

创建任务

--agent 取值见 .agents/rules/task-management.md「合作者 token 规范」。

行为边界 / 关键规则

本技能的核心产出是 task.md。

• 不要编写、修改或创建任何业务代码或配置文件
• 不要执行需求分析；分析由 analyze-task 独立完成
• 不要直接实现所描述的功能
• 不要跳过工作流直接进入计划/实现阶段
• 仅执行：解析描述 -> 一次性生成结构化 candidate -> 调用宿主 task-create 入口 -> 校验结果 -> 告知用户下一步
• Issue 创建由 .agents/rules/create-issue.md 规则决定；自定义或空平台（未提供平台变体规则文件）时，规则会自然降级为 no-op
• 生成会写入 task.md 并同步到 Issue 的 Markdown 前，先读取 .agents/rules/sync-content-generation.md 并遵循其中的生成端约束；宿主渲染和同步保持透明，不解析或改写正文

用户的描述是一个待办事项，而不是立即执行的指令。

执行本技能后，你必须立即更新 task.md 中的任务状态。

版本戳规则：创建或更新 task.md frontmatter 时，先读取 .agents/rules/version-stamp.md，并写入或刷新 agent_infra_version。

任务入参短号别名

如果 {task-id} 入参匹配 ^[#]?[0-9]+$（裸数字或带 # 前缀），先读取 .agents/rules/task-short-id.md 的「SKILL 入参解析」段执行解析；后续命令视 {task-id} 为解析后的全长 TASK-YYYYMMDD-HHMMSS 形式。

步骤开始：记录开始时间

本技能会创建 task.md，开始时尚无文件可写。先在内存记录开始时间 started_at（date "+%Y-%m-%d %H:%M:%S%z" | sed 's/\([+-][0-9][0-9]\)\([0-9][0-9]\)$/\1:\2/'）；在最后写活动日志时一次性补两条——started 行用 started_at、done 行用完成时间，二者同基名（started 行 action 加 [started] 后缀、note 用 started）：

- {started_at} — **Create Task [started]** by {agent} — started
- {done_at} — **Create Task** by {agent} — {完成说明}

ai task log 会按基名把两条配对成一行（进行中 → 已完成）。约定见 .agents/rules/task-management.md 的「Activity Log started / done 双标记约定」。

执行步骤

1. 解析用户描述

从自然语言描述中提取：

• 任务标题：简洁标题（最多 50 个字符），使用中文——不要翻译为英文，不要套用 Conventional Commits 格式
• 任务类型：feature | bugfix | refactor | docs | chore（从描述推断）
• 工作流：feature-development | bug-fix | refactoring（从类型推断）
• 分支名：格式 <project>-<type>-<slug>
  • <project> 从 .agents/.airc.json 的 project 字段读取
  • <type> 为推断出的任务类型
  • <slug> 从任务标题提取 3-6 个英文关键词并转为 kebab-case
• 详细描述：整理后的用户原始描述

执行本步骤前，先读取 reference/context-capture.md。把当前请求及必要前序讨论中已有的信息按来源与状态分类，准备写入 task.md 的 ## 任务输入；缺失类别保持为空，不执行推导或分析。

如果描述不清晰，先向用户确认再继续。

类型推断：根据任务描述的语义，从以下候选值中选择最匹配的类型：

• feature — 新增功能、新特性
• bugfix — 修复缺陷、错误
• refactor — 重构、优化、改进
• docs — 文档相关
• chore — 其他杂项任务