workflow-status

name	workflow-status
description	扫描活跃专项的健康度，输出结构化报告。当需要了解项目进度、检查骨架完整性、或发现不规范产物时触发。report-first：只报告不修改。 Use when: 查看项目状态、健康检查、进度总览、骨架完整性检查、workflow-status
description_zh	扫描活跃专项的健康度，输出结构化报告。report-first：只报告不修改。
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 只读健康巡检入口，next_actions 仅建议且不自动执行。","rollback":"将 catalog 与 SKILL 镜像恢复为 dev/experimental；无持久写盘需要回滚。","ssot_id":"workflow-status"}

职责边界

维度	说明
是什么	只读健康度巡检工具：扫描全部活跃 topic 的骨架完整性、进度、活跃度，输出结构化报告 + next_actions[] 建议
不是什么	不写关键工件、不自动发起 review、不重构 scope/focus、不自动执行修复或归档（report-first / handoff-only）
读取工件	workspace 全部 topic 按 context-pack-spec light 档逐 topic 采集（scope.md / focus.md 入口；README.md 仅存量 grandfather）；另统计 reviews/ + decisions/ 文件数
写入工件	无（只读报告）
结束建议	根据结构化状态建议 → workflow-scope / workflow-tidy / workflow-review-lite / workflow-archive preview；只 handoff，不执行
设计模式	Pattern 4 — Context-aware Tool Selection（根据健康度状态和问题类型建议不同的下一步 skill）

---

专项健康度巡检 (Workflow Status)

管线定位：辅助工具，可在任意阶段调用

路径变量：本文中 {skill_dir} 指此 SKILL.md 文件所在目录的绝对路径。在 Cursor 中对应 skill 根目录，在 CodeBuddy / Claude Code 中对应 {baseDir}。执行脚本时请自行替换为实际路径。

何时使用

场景	做法
不确定当前项目有哪些活跃专项	/workflow-status
想知道某专项的 scope 进度	/workflow-status
怀疑某专项骨架不完整或产物不规范	/workflow-status
启动新一轮工作前了解全局	/workflow-status
Agent 需要理解当前上下文和进度	自动调用或提示用户

执行流程

Phase 0  探测（workspace 定位）
  ↓
Phase 1  扫描（逐 topic 健康度采集）
  ↓
Phase 2  报告（输出结构化结果）
  ↓
Phase 3  建议（生成 next_actions[]；只建议，不执行）

Phase 0：探测

优先使用 Prism 统一 CLI 定位 workspace 并输出报告：

prism status <project_dir> --format markdown

底层脚本仅作为 CLI 不可用时的维护者 / 调试 fallback：

uv run python {skill_dir}/scripts/status.py <project_dir> --format markdown

Phase 1-2：扫描与报告

脚本自动完成，输出包含以下维度：

维度	数据源	说明
骨架完整性	目录扫描	scope/focus（入口）/review.index 是否齐全；README deprecate 不作必需项
scope 进度	checkbox 统计	验收口径勾选比例
focus 进度	checkbox 统计	待执行/已完成比例
更新活跃度	文件 mtime	scope/focus 最近修改时间（README mtime 仅存量参考）
评审轮次	reviews/ 文件数	已完成的评审轮次
决策记录	decisions/ 文件数	已记录的决策数

不依赖的维度（设计约束）：

• verify 覆盖率（当前创建数为 0）
• 产物内容质量（属于 review 的职责）

Phase 3：建议（Next Actions）

脚本在 JSON 顶层输出 next_actions[]，Markdown 渲染 ## 建议下一步（Next Actions）。 第一版 detector 只基于结构化 status 字段（scope.checked/unchecked、review_count、skeleton_missing、location），不从中文 issues[] 文案反解析。

JSON 合同

next_actions:
  - id: <stable action id>
    priority: P1 | P2 | P3
    target_type: topic | workspace
    target: <topic slug | null>
    skill: workflow-scope | workflow-tidy | workflow-review-lite | workflow-archive | null
    reason: <one sentence>
    source: status_report
    confidence: high | medium | low
    execution_policy: handoff_only | preview_required | no_action
    blocking: <target skill gate / prerequisite>

Detector 表

条件（结构化字段）	建议动作	priority	execution_policy
skeleton_missing 非空	workflow-tidy / scaffold 口径	P1	handoff_only
scope.unchecked > 0 && scope.checked == 0 && review_count == 0	workflow-review-lite	P1	handoff_only
scope.unchecked > 0 && scope.checked == 0	workflow-scope	P1	handoff_only
review_count == 0	workflow-review-lite	P2	handoff_only
location == topics && scope.unchecked == 0 && scope.checked > 0	workflow-archive	P2	preview_required
无可判定 action	workspace no_action	P3	no_action

