菜单
Update docs/ai/STATE.md to match reality at the end of a work session — branch status, work in progress, gaps, next steps, and a capped session log.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/Andersseen/devflare --skill wrap-session命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | wrap-session |
| description | Update docs/ai/STATE.md to match reality at the end of a work session — branch status, work in progress, gaps, next steps, and a capped session log. |
| disable-model-invocation | true |
docs/ai/STATE.md is the hand-off note between sessions and between agents
(AGENTS.md rule #8). It is only useful if it describes reality, so this rewrites
it from evidence rather than from memory.
git status --short
git log --oneline -8
git diff --stat HEAD
git branch --show-current
Also re-read the current docs/ai/STATE.md so you know what is being replaced.
If something in the existing file contradicts what you observe, the observation wins. If you cannot verify a claim either way, delete it rather than carry it forward — a stale STATE.md is worse than a short one.
Keep the existing section structure and rewrite each in place:
_Last updated: — today's date, YYYY-MM-DD. Never a relative date.
Branch & repo status — current branch, whether the tree is clean, recent merged work.
Work in progress — only genuinely unfinished work. If a section describes something that has since been committed and finished, delete the section and fold a one-liner into "What works today".
What works today — verified working features. Do not add anything you did not see run or test.
Known gaps / not production-ready — add gaps discovered this session, remove ones that were closed.
Next steps — the owner's apparent intent. Mark inferred items as inferred; this file is read as fact by the next agent.
Session log — prepend one entry, newest first, then truncate to the last 5 entries. Format:
- **YYYY-MM-DD** — What changed, in one or two lines. Files or areas touched.
docs/ai/STATE.md. If CONVENTIONS.md,
ARCHITECTURE.md, or AGENTS.md turned out to be wrong during the session,
say so in your reply and let the user decide — those are not this skill's job.pnpm format:write docs/ai/STATE.md (or pnpm format:check) afterwards
so Prettier does not fail CI on the file.Reply with a short diff summary: which sections changed, what was dropped, and anything you deliberately left out because you could not verify it.