返回 Showcase 目录

Showcase detail

Release Proof Runbook

把内容更新后的 build、发布、线上抽查和证据留存压成一套可回看的发布闭环,而不是停在“本地看起来没问题”。

所属类别

发布 / 站点维护

适用版本

0.9.x

预计配置时间

20 到 35 分钟

最后验证

2026-04-03

Key signals

适合谁:适合频繁维护内容站、文档站或静态站的编辑者、站长与项目主理人

安全标签:文件写入 + 生产发布 + 线上只读核查

维护状态:样板维护中

Value and proof

这页先证明它真的解决问题

它先证明这次更新真的上线了、关键页面真的可访问,再谈发布效率。 能把一次发布拆成 build、自查、部署、线上抽查和证据记录五步,让“已经发了没”不再靠口头确认。

结果证明

典型场景下能把“本地完成但线上没更新”这类问题提前暴露在发布当轮,而不是几小时后才被用户发现。

为什么强

强项不在自动发得更快,而在把 Deploy Proof Checklist 的核查顺序和 Memory Ledger 的留痕能力绑成稳定闭环。

预期效果

输出一轮可回看的发布记录,明确这次改动是否已上线、哪些页面被核查,以及是否存在部署延迟或回归问题。

不保证项

不保证生产平台永远即时生效,但能显著降低“本地通过却线上异常”长期无人发现的概率。

Input / output

真实输入输出要能支撑复刻判断

允许脱敏,但不能改写结果逻辑。用户要看得出来这不是宣传文案,而是有真实工作流证据。

真实输入示例

输入一轮站点改动、固定的 build / deploy 命令,以及 4 到 6 个关键页面抽查 URL。

真实输出结果

输出一份发布记录:本地自查结果、部署地址、关键页面状态码和是否需要继续追查的备注。

语言支持

中文优先,适合文档型与内容型站点维护流程

包名称

Release Proof Runbook Pack

Representative scenarios

代表性场景先讲真实任务,不讲抽象概念

Showcase 的说服力来自具体使用场景,至少要让用户一眼看出在哪些任务里值得复刻。

在新增 Skills、专题页或首页入口后,完成一轮 build → deploy → 线上验证的完整发布闭环。
为静态站维护记录生产发布结果、关键页面状态码和 Pages 预览地址。
在发现 404、旧页面未刷新或部署延迟时,快速定位问题卡在构建、部署还是 CDN 生效层。

Prerequisites

复刻前必须满足的前置条件

如果前置条件说不清,演示再漂亮也不应让用户误以为能直接复制成功。

需要固定的 lint、build 和生产部署命令。
需要一组最小线上抽查清单,例如首页、目录页、新增详情页和关键入口。
需要允许把命令、结果和验证结论写入可审计日志,而不是只留在聊天上下文里。

Safety controls

高风险能力必须配套写出风险控制

凡是联网、外部账号、文件写入或更高权限的能力,都要告诉用户怎样安全停下。

先完成 lint 和 build,再进入生产发布,不把未自查内容直接推上线。
生产发布后必须核查关键页面与预览地址,不能只看 CLI 返回成功。
所有发布动作都保留时间、命令和结果记录,方便后续定位问题。

Boundaries

这类场景不适合直接复刻

适用边界和已知失败场景必须和能力证明同样醒目,否则 Showcase 会误导用户。

没有固定发布命令、没有关键页面抽查清单的临时性站点。
想把生产写操作完全交给无人监督自动发布的场景。
只记录构建通过,却没有保留生产域名或预览地址的线上验证证据。
关键页面抽查范围过窄,导致入口断链或新页面 404 没被及时发现。

Reproduction steps

可复刻路径要按步骤写,而不是只放结果截图

分享包的任务是让陌生用户也能理解准备项、顺序和停点,不是让人照抄作者环境。

先固定 lint、build 和生产部署命令,不在发布当轮临时拼步骤。
建立关键页面抽查清单,并确认每次更新后至少核查首页、目录页和新增详情页。
跑一次真实发布闭环,记录预览地址、生产域名结果和异常停点。
确认日志结构稳定后,再整理成可复刻分享包与 Showcase 页面。

Package contents

第一版分享包至少要承载这些内容

适合把内容站发布从“本地完成”推进到“线上已验证”的维护流程。 需要手动调整的部分:需要人工决定哪些页面属于本轮关键抽查范围,并在异常时判断是否继续重发或先回滚。

manifest.yaml:声明发布链路涉及的写入、联网和验证范围。
soul.md:定义发布助理优先证明上线结果,而不是先追求速度。
skills.md:说明 Deploy Proof Checklist 与 Memory Ledger 分别负责核查与留痕。
setup.md / safety.md:写清构建顺序、发布停点、线上抽查范围和失败后如何继续定位。

Author and maintenance

作者与维护信息

用于演示站点维护类 Showcase 如何把发布证明、风险边界和留痕闭环一起讲清楚。

作者

agent101 editorial sample

反馈路径

通过站内审核与维护反馈持续修订。

维护状态

样板维护中

最后验证

2026-04-03

Excluded content

公开分享时必须明确不包含的内容

这部分写清楚,才能避免用户把作者没提供、也不该提供的内容误当成缺漏。

不包含生产平台凭证或账号令牌。
不包含未经脱敏的内部基础设施信息。
不包含默认无人值守自动发布配置。