report-first 原则：Agent 只报告和建议，不自动执行修复。用户确认后再行动。 handoff-only 原则：archive / compact / tidy / scope / review 均由目标 skill 重新执行自身 Gate；status 不代表目标 skill 写盘。 source 边界：CLI 只生成 source=status_report；digest / intake 等用户意图路由属于 Agent 会话层，不进入 status.py。

输出格式

支持两种格式：

• --format json（默认）：结构化 JSON，适合 Agent 消费
• --format markdown：可读的 Markdown 报告，适合直接展示给用户

Markdown 报告示例

# Workspace 健康度报告

> 扫描时间：2026-03-21

## 总览

| 指标 | 值 |
|------|------|
| 活跃专项 | 1 |
| 健康 | 0 |
| 需注意 | 1 |

## 建议下一步（Next Actions）

| 优先级 | 对象 | 建议 skill | 原因 | 策略 | 前置/阻塞 |
|--------|------|------------|------|------|-----------|
| P1 | 008_agent-workflow-patterns | workflow-review-lite | scope 未启动且无 review，需要先判断是否继续推进或收口。 | handoff_only | review-lite/full 由目标评审流程自行 Gate；status 不生成决策。 |

## 🟡 008_agent-workflow-patterns

| 维度 | 值 |
|------|------|
| scope 进度 | 3/6 |
| focus 进度 | 3/8 |
| 评审轮次 | 1 |
| 决策记录 | 1 |

**问题：**
- ⚠️ scope 3 项未勾选

健康度等级

等级	条件	含义
🟢 healthy	0 个 issues	骨架完整，活跃更新
🟡 warning	1-2 个 issues	有小问题，不阻塞
🔴 attention	3+ 个 issues	需要关注

目录结构

workflow/workflow-status/
├── SKILL.md                      # 入口（本文件）
└── scripts/
    ├── status.py                 # 健康度扫描脚本
    └── sniff_lib.py              → ../../shared/sniff_lib.py

与其他 workflow skill 的关系

技能	职责	交接点
status（本技能）	健康度巡检 → 报告 → 建议	可在任意阶段调用，不改变工件
intake	入料 → 路由 → 初始化	status 可检测 intake 产出的骨架完整性；用户新需求归属不明时由 Agent 建议，不由 CLI status 猜测
review	评审 → 仲裁 → 行动计划	status 统计评审轮次
scope	边界收敛与合同维护	status 统计验收进度
archive	归档已验收专项	status 仅建议 preview；移动必须由 archive Gate + 用户接受
digest	对外状态通报	用户有通报意图时由 Agent 建议，不由 CLI status 猜测

依赖声明

本 skill 依赖 prism skills/workflow/shared/（外部依赖，不复制进 bundle）：

依赖	来源	不可用时（bundle 缺 shared）
scripts/sniff_lib.py	../../shared/sniff_lib.py	status.py 优雅降级：清晰报错 + exit 2
scripts/parse_utils.py（resolve_work_file）	../../shared/scripts/parse_utils.py	同上（已 try/except 包裹）
references 软链：context-pack-spec	../../shared/	按需读，缺失不阻断主流程

• 可解析前提：在 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），示范只读扫描边界：

• 正常触发：用户「看下现在项目状态 / 各 topic 健康度」→ 扫描 topics/ 与 archive/，输出健康分级 + next_actions 建议，只报告不写盘。
• 边界（查中带改意图）：用户「顺便把过期的归档了」→ status 只输出 next_action 建议（execution_policy=handoff/preview），归档动作交 workflow-archive，status 自身绝不写盘。
• 错误（无 workspace）：目标目录非 Prism workspace 或 shared 依赖缺失 → 清晰报错（找不到 workspace / 依赖未就位 exit 2），不抛裸栈、不猜测路径。

完工 checklist

• 报告为只读产物，未写入/apply 任何变更（execution_policy 恒为 handoff/preview/no_action）
• 输出路径统一正斜杠（跨平台），workspace/topic 路径无反斜杠泄漏
• topics/ 与 archive/ 均已扫描，活跃与归档分别计数
• 缺 workspace / 缺 shared 依赖时优雅降级（清晰报错 + 非零退出），未抛裸栈
• --format markdown|json 两种输出均可正常渲染