# Observe Session

> 可观测性与模型降质检测。Use when 一次开发会话结束、需要记录 Session 摘要、或怀疑模型出现降质（反复返工、标准滑坡、摸鱼）时。也适用于需要追踪 Issue 状态、生成 PR 摘要、复盘 token 花费的场景。

- Skill: `swustcyt/observe-session-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add swustcyt/observe-session-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/swustcyt/observe-session-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: SWUSTcyt (https://skillmd.com/u/swustcyt)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/swustcyt/observe-session-2

---


# Observe-Session：可观测性

## 概述

为长期运行建立可观测性：Issue 状态看板、PR Summary、Session 摘要，并基于指标检测模型降质，及时干预。

**核心原则：** 看得见才管得住。降质要靠指标早发现，而不是等结果烂了才察觉。

## 何时使用

- 一次开发会话结束 → 写 Session 摘要
- PR 提交 → 生成 PR Summary
- 怀疑模型降质（反复返工、标准滑坡）

## Issue 状态看板

标准流转：`todo → in-progress（标注 Agent）→ in-review → blocked（标注原因）→ done`。
本地/单人退化为 `PLAN.md` 表格或编辑器 TODO 列表。

## Session 摘要

每次会话结束记录（用 `templates/session-summary-template.md`），存入 `docs/session-summaries/`：处理的 Issue、用的 Skill、错误与解法、Token 消耗、是否摸鱼。

## PR Summary

每个 PR 末尾附摘要（用 `templates/pr-summary-template.md`）。

## 模型降质检测

| 指标 | 正常值 | 告警阈值 | 处理方式 |
|---|---|---|---|
| Review 轮次 | 1-2 轮 | ≥ 4 轮 | 检查 Issue 是否太大，或换模型 |
| 同一问题反复 | 0 次 | ≥ 2 次 | 检查验收标准是否清晰 |
| 标准滑坡 | 无 | P0 被标为 P2 | 强制重读标准文档 |
| Issue 完成率 | > 80% | < 50% | 拆分 Issue，或换模型 |

**识别信号：** 连续 3 个 Issue review > 4 轮 → 换模型；review 开始说"差不多了合吧" → 查滑坡；同一 Bug 修 2 次没好 → 模型在摸鱼。

## 产出

- Session 摘要（`docs/session-summaries/`）、PR Summary、降质告警与处理建议

## 常见错误

- **只记成功不记错误** → 复盘失去价值。错误与解法必须记。
- **发现降质不干预** → 任由标准烂下去。命中告警阈值就按处理方式动作。

## 参考

- 模板：`templates/session-summary-template.md`、`templates/pr-summary-template.md`
- 下一步：`skills/improve-retro/SKILL.md`（把记录提炼成规则/新 skill）
- 方法论出处：唯一真源 `docs/AI 编程方法论 v1.2 — 可操作版.md` 第四章（Observe）