Menu
专项状态通报 — 从 topic 工件生成面向协作者的摘要（快照，非 SSOT）。 Use when: 总结 commit、生成 MR 摘要、技术同步、变更汇报、workflow-digest
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
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
| 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 标注