Menú
专项状态通报 — 从 topic 工件生成面向协作者的摘要（快照，非 SSOT）。 Use when: 总结 commit、生成 MR 摘要、技术同步、变更汇报、workflow-digest
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
| name | workflow-digest |
| description | 专项状态通报 — 从 topic 工件生成面向协作者的摘要（快照，非 SSOT）。 Use when: 总结 commit、生成 MR 摘要、技术同步、变更汇报、workflow-digest |
| description_zh | 专项状态通报 — 从 topic 工件生成面向协作者的摘要（快照，非 SSOT）。 |
| license | MIT |
| metadata | {"author":"ArnoFrost","version":"3.0.0"} |
| visibility | public |
| stability | stable |
| user_invocable | true |
| public_gate | {"reviewed":true,"reviewed_by":"ArnoFrost","reviewed_at":"2026-07-13","rationale":"Prism 3.0 面向协作者的状态快照入口，明确非 SSOT 且不改合同。","rollback":"将 catalog 与 SKILL 镜像恢复为 dev/experimental；既有 digest 快照保持可读。","ssot_id":"workflow-digest"} |
管线定位：辅助工具，需要对外沟通或自我回顾时按需调用
路径变量：本文中
{skill_dir}指此 SKILL.md 文件所在目录的绝对路径。在 Cursor 中对应 skill 根目录，在 CodeBuddy / Claude Code 中对应{baseDir}。执行脚本时请自行替换为实际路径。
| 场景 | 做法 |
|---|---|
| 需要跟产品/协作者同步专项进度 | /workflow-digest |
| 自己忘了某个专项做到哪了 | /workflow-digest |
| 准备启动新一轮工作前快速回顾 | /workflow-digest |
| 跨团队汇报某专项状态 | /workflow-digest |
不适用的场景：
| 场景 | 应该用 |
|---|---|
| 总结 commit / MR / diff | 个人 digest 技能 |
| 深度评审、发现问题 | workflow-review |
| 机器可读的健康度指标 | workflow-status |
| 沉淀长期知识资产 | learnnote |
给人看的快照，不是给机器算的指标。
Phase 0 探测（workspace + topic 定位）
↓
Phase 1 采集（运行 prism digest，底层 collect.py 提取结构化数据）
↓
Phase 2 生成（Agent 消费 JSON + 用户补充上下文，生成摘要）
↓
Phase 3 落盘（覆写 topic 根目录的 digest.md）
确认目标 topic，并优先使用 Prism 统一 CLI 采集 topic 工件：
prism digest <project_dir> --topic <topic_dirname>
底层脚本仅作为 CLI 不可用时的维护者 / 调试 fallback：
uv run python {skill_dir}/scripts/collect.py <project_dir> --topic <topic_dirname>
如果用户未指定 topic，从当前活跃专项中选择（如只有一个活跃专项，直接使用）。
prism digest 输出 JSON（底层由 collect.py 实现），包含：
| 字段 | 来源 | 用途 |
|---|---|---|
readme.status | README.md（deprecated，仅 grandfather） | 当前阶段；缺失时降级 |
readme.current_state | README.md（deprecated，仅 grandfather） | 主线任务；缺失降级 focus.current_state |
scope.goals | scope.md | 目标列表 |
scope.acceptance_progress | scope.md | 验收进度（X/Y） |
scope.open_questions | scope.md | 未决问题 |
focus.current_state | focus.md | 光标快读面「当前态」（README 缺失时主状态源） |
focus.current_focus | focus.md | 当前焦点「下一步」 |
focus.progress | focus.md | 进度（X/Y） |
decisions | decisions/ | 最近 3 个决策 |
reviews | reviews/ | 最近 2 轮评审 TL;DR |
Agent 根据采集数据 + 用户补充的上下文（如"需要跟产品讨论 X 问题"），按 digest-templates.md 的骨架生成摘要。
关键约束：
覆写到 topics/{NNN}_{topic}/digest.md。
generated 日期和 stale_after 标注| 属性 | 值 |
|---|---|
| 文件名 | digest.md（topic 根目录） |
| 生命周期 | 每次覆写，不保留历史 |
| SSOT | 否 |
| 被引用 | 否（不被其他工件索引或引用） |
| 骨架预创建 | 否（不在 intake 骨架中，按需生成） |
workflow/workflow-digest/
├── SKILL.md # 入口（本文件）
├── scripts/
│ ├── collect.py # 输入采集（输出 JSON）
│ └── sniff_lib.py → ../../shared/sniff_lib.py
└── references/
└── digest-templates.md # 输出骨架 + 格式规范
| 技能 | 职责 | 交接点 |
|---|---|---|
| digest（本技能） | topic 状态 → 面向协作者的摘要 | 消费 scope/focus/reviews/decisions |
| status | 健康度指标 → 面向 Agent 的报告 | status 给机器，digest 给人 |
| review | 深度评审 → 仲裁 → 行动计划 | review 是决策工具，digest 是通报工具 |
| tidy | 工件机械对齐 | tidy 对齐元数据，digest 生成叙事 |
| 维度 | 个人 digest | workflow-digest（本技能） |
|---|---|---|
| 输入 | commit / MR / diff | topic 工件（scope/focus/reviews） |
| 输出 | 技术变更摘要 | 专项状态通报 |
| 读者 | 技术负责人 | 产品 / 协作者 / 自己 |
| 触发 | 代码变更后 | 需要对外沟通时 |
本 skill 依赖 prism skills/workflow/shared/（外部依赖，不复制进 bundle）：
| 依赖 | 来源 | 不可用时（bundle 缺 shared） |
|---|---|---|
scripts/sniff_lib.py | ../../shared/sniff_lib.py | collect.py 优雅降级：清晰报错 + exit 2 |
scripts/parse_utils.py（read_file/extract_field/extract_section/count_checkboxes/resolve_work_file） | ../../shared/scripts/parse_utils.py | 同上（已 try/except 包裹） |
prism.local.yaml 配置解析，非硬编码；bin/relink 分发软链、prism CLI 装入 PATH）+ Python ≥3.11 + uv（脚本经 uv run 调用）；缺任一项时按上表「不可用时」列降级，不裸崩。对应 evals 三类（evals/cases.yaml），示范「快照非 SSOT」边界：
prism digest 采集 scope/focus/reviews/decisions，生成 < 40 行、说人话的摘要，覆写 topic 根 digest.md。digest.md，未触碰 scope/focus/reviews/decisions 等 SSOT 工件generated 日期与 stale_after 标注Topic 生命周期治理 — archive 移入 archive/ 释放注意力；reactivate 拉回 topics/ 继续跟踪。preview-first，移目录须用户确认。Use when: 归档 topic、prism archive、prism reactivate、尘封专项、workflow-archive
Topic 活跃上下文压实与上下文熵治理。用于在独立对话中对膨胀 topic 做 preview-first 的整理方案，并在 apply 前强制创建时间戳备份，降低 Agent 有损整理或误整理的风险。 Use when: 压缩 topic、compact topic、整理 topic 工作区、剥离历史噪声、降低后续 Agent token、维护长期 topic 当前态、上下文瘦身、workflow-compact。
接收新需求并默认创建新的 3.0 topic；仅在显式 append/migrate/upgrade 时追加、聚合或升级已有 topic。输出专项骨架 + index 更新。 Use when: 新需求入料、创建新 topic、2.x topic 升级、显式 append、显式 migrate、workflow-intake
单视角轻量评审：读取 scope（专项边界合同）与 focus（当前工作集/关注点）后，直接输出结论 + 行动项，不做多角色仲裁。适用于日常迭代、小改动确认、边界快速对齐。 Use when: 日常迭代检查、小改动确认、快速对齐、轻量评审、单视角评审、改动确认、review lite、review-lite、workflow-review-lite
多角色协作评审，用于方向变更、范围调整或里程碑检查点。四阶段 Align-Explore-Merge-Gate4，输出分级 findings + 行动计划到 reviews/rXX.md。 Use when: 方向变更评审、里程碑检查、多角色审查、范围调整、workflow-review
在决策后更新 scope.md 并刷新 focus.md，确保合同面一致性。当接受评审决策或发现 scope 与执行偏移时触发。scope 是 focus 与 structures/task.index 的唯一上游。 Use when: 接受决策后同步、scope 偏移修正、边界收敛、focus 刷新、workflow-scope