Topic 生命周期治理 — archive 移入 archive/ 释放注意力；reactivate 拉回 topics/ 继续跟踪。preview-first，移目录须用户确认。Use when: 归档 topic、prism archive、prism reactivate、尘封专项、workflow-archive

2026-07-134

workflow-compact

ArnoFrost/prism

Topic 活跃上下文压实与上下文熵治理。用于在独立对话中对膨胀 topic 做 preview-first 的整理方案，并在 apply 前强制创建时间戳备份，降低 Agent 有损整理或误整理的风险。 Use when: 压缩 topic、compact topic、整理 topic 工作区、剥离历史噪声、降低后续 Agent token、维护长期 topic 当前态、上下文瘦身、workflow-compact。

2026-07-134

workflow-intake

ArnoFrost/prism

接收新需求并默认创建新的 3.0 topic；仅在显式 append/migrate/upgrade 时追加、聚合或升级已有 topic。输出专项骨架 + index 更新。 Use when: 新需求入料、创建新 topic、2.x topic 升级、显式 append、显式 migrate、workflow-intake

2026-07-134

workflow-review-lite

ArnoFrost/prism

单视角轻量评审：读取 scope（专项边界合同）与 focus（当前工作集/关注点）后，直接输出结论 + 行动项，不做多角色仲裁。适用于日常迭代、小改动确认、边界快速对齐。 Use when: 日常迭代检查、小改动确认、快速对齐、轻量评审、单视角评审、改动确认、review lite、review-lite、workflow-review-lite

2026-07-134

workflow-review

ArnoFrost/prism

多角色协作评审，用于方向变更、范围调整或里程碑检查点。四阶段 Align-Explore-Merge-Gate4，输出分级 findings + 行动计划到 reviews/rXX.md。 Use when: 方向变更评审、里程碑检查、多角色审查、范围调整、workflow-review

2026-07-134

workflow-scope

ArnoFrost/prism

在决策后更新 scope.md 并刷新 focus.md，确保合同面一致性。当接受评审决策或发现 scope 与执行偏移时触发。scope 是 focus 与 structures/task.index 的唯一上游。 Use when: 接受决策后同步、scope 偏移修正、边界收敛、focus 刷新、workflow-scope

2026-07-134

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"}

专项状态通报 (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`

核心原则

给人看的快照，不是给机器算的指标。

有时效性：每次生成覆写上一次，不保留历史
不是 SSOT：没有工件引用 digest.md，它只是一个方便的快照
被动过时：后续变更会让它过时，但不需要主动维护
面向协作者：读者是不看代码、不看 scope 原文的人

执行流程

Phase 0  探测（workspace + topic 定位）
  ↓
Phase 1  采集（运行 prism digest，底层 collect.py 提取结构化数据）
  ↓
Phase 2  生成（Agent 消费 JSON + 用户补充上下文，生成摘要）
  ↓
Phase 3  落盘（覆写 topic 根目录的 digest.md）

Phase 0：探测

确认目标 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，从当前活跃专项中选择（如只有一个活跃专项，直接使用）。

Phase 1：采集

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

Phase 2：生成

Agent 根据采集数据 + 用户补充的上下文（如"需要跟产品讨论 X 问题"），按 digest-templates.md 的骨架生成摘要。

关键约束：

控制在一屏以内（< 40 行正文）
说人话，不贴代码
结论清晰，不模棱两可
没有卡点就写没有，不凑数

Phase 3：落盘

覆写到 topics/{NNN}_{topic}/digest.md。

已有 digest.md → 直接覆盖
不存在 → 新建
frontmatter 必须包含 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       # 输出骨架 + 格式规范

与其他 workflow skill 的关系

技能	职责	交接点
digest（本技能）	topic 状态 → 面向协作者的摘要	消费 scope/focus/reviews/decisions
status	健康度指标 → 面向 Agent 的报告	status 给机器，digest 给人
review	深度评审 → 仲裁 → 行动计划	review 是决策工具，digest 是通报工具
tidy	工件机械对齐	tidy 对齐元数据，digest 生成叙事

与个人 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 monorepo relink 后软链有效。
安装前提 / 版本：需 prism SDK（仓库路径由本地 prism.local.yaml 配置解析，非硬编码；bin/relink 分发软链、prism CLI 装入 PATH）+ Python ≥3.11 + uv（脚本经 uv run 调用）；缺任一项时按上表「不可用时」列降级，不裸崩。
独立 bundle：越界 import 缺失时须附带 shared 只读依赖后再评估，不把依赖缺失误判为 skill 主路径缺陷。

few-shot 示例

对应 evals 三类（evals/cases.yaml），示范「快照非 SSOT」边界：

正常触发：用户「帮我给产品同步下这个专项进度」→ prism digest 采集 scope/focus/reviews/decisions，生成 < 40 行、说人话的摘要，覆写 topic 根 digest.md。
边界（无输入上下文）：用户只给 topic 不给沟通目的 → 按工件如实生成状态快照，卡点为空就写「无卡点」，不凑数、不臆测协作诉求。
错误（缺 topic / 缺依赖）：未指定且多活跃 topic / shared 依赖缺失 → 先澄清目标 topic 或清晰报错（exit 2），不抛裸栈、不改写 scope/focus 等 SSOT 工件。

完工 checklist

仅覆写 topic 根 digest.md，未触碰 scope/focus/reviews/decisions 等 SSOT 工件
正文 < 40 行、说人话不贴代码、结论不模棱两可
frontmatter 含 generated 日期与 stale_after 标注
无卡点如实写「无」，未凑数
缺 topic 先澄清 / 缺 shared 依赖优雅降级（清晰报错 + 非零退出），未抛裸栈