framework-walkthrough

项目走查 (framework-walkthrough)

能力边界

• 能做: 在隔离沙盒里部署目标平台资产并以指定执行模式驱动一个小型示例项目跑通端到端工作流；按 references/runtime-flow-map.md 逐路径覆盖完整运行流程的五类路径（初始化 / 核心执行链路 / 分支 / 异常 / 终止清理），在每个阶段/门禁/降级/恢复处采集「观察点」；产出框架本身与走查流程本身两类改进建议报告 + 路径覆盖账本；走查后按 references/self-update-protocol.md 对 process 类 findings 做自更新闭环（回灌本 skill 的 SKILL.md / references）；跨四端可移植（用能力标识符与 cataforge CLI 而非平台原生名）
• 不做: 修改被走查项目的业务资产或本 skill 之外的 .cataforge/ 本体（framework 类改进只产报告到 docs/reviews/framework/；自更新仅限框架仓本体内的 skills/framework-walkthrough/ 子树）；替代 framework-review 的静态元资产审查（互补，发现面不同）；替代 platform-audit 的 IDE 厂商对账；进入业务开发主循环（按需触发）

输入规范

• 可选 --mode: 执行模式，缺省 standard（7 阶段全跑，门禁与检查点覆盖面最大）；要快速冒烟时显式 --mode agile-lite；语义见 COMMON-RULES §执行模式矩阵
• 可选 --platform: 目标平台，缺省取 framework.json#/deployment.default_platform
• 可选 --example: 示例目标 id，缺省内置 temperature-converter（见 references/example-project.md）；要走查 UI 链路（ui_design 真驱动 + UI 保真评审）用 temperature-converter-ui；自带目标须小到单轮收敛
• 可选 --depth: 覆盖深度，缺省 smoke。smoke 只确定性驱动 happy path 主干、对分支/异常路径仅机会观察；full 额外按路径图探针清单逐个触发可达的分支/异常路径
• 被走查的框架资产: 项目根 .cataforge/（必读）
• 完整运行流程路径图: references/runtime-flow-map.md；详细执行协议: references/walkthrough-protocol.md；观察与归类口径: references/observation-rubric.md；自更新协议: references/self-update-protocol.md

输出规范

• 走查改进报告: docs/reviews/framework/FRAMEWORK-REVIEW-walkthrough-{YYYYMMDD}-r{N}.md，front matter doc_type: framework-review（编号与字段按 .cataforge/references/review-report-spec.md）
• 报告含: 两类 findings（framework 框架本身缺陷/摩擦 + process 走查流程本身可改进项，各按 COMMON-RULES §统一问题分类体系 / §归因分类 与 .cataforge/references/review-report-spec.md §问题格式 标注；process 条目附 resolution: applied|proposed|deferred）+ 路径覆盖账本（路径图每条路径标 driven / probed / observed / not-reached(原因)，字段见 runtime-flow-map §7）
• 自更新变更（若触发）: 对本 skill SKILL.md / references 的修改留在工作区由标准 PR 流程收口，修改摘要记入报告对应 process finding
• 沙盒运行产物: 留在 gitignored 沙盒目录供复核，不入仓；报告以「产物清单 + 关键证据」形式引用