tasking — 需求开发作战流程

一个 skill，四个 mode。从情报分析到任务移交，全链路自动化。

路由

解析第一个参数作为 mode：

• 参数不匹配任何 mode → 列出用法帮助
• 匹配后立即 Read 对应 mode 文件执行完整流程

全局约定

• 需求文档目录: /media/yhr/2T/yunxiao/requirements/<demand-id>/
• state.json: 每个需求的状态文件，Phase 0 创建，各 phase 更新
• phase 值: new → plan → review → dev → test → done
• 不确定点: 列出向用户确认，不要假设
• 只读保护: 不修改 state.json 中自己未负责的字段

责任边界

• tasking 是需求生命周期 owner：负责 Yunxiao 状态、phase、task page identity、方案来源和阶段 gate。
• execute 是统一任务执行 adapter：Tasking Engage 固定调用 execute --plan <task-page>，把已确认任务压成 goal.md、更新既有 Canon plan，并触发或交付 /goal。
• tasking 调用 execute 时必须传入既有 Canon task page。execute 不得新建近似 task、改变 Yunxiao 状态、选择需求分支或宣称 Engage/Turnover 已完成。
• runtime 无法注入 /goal 时，execute 返回明确 handoff；tasking 保持 dev 阶段 owner，不以内联实现伪装已启动。

Workflow Gate Contract

tasking modes must satisfy the shared workflow output contract:

/home/yhr/.agents/repos/agent-skills/references/skill-output-contract.md

Each mode must leave a clear phase gate in state.json, a Canon task/update-card entry, and durable artifact refs for design docs, review pages, goal.md, deliverables, and status changes.

Gotchas

• Yunxiao status and user updates require IDs. Resolve status IDs with get_work_item_workflow; resolve 樊亮亮 to userId before Turnover assignment.
• Engage must go through the model-invoked execute --plan adapter and a real /goal <goal.md> or /loop custom <goal.md> handoff. tasking owns phase/state; execute owns only goal packaging and runtime handoff.
• Turnover changes demand status to 系统测试 and assignee to 樊亮亮; this owner-change rule applies to demand flow only, not repair.
• Do not create .planning/conversations/<demand-id>/ as the durable plan. Canon task page is durable state; goal.md is runtime execution brief.
• Do not enter Turnover unless build/validation evidence and Review Gate/traceback results are recorded or explicitly waived.

Resources

• orient.md — Orient phase: intel analysis + design doc generation
• briefing.md — Briefing phase: KB upload + review meeting scheduling
• engage.md — Engage phase: status change + goal.md + dev launch
• turnover.md — Turnover phase: deliverable posting + status/assignee change
• scripts/orient_gate.py — Orient gate checker (pass/blocked/ready/warn, human gate: user confirms intel)
• scripts/briefing_gate.py — Briefing gate checker (pass/blocked/ready/warn, human gate: review passed)
• scripts/engage_gate.py — Engage gate checker (pass/blocked/warn, all machine checks)
• scripts/turnover_gate.py — Turnover gate checker (pass/blocked, terminal gate)
• Runtime artifacts: orient_gate.json, briefing_gate.json, engage_gate.json, turnover_gate.json

Canon 输出边界

读取共享契约：/home/yhr/.agents/repos/agent-skills/references/canon-output-contract.md。

• state.json、<runtime-dir>/、<artifact-dir>/ 是阶段门控和执行缓存，不是长期 source of truth。
• 每个需求应在 Canon 中有持久任务页：/media/yhr/2T/Canon/tasks/<demand-id>.md，记录当前阶段、关键决策、负责人流转、交付物和下一步。
• 方案文档、知识库 URL、评审日程、goal.md、交付物 URL 都作为 Canon artifact refs 记录，默认只引用绝对路径或 URL，不复制文件。
• 每个 mode 完成后，如果产生了新事实，创建或更新 /media/yhr/2T/Canon/raw/update-cards/<date>-tasking-<demand-id>-<mode>.md，再把稳定事实合并到 task/project/workflow 页面。
• 如果 Canon 暂不可用，先完成 Yunxiao/state.json 的阶段动作，并在最终回复中明确 Canon promotion 未完成。

项目材料路径优先

先读取目标项目文档规则。CARLA 同时具有 .agent-artifacts-repo-owned 与 Docs/guides/documentation.md 时，artifact-dir 为 Docs/tasks/<demand-id>/，runtime-dir 为 .local/tasks/同一任务slug/；其他项目 artifact-dir 保留 .proposal/<demand-id>/，runtime-dir 保留 .planning/<id>/。下列阶段文件中的 artifact-dir/runtime-dir 均使用此解析结果，不能直接照抄旧路径示例。阶段 gate 使用相同解析器。创建 gate JSON 或衍生附件后按项目归属规则登记 sidecar，再检查、提交；执行缓存留本地。