القائمة
为任务设计技术方案和实施计划。 当需求已明确、需要在编码前形成技术方案时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
标记任务为阻塞状态并记录原因。 当任务因外部阻塞无法推进、需要挂起并记录原因时使用。
取消不再需要的任务并转移。 当某个任务不再需要、应从 active 工作中撤下时使用。
关闭 Code Scanning 告警并记录理由。 当某条 Code Scanning 告警已处理或需按理由关闭时使用。
关闭 Dependabot 安全告警并记录理由。 当某条 Dependabot 安全告警已处理或需按理由关闭时使用。
标记任务完成并归档。 当任务工作已完成并验证、需要收尾归档时使用。
从平台 Issue 评论还原本地任务文件。 当本地任务文件缺失、需要从平台 Issue 评论还原时使用。
| name | plan-task |
| description | 为任务设计技术方案和实施计划。 当需求已明确、需要在编码前形成技术方案时使用。 |
plan.md 或 plan-r{N}.md）—— 不修改任何业务代码版本戳规则：创建或更新 task.md frontmatter 时，先读取 .agents/rules/version-stamp.md，并写入或刷新 agent_infra_version。
在加载 workflow / skill / rules 指令之后、做任何任务状态判断或用户可见结论之前，必须先执行状态核对。指令类文件读取不算对外动作或结论。
运行以下命令，并把原文粘贴到回复正文和本轮产物的 ## 状态核对 段：
git status -s
ls -la .agents/workspace/active/{task-id}/
tail .agents/workspace/active/{task-id}/task.md
状态核对完成前，禁止任何关于外部状态的断言（例如“代码没变”“测试已通过”“没有其他引用”），包括思考阶段。本门禁只提供结构下限；逐条证据配对和真实性仍需按报告模板与审查要求核对。
如果
{task-id}入参匹配^[#]?[0-9]+$（裸数字或带#前缀），先读取.agents/rules/task-short-id.md的「SKILL 入参解析」段执行解析；后续命令视{task-id}为解析后的全长TASK-YYYYMMDD-HHMMSS形式。
确认前置条件和轮次后、本轮第一个产出动作之前执行：
agent-infra-internal task-event {task-id} plan.started --agent {agent}
检查必要文件：
.agents/workspace/active/{task-id}/task.md - 任务文件analysis.md 或 analysis-r{N}.md注意：{task-id} 格式为 TASK-{yyyyMMdd-HHmmss}，例如 TASK-20260306-143022
如果任一文件缺失，提示用户先完成前置步骤。
运行 agent-infra-internal task-artifact {task-id} inspect --family plan。仅当结果为 ready 时继续；从 inputs 取得最新 {analysis-artifact}，从 next.round / next.name 取得 {plan-round} / {plan-artifact}。不得自行扫描轮次或拼装文件名。随后执行 started 事件并复核返回身份。
读取步骤 2 核心返回的最新 {analysis-artifact}，
以理解：
Round ≥ 2：响应上一轮审查（仅当存在审查产物时）：若任务目录存在 review-plan.md / review-plan-r{N}.md，读取最高轮次的审查报告；在本轮方案产物中新增 ## 对上一轮审查的响应 段，对每条发现先 Read/Grep 核实，再按 .agents/rules/review-handshake.md 的四态（accepted / adjusted / refuted / cannot-judge）处置——每态都要附相称证据，不默认顺从；并把处置回写 task.md ## 审查分歧账本 对应行（stage=plan，round +1）。未决分歧写入 ## 未决问题。Round 1 无审查，跳过本段。
遵循 .agents/workflows/feature-development.yaml 中的 technical-design 步骤：
必要任务：
遇到本轮新增的关键设计决策时，按 .agents/rules/no-mid-flow-questions.md 判据和 .agents/rules/human-decision-context.md 的自足详情结构，写入方案产物的 ## 人工裁决待办 段 ### HD-N：<标题> [needs-human-decision]（HD-N 全局唯一，规则见 .agents/rules/review-handshake.md），并回写 HD- 账本行（evidence 指向 {plan-artifact}#HD-N）；普通未决问题仍写 ## 未决问题。
设计原则：
创建 .agents/workspace/active/{task-id}/{plan-artifact}。
更新 .agents/workspace/active/{task-id}/task.md：
effort。若重估值与 task.md 当前值不一致：
effort 字段{plan-artifact} 中追加 ## 工作量重估 段，记录一条：effort {old} → {new} (rationale: {基于本轮方案的简短依据})
若重估值与当前值一致，跳过：不写入 ## 工作量重估 段。后续 Flow A 同步会读取可能更新过的 frontmatter，并自动把新值同步到 Issue。agent-infra-internal task-event {task-id} plan.completed --agent {agent} --artifact {plan-artifact}，由核心原子登记链接、阶段、代理、时间、版本和 Activity Log。如果 task.md 中存在有效的 issue_number，执行以下同步操作（任一失败则跳过并继续）：
.agents/rules/issue-sync.md，完成 upstream 仓库检测和权限检测status: pending-design-work.agents/rules/issue-sync.md 中定义的 task 评论标记（按 issue-sync.md 的 task.md 评论同步规则）{plan-artifact} 评论.agents/rules/issue-fields.md，按流程 A 把 task.md 中所有非空的 Issue 字段（priority/effort/start_date/target_date）同步到 Issue（幂等；has_push=false 或取数/写入失败时跳过，不阻断）运行完成校验，确认任务产物和同步状态符合规范：
node .agents/scripts/validate-artifact.js gate plan-task .agents/workspace/active/{task-id} {plan-artifact} --format text
处理结果：
将校验输出保留在回复中作为当次验证输出。没有当次校验输出，不得声明完成。
仅在校验通过后执行本步骤。
重要：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。如果
.agents/.airc.json中配置了自定义 TUI（customTUIs），读取每个工具的name和invoke，按同样格式补充对应命令行（${skillName}替换为技能名，${projectName}替换为项目名）。 渲染最终输出前，先读取.agents/rules/next-step-output.md并落实其两类规则：(1) 「下一步」命令把{task-ref}渲染为短号#NN（未分配/已释放时回退完整 TASK-id）；(2) 在面向用户输出的绝对最后一行追加Completed at收尾行（成功、错误、早退等任何面向用户输出都适用，不限于校验通过的成功态）。
输出格式：
任务 {task-id} 技术方案完成。
方案概要：
- 轮次：Round {plan-round}
- 方法：{简要描述}
- 需修改文件：{数量}
- 需新建文件：{数量}
- 预估复杂度：{评估}
产出文件：
- 技术方案：.agents/workspace/active/{task-id}/{plan-artifact}
重要：人工审查检查点。
请在继续实现之前审查技术方案。
下一步 - 审查技术方案：
- Claude Code / OpenCode：/review-plan {task-ref}
- Gemini CLI：/agent-infra:review-plan {task-ref}
- Codex CLI：$review-plan {task-ref}
.agents/workspace/active/{task-id}/{plan-artifact}current_step 为 technical-designupdated_at 为当前时间{plan-artifact} 为已完成产物完成检查清单后，立即停止。 这是一个强制性的人工审查检查点 —— 用户必须审查并批准计划后才能继续实现。
analysis.md 或 analysis-r{N}.md 存在）plan.md；后续修订使用 plan-r{N}.md