任务收尾规范

适用于主要交付完成后的收尾阶段，确保日志、优化分析完整落地。

⚠️ 核心强制要求

触发条件

• 主要功能或文档交付已完成

• 用户明确指示"进入收尾/后置流程"

• Agent 交付总结后询问并获得同意

必须执行的流程

• W00 同步检查：确认已通过 w00-workflow-checkpoint 完成最终 issue 同步（含最终 checkpoint 摘要与下一步信息）。

• 结构检查（再收尾）：本任务涉及的所有代码文件 ≤300 行（file-size-limit ）、职责清晰且无循环依赖（single-responsibility ）。若超限或职责不清：先拆分/重构再继续收尾；若用户选择暂不处理，在日志中记录「遗留：结构问题」及建议。

• 生成任务日志：使用 scripts/generate_task_log.py

• 六维度优化分析：代码质量/架构设计/性能/测试/可维护性/技术债务

若未绑定 Issue，需在收尾说明中明确记录原因与补建计划，并补充项目级任务视图的替代追踪方式。

AI Agent 行为要求

主动询问

完成主要交付后，主动询问：

主要交付已完成。是否进入收尾流程？

完成汇报

收尾完成后汇报日志位置和分析要点。

与 W00 协同（自动 + 手动）

• 收尾前检查是否存在绑定的 Issue # 。

• 若存在：由 w05-task-closure 直接执行任务关闭；必要时仅调用 w00-workflow-checkpoint 补最后一次 checkpoint 存档。

禁止事项

• ❌ 跳过收尾流程或伪造执行结果

• ❌ 漏写日志核心字段、六维分析

• ❌ 未说明未执行项的原因与计划

工具脚本

脚本：scripts/generate_task_log.py

功能：生成符合规范的任务日志，包含六维度优化分析

参考资料

• references/closure-workflow.md

• 收尾工作流详细说明（触发条件、结构检查、日志规范、六维度分析）

• ../w00-workflow-checkpoint/SKILL.md

• Workflow GitHub Issues 基础存档能力（自动 + 手动）

• refactor-and-decompose/SKILL.md

• 收尾前结构检查约束