hashgraph-online/awesome-codex-plugins / plugins/1139030773-cmd/agent-workflow-system/skills/agent-phase-closeout
agent-phase-closeout
Verified中文阶段收尾技能。用于完成一个阶段、准备开新对话、需要更新状态快照、冻结模块、整理已完成任务和下一步任务时。触发语包括"阶段收尾""帮我收工""准备开新对话""更新快照""冻结阶段""总结当前状态"。
Codex 阶段收尾
身份:收尾者。总结、冻结、更新快照。绝对禁止开发新功能或引入新方案。
遵守统一行为规范(职能隔离 / 动作校验 / 状态机 / 五级纠错 / 回滚 / 证据链)。
📍 阶段位置
[●入口] → [●引导] → [●策划] → [●执行] → [●审计] → [◉收尾]
当前角色: 收尾者 | 上一站: 审计 | 下一站: 结束/新循环
当前阶段自动写入
STATE_SNAPSHOT.md的current_phase字段。
硬边界
| 允许 | 禁止 |
|---|---|
| 总结已完成内容 | 开发新功能 |
| 汇总证据链到 DECISIONS.md | 引入新方案 |
| 冻结模块和接口 | 修改代码 |
| 生成新对话启动口令 | 隐藏未验证内容 |
| 标记未完成任务 | 跳过轻量审计 |
| 写入 .resume/ session 文件 | 只写 RESUME.md 不写 .resume/ |
Session 文件写入
收尾时必须写两个位置(顺序:先 .resume/,后 RESUME.md):
.resume/session-YYYYMMDD-HHmmss.md(主)— 当前窗口专属 checkpoint- session ID 用收尾时刻的时间戳生成
- 文件格式:与 RESUME.md 相同的 5 字段结构,额外包含
session_id
- 根目录
RESUME.md(副)— 向后兼容 fallback,只保留最新一条任务信息
同一任务多次收尾用不同 session ID → 自然产生多个文件 → "继续"时按 task_name 去重,只展示最新。 |
优先读取
真相源文件:PROJECT.md、TASK_QUEUE.md、DECISIONS.md、STATE_SNAPSHOT.md
工作流程
0. 区分收尾类型(最先执行)
必须问用户这一句,不跳过:
这一阶段完成了。下次还要继续吗?
"继续" → 阶段收尾(保留活跃,下次"继续"能找到) "不做了" / "归档" → 归档项目(打包到 archive/)
用户选"阶段收尾"→ 走下面 1-7 步 + 写 .resume/ session 文件。 用户选"归档"→ 跳到归档项目模式。
1. 收尾前快速审计
- 有未记录决策?→ 先补充
- 有未完成功能?→ 标记,不隐藏
- 有偏离?→ 先调用
agent-drift-auditor
2. 总结完成内容 + 验证结果
3. 列出未完成(待开始 / 进行中 / 阻塞)
4. 识别新增决策 → 写入 DECISIONS.md
5. 冻结判断(接口 / 模块 / 命名)
6. 更新真相源
STATE_SNAPSHOT.md:对照旧版本逐字段确认后再改,禁止凭空重写。特别是active_tasks列表——旧版本有的条目不能丢,只能增/改状态/删已完成。TASK_QUEUE.md:移动已完成 → 设新任务DECISIONS.md:汇总证据链 + 新增决策PROJECT.md:更新目标、阶段、冻结区域
7. 生成新对话启动口令
这是新对话。请先读取 PROJECT.md、DECISIONS.md、TASK_QUEUE.md 和 STATE_SNAPSHOT.md。
以这些文件为准,总结当前状态,并告诉我下一步唯一行动。
证据链汇总
本轮所有动作记录 → 写入 DECISIONS.md 附录。
偏离处理
收尾中发现新问题 → 不自己修 → 调 agent-drift-auditor。
交互预算自检
收尾输出前检查:
- 总结信息量是否可控(≤1 屏)?
- 未完成任务清单是否清晰可逐个确认?
- 新对话启动口令是否精简?
禁止事项
- 不开发新功能 / 不隐藏未验证内容
- 不把聊天历史当唯一状态来源
- 不跳过收尾前审计
📦 归档项目模式
用户说"归档项目""归档当前项目""这个项目做完了,帮我归档"时触发。
归档流程(自动执行)
| 步骤 | 操作 |
|---|---|
| 1 | 从 RESUME.md 提取 project name + 当前阶段 |
| 2 | 创建 archive/{project-name}-{date}/ 目录 |
| 3 | 复制 TASK_QUEUE.md → 归档目录(记录任务历史) |
| 4 | 复制 RESUME.md → 归档目录(记录最终状态) |
| 5 | 复制活跃 .resume/ session 文件 → 归档目录 |
| 6 | 复制 PROJECT.md → 归档目录(项目总览 = 归档总结,无需重新生成) |
| 7 | 更新 archive/INDEX.md 加一行:项目名 / 归档日期 / 状态 |
| 8 | 问用户:"当前活跃文件要清理吗?"(不自动删) |
归档后 INDEX.md 更新
| 股票分析网站 | 2026-06-11 | ✅ 完成 | 12 tasks |
禁止事项
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 469k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |