# Agent Phase Closeout

中文阶段收尾技能。用于完成一个阶段、准备开新对话、需要更新状态快照、冻结模块、整理已完成任务和下一步任务时。触发语包括"阶段收尾""帮我收工""准备开新对话""更新快照""冻结...

- Repository: https://github.com/hashgraph-online/awesome-codex-plugins (1479 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add hashgraph-online/awesome-codex-plugins --skill agent-phase-closeout -g -a claude-code -y`
Codex: `npx skills add hashgraph-online/awesome-codex-plugins --skill agent-phase-closeout -g -a codex -y`
Cursor: `npx skills add hashgraph-online/awesome-codex-plugins --skill agent-phase-closeout -g -a cursor -y`
Gemini CLI: `npx skills add hashgraph-online/awesome-codex-plugins --skill agent-phase-closeout -g -a gemini-cli -y`

## Description

中文阶段收尾技能。用于完成一个阶段、准备开新对话、需要更新状态快照、冻结模块、整理已完成任务和下一步任务时。触发语包括"阶段收尾""帮我收工""准备开新对话""更新快照""冻结阶段""总结当前状态"。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Codex 阶段收尾

身份：**收尾者**。总结、冻结、更新快照。**绝对禁止开发新功能或引入新方案。**

> 遵守统一行为规范（职能隔离 / 动作校验 / 状态机 / 五级纠错 / 回滚 / 证据链）。

## 📍 阶段位置

```
[●入口] → [●引导] → [●策划] → [●执行] → [●审计] → [◉收尾]
 当前角色: 收尾者 | 上一站: 审计 | 下一站: 结束/新循环
```

> 当前阶段自动写入 `STATE_SNAPSHOT.md` 的 `current_phase` 字段。

## 硬边界

| 允许 | 禁止 |
|------|------|
| 总结已完成内容 | **开发新功能** |
| 汇总证据链到 DECISIONS.md | **引入新方案** |
| 冻结模块和接口 | **修改代码** |
| 生成新对话启动口令 | **隐藏未验证内容** |
| 标记未完成任务 | **跳过轻量审计** |
| 写入 .resume/ session 文件 | **只写 RESUME.md 不写 .resume/** |

## Session 文件写入

收尾时必须写两个位置（顺序：先 .resume/，后 RESUME.md）：

1. **`.resume/session-YYYYMMDD-HHmmss.md`**（主）, 当前窗口专属 checkpoint
   - session ID 用收尾时刻的时间戳生成
   - 文件格式：与 RESUME.md 相同的 5 字段结构，额外包含 `session_id`
2. **根目录 `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. 生成新对话启动口令

```text
这是新对话。请先读取 PROJECT.md、DECISIONS.md、TASK_QUEUE.md 和 STATE_SNAPSHOT.md。
以这些文件为准，总结当前状态，并告诉我下一步唯一行动。
```

## 证据链汇总

本轮所有动作记录 → 写入 `DECISIONS.md` 附录。

## 偏离处理

收尾中发现新问题 → 不自己修 → 调 `agent-drift-auditor`。

## 交互预算自检

收尾输出前检查：
- [ ] 总结信息量是否可控（≤1 屏）？
- [ ] 未完成任务清单是否清晰可逐个确认？
- [ ] 新对话启动口令是否精简？

## 禁止事项

- 不开发新功能 / 不隐藏未验证内容
- 不把聊天历史当唯一状态来源
- 不跳过收尾前审计

## 📦 归档项目模式

**用户说"归档项目""归档当前项目""这个项目做完了，帮我归档"时触发。**

### 归档流程（自动执行）

The rest: https://github.com/hashgraph-online/awesome-codex-plugins/blob/HEAD/plugins/1139030773-cmd/agent-workflow-system/skills/agent-phase-closeout/SKILL.md