القائمة
工件机械对齐 — review/decision 后同步 review.index、frontmatter，并兜底刷新存量 README 指针（grandfather）；decision.index 由 dXX 维护，tidy 不 auto-fix。 Use when: 工件对齐、状态同步、review 后收尾、workflow-tidy
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | workflow-tidy |
| description | 工件机械对齐 — review/decision 后同步 review.index、frontmatter，并兜底刷新存量 README 指针（grandfather）；decision.index 由 dXX 维护，tidy 不 auto-fix。 Use when: 工件对齐、状态同步、review 后收尾、workflow-tidy |
| description_zh | 工件机械对齐 — review/decision 后同步 review.index、frontmatter；decision.index 由 dXX 维护。 |
| 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 工件机械对齐入口，只修 how、不改变 scope 的 what。","rollback":"将 catalog 与 SKILL 镜像恢复为 dev/experimental；机械修复结果无需回滚。","ssot_id":"workflow-tidy"} |
| 维度 | 说明 |
|---|---|
| 是什么 | 工件机械对齐：Phase 0→3；默认 dry-run，--fix 应用安全 auto-fix |
| 不是什么 | 不改 what；不 auto-fix scope/focus 语义；不补 decision.index |
| 读什么 | Happy path 仅本文件；grandfather 规则条件 cite topic-format-spec |
| 写什么 | JSON diff 预览；--fix 时修改安全项 + 输出摘要 |
| 结束建议 | 语义项提示用户确认；可串联 prism finalize |
管线定位：
review/decision → tidy → archive；{skill_dir}指 SKILL.md 所在目录。
| 场景 | 做法 |
|---|---|
| 完成一轮工作，focus/索引状态需同步 | /workflow-tidy |
| review 落盘后 review.index（及 grandfather README）指针过时 | /workflow-tidy |
| 归档前检查工件一致性 | /workflow-tidy |
| 日常推进后随手对齐 | /workflow-tidy --fix |
不改 what，只改 how。不做判断，只做对齐。
| 允许 | 禁止 |
|---|---|
| 刷新 README updated 日期（grandfather） | 新增 focus 条目 |
| 同步 latest review/decision 指针（grandfather） | 修改 scope 目标或验收口径 |
| 补全 review.index.md 缺失行 | 调整优先级 |
| 修复 frontmatter updated | 勾选 scope 验收 |
| 报告 focus 可能已完成的条目 | 自动勾选 focus checkbox |
| — | 自动补 decision.index |
Phase 0 探测（workspace 定位）
↓
Phase 1 扫描（逐 topic 采集差异）
↓
Phase 2 报告（JSON diff 预览，默认 dry-run）
↓
Phase 3 执行（--fix 时应用安全 auto-fix + 摘要）
# 扫描所有活跃 topic（默认 dry-run）
prism tidy <project_dir>
# 扫描并自动修复
prism tidy <project_dir> --fix
# 只扫描指定 topic
prism tidy <project_dir> --topic 011_prism-generalization-fieldtest
CLI fallback 与目录结构见 tidy-maintainer.md。
脚本输出 JSON，含每个 topic 的 diff 项。
| 检查项 | 数据源 | 自动修复？ |
|---|---|---|
README updated 日期（grandfather） | README.md vs mtime | 是（无 README 跳过） |
README latest review 指针（grandfather） | reviews/ 最新 | 是（无 README 跳过） |
README latest decision 指针（grandfather） | decisions/ 最新 | 是（无 README 跳过） |
| review.index.md 缺失条目 | decisions/*.md 的 review_ref → reviews/ | 是 |
frontmatter updated 日期 | scope/focus/plan mtime | 是 |
| focus 已完成条目未移动 | focus.md 结构 | 仅报告 |
| scope 未勾选提醒 | scope.md checkbox | 仅报告 |
| decision.index.md 同步 | decisions/ vs index | 仅报告（tidy 不 auto-fix；由 dXX 维护） |
[[wikilink]] 残留 | 全文扫描 | 是 |
| 门 | 规则 |
|---|---|
| report-first | 无 --fix 只报告不修改 |
| semantic-report-only | 即使有 --fix，scope/focus 语义项也只报告 |
| grandfather skip | README 指针类检查仅对存量 grandfather topic 生效（topic-format-spec §2） |
--fix 补全稀疏资格：Accept/Reject/Defer 都会写 dXX，其 review_ref 可赋予 review.index 资格；Other 不写 dXX，磁盘上单独存在 review 不构成资格。
| 技能 | 交接 |
|---|---|
| status | 健康巡检 report-first；发现 index 漂移 → 建议 tidy --fix |
| compact | 上下文压实；发现指针/索引机械错误 → 建议 tidy，不自行 fix |
| finalize | bin/prism finalize 可在 decision 后串联 tidy |
CLI fallback、code-simplifier 类比、目录结构 → tidy-maintainer.md
本 skill 依赖 prism skills/workflow/shared/（外部依赖，不复制进 bundle）：
| 依赖 | 来源 | 不可用时（bundle 缺 shared） |
|---|---|---|
scripts/sniff_lib.py | ../../shared/sniff_lib.py | tidy.py 优雅降级：清晰报错 + exit 2 |
scripts/parse_utils.py（resolve_work_file） | ../../shared/scripts/parse_utils.py | 同上（已 try/except 包裹） |
references 软链：topic-format-spec | ../../shared/ | 仅 grandfather 分支按需读，缺失不阻断主流程 |
prism.local.yaml 配置解析，非硬编码；bin/relink 分发软链、prism CLI 装入 PATH）+ Python ≥3.11 + uv（脚本经 uv run 调用）；缺任一项时按上表「不可用时」列降级，不裸崩。对应 evals 三类（evals/cases.yaml），示范机械对齐边界：
--fix 应用安全项；裸 review 不入索引。--fix 也仅报告，不自动勾选、不移动条目、不补 decision.index（由 dXX 维护）。--fix 时零写盘（report-first），仅输出 JSON diff 预览--fix 只应用安全项（eligible review.index 补行、frontmatter updated、grandfather 指针、wikilink 残留）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。
专项状态通报 — 从 topic 工件生成面向协作者的摘要（快照，非 SSOT）。 Use when: 总结 commit、生成 MR 摘要、技术同步、变更汇报、workflow-digest
接收新需求并默认创建新的 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