Dev Task

重要

• 永远使用中文进行对话

读取策略（节省 token）

默认按“按需读取、逐步展开”执行，不要一次性加载所有 references/​*：

• 必读：SKILL.md
• planner：读取 references/​plan-workflow.md
• runner：读取 references/​task-workflow.md
• 示例/模板/策略文件：仅在创建/校验对应文件时读取（不要默认全读）

快速要点

• 信息不足时再问关键问题；否则直接给出可执行方案。
• 执行型需求：创建并维护项目内 tasks/（见下方），确保可审计、可恢复（除非用户明确只分析/建议）。
• 明显破坏性操作/命令（例如删除文件、重置历史）必须先征询用户确认。
• 涉及归档时：先说明将执行归档操作，征询用户确认后再落盘。

触发规则（planner / runner）

• planner（默认）：未指定任务 id 或任务文件路径。
• runner：指定了任务 id 或任务文件路径（进入 task-runner 流程）。
• planner 落盘时机：先与用户多轮讨论，待用户明确“确认创建/落盘/立项”后，才创建 tasks/ 中的任务文件与 todos.json 记录。

tasks/ 最小结构（执行型需求默认启用）

• tasks/​todos.json：任务列表（JSON 作为 SSoT；字段/状态机见 references/​task-workflow.md）
• tasks/​items/​{id}.md：任务文件（规划/约束/验收/进展/结果）
• tasks/​logs/​tasks/​{id}.log：任务执行日志（记录命令与关键摘要）
• 允许归档：tasks/​todos.archive-*.json

触发词

• 用户输入 “创建任务 / 新任务 / 立项 / 任务单”：创建 tasks/​items/​{id}.md 并登记到 tasks/​todos.json，然后请用户确认内容。
• 以下关键词视为“当前任务的增量需求”，不得新建任务：补充 / 调整 / 追加。

短路模式（仅分析/建议）

当用户明确要求“只分析/建议、不执行”时：

• 不创建任务、不写 tasks/，仅给出建议与风险提示（这是“执行型需求都创建 tasks”约定的唯一例外）。

验收底线（简版）

• 行为符合需求（含关键边界）
• 不引入新的 TypeScript / ESLint error
• 任务文件补齐“如何验证”

任务目录与引用指示

references 目录下包含 workflow 与模板/策略文件：仅在需要时读取；引用前确认存在。

• references/​plan-workflow.md：planner 工作流
• references/​task-workflow.md：runner 工作流与状态机规范
• references/​000-task-example.md：任务模板示例（按需参考）
• references/​todos-template.md：tasks/​todos.json 模板
• references/​task-log-template.md：任务日志模板
• references/​archive-policy.md：归档策略