| 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
