返回 Showcase 目录

Showcase detail

Approval Watchtower

把高风险动作排成清晰批准队列,先解释影响范围,再决定要不要放行。

所属类别

安全 / 运行治理

适用版本

0.9.x

预计配置时间

20 到 30 分钟

最后验证

2026-03-15

Key signals

适合谁:适合经常处理文件写入、Shell 和外部提交动作的个人维护者与小团队

安全标签:文件写入 + Shell + 外部写操作说明

维护状态:样板维护中

Value and proof

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

它让批准不再只是点一下确认,而是先把会影响什么、停在哪一步讲明白。 能把高风险动作拆成待批清单、影响说明和失败停点,而不是把整段执行链路打包成黑箱。

结果证明

典型场景下可把批准判断时间压缩到 1 到 2 次清晰确认,减少反复追问“这条命令到底会改哪”。

为什么强

强项不在自动做更多事,而在把批准质量拉高,让用户真能看懂放行的后果。

预期效果

输出结构化待批说明,让用户一眼看清动作范围、风险和停点。

不保证项

不保证批准后动作一定安全,只保证风险表达更完整、更可判断。

Input / output

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

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

真实输入示例

输入一组待执行动作:改 3 个文档、运行 1 条构建命令、向 1 个外部服务提交变更。

真实输出结果

输出逐条批准说明,包含影响目录、目标对象、失败停点和建议确认方式。

语言支持

中文优先,适合中英文混合操作说明

包名称

Approval Watchtower Pack

Representative scenarios

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

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

在执行文件批量改动前,先列出将改哪些目录、预计改几类文件。
在 Shell 动作前,先写清工作目录、命令目的和失败停点。
在外部服务写入前,先提示目标账号、目标对象和不可逆影响。

Prerequisites

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

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

需要先把动作类型分成读取、写入、外部发送和系统变更几类。
需要执行链路能暴露工作目录、目标资源和停点信息。
操作者愿意在批准前花几秒读完关键信息,而不是默认一键放行。

Safety controls

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

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

每个高风险动作都单独说明影响范围,不把多步动作偷包成一次批准。
说明里必须包含目标目录、目标账号或目标资源,而不是只写“常规操作”。
如果动作本身不合理,批准链路必须允许直接拒绝并停下。

Boundaries

这类场景不适合直接复刻

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

本来就不该执行的高风险动作。
想通过更漂亮的批准文案掩盖真实风险的场景。
执行链路本身拿不到影响范围,导致批准说明仍然太模糊。
多个高风险动作被错误打包成一次确认,削弱了停点意义。

Reproduction steps

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

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

先从单条写入或单条命令的批准说明开始验证。
补齐影响目录、目标对象和失败停点字段。
再覆盖外部提交或多步执行场景,确认仍然能逐步停下。
最后把说明模板整理成可复刻分享包。

Package contents

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

适合需要把高风险动作讲明白,再决定是否继续的维护场景。 需要手动调整的部分:需要人工定义风险分类,并根据团队习惯调整批准文案粒度。

manifest.yaml:声明涉及写入、命令和外部动作的风险标签。
soul.md:定义批准说明必须优先表达影响范围而不是执行速度。
skills.md:说明 Approval Gatekeeper、Shell Guard 与 Session Router 的职责分工。
examples.md / safety.md:给出真实待批案例和拒绝/停下规则。

Author and maintenance

作者与维护信息

用于演示安全治理类 Showcase 应如何同时展示结果、边界和复刻路径。

作者

agent101 editorial sample

反馈路径

通过站内审核与维护反馈继续收敛模板。

维护状态

样板维护中

最后验证

2026-03-15

Excluded content

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

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

不包含任何绕过批准的自动放行配置。
不包含真实生产环境凭证。
不包含未经脱敏的高风险操作日志原文。