菜单
在 RFC 审查或实现审查已有有效证据后，用单一 report-data.json 生成 HTML、Markdown 与 PR body 交付材料。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | report-walkthrough |
| description | 在 RFC 审查或实现审查已有有效证据后，用单一 report-data.json 生成 HTML、Markdown 与 PR body 交付材料。 |
把当前 task 已通过前置阶段的证据整理成 reviewer 可扫读的交付材料。它不补设计、验证或审查，不发布预览，不替代 legion-wiki 与 PR lifecycle。
所有正文默认使用中文；路径、命令、schema key、状态和错误原文保持可识别。
implementation：按已解析 workflowProfile 验证。Lite 需要当前 docs/test-report.md；Standard 还需 docs/review-change.md；Strict 还需 docs/rfc.md、docs/review-rfc.md。显式设计门用 designRequired=true 保留。rfc-only：无论风险等级都必须有当前 docs/rfc.md、docs/review-rfc.md，且本次只交付设计。contract-only：只用于 Lite design-only 的稳定 contract walkthrough，不伪造 RFC 或 review；reviewStatus=NOT_REQUIRED。## Verdict 后的精确 PASS；缺失、重复、非精确、当前 FAIL 或历史文字冒充当前结论都拒绝。## 会话注意力摘要、claim 状态与领域 verifier 记录必须互相一致；语义分别服从 ../legion-workflow/references/REF_HUMAN_ATTENTION.md 与 ../verify-change/references/REF_COGNITIVE_VERIFICATION.md。证据缺失或冲突时，退回生成该证据的 review-rfc、verify-change 或 review-change，不得在本阶段补写结论。
docs/report-data.json。它只认 references/report-data.schema.json 的 v1.1；v1.0 仅为历史 artifact，必须按当前证据重建，不能重渲染。node skills/report-walkthrough/scripts/render-report.mjs \
--input .legion/tasks/<task-id>/docs/report-data.json
report-walkthrough.htmlreport-walkthrough.mdpr-body.mdpr-html-render 获取预览路径或记录显式 bypass/blocker；仅当 Wiki disposition 为 write 时进入 legion-wiki。Agent 禁止手写或局部修补上述三个生成产物。要改变内容，修改 report-data.json 后重新运行脚本；要改变布局，维护共享模板并重新生成。
workflowProfile=lite|standard|strict 与 designRequired；workflowProfile 不得低于 risk 默认值。旧数据缺字段时仅保留 legacy 兼容，不作为新任务模板。PASS 精确指向当前 task 的 locator；Lite 无 change review 时用 reviewStatus=NOT_REQUIRED，不得虚报 PASS。evidence.status 与 verification.status 只允许 PASS|INFO；claim 只允许 INCONCLUSIVE|DEFERRED|RECOMMENDATION，不得把 FAIL/BLOCKED 包装成 PASS 报告。INCONCLUSIVE、DEFERRED、RECOMMENDATION 必须填写各自状态专属字段。domain / authority claim 可以没有真实 verifier，且每个缺失 verifier 的 claim 都必须在详细产物中明确显示“未获得 verifier”，不得补造 provenance。只有其中状态为 INCONCLUSIVE|DEFERRED 的未决项才额外要求至少 review attention、唯一人类动作、停止点，以及每个 claim 的 evidence locator 映射；RECOMMENDATION 不因缺 verifier 自动进入这个 attention 集合。INCONCLUSIVE 必填证据缺口和升级路径；DEFERRED 必填完整触发、所需数据、停止条件、后续任务及 onPass/onFail 协议。domain / authority verifier，仍必须完整校验 kind、provenance、独立性、未证明范围与残余不确定性；不得伪造。.. 的 repo-relative 路径；预览 URL 只允许 https:。delivery-ready 表达 repo evidence，terminal 后不为状态收口重渲染仓库 artifact。docs/report-data.json。docs/report-walkthrough.html、docs/report-walkthrough.md、docs/pr-body.md。review 时不得越过 merge；为 decide 时不得越过阶段转换。pr-html-render。walkthrough 与 Wiki disposition 独立；需要两者时先完成 walkthrough，再写 Wiki。references/report-data.schema.jsontemplates/report-walkthrough.htmlscripts/render-report.mjs --helppr-html-render当 Legion 任务还没有稳定 contract，目标、验收、范围、约束、假设、风险或阶段仍需收敛时使用。
为 Legion 修改型开发任务提供隔离 worktree、PR、checks/review、终态、cleanup 与主工作区刷新外壳。
当需要创建、更新、校验 `.legion` 任务文档，或判断信息归属时使用。
当需要建立、更新或查询 `.legion/wiki` 的任务摘要、当前决定、可复用模式、维护事项或当前真相时使用。
适用于 Legion 管理仓库中的多步骤、不确定、中高风险或跨模块工程工作；普通只读请求与明确低风险微操作不触发。
当稳定 contract 仍有设计分叉、回滚风险、验证歧义或多模块协调问题需要在实现前解决时使用。