Skills

Bo Runbook

为重复性业务任务编写可复用的操作手册,涵盖前置条件、具体步骤、结果验证、失败处理和升级路径。适用于周期性工作或交接操作指引。

Install

npx skills add TencentCloud/Octop --skill bo-runbook -g -a claude-code -y
Repository
TencentCloud/Octop11.4k
Category
Engineering
Updated
3d ago
License
MIT
Context cost
Lightabout 280 tokens
Runs scripts
No, instructions only

What it does

为重复性业务任务编写可复用的操作手册,涵盖前置条件、具体步骤、结果验证、失败处理和升级路径。适用于周期性工作或交接操作指引。

<!-- 已为 Octop 改编。 -->

重复任务操作手册

帮助接手者完成用户指定的一次操作或交接。先确定本次终点:交接完成不等于下游发布、使用或项目全部完成。

终点用于限定手册范围,输出中不另设“本次终点”段重复后面的成功判据。

成稿

只写给定正常步骤、完整成功判据和所问异常。正常步骤保留角色、频率、输入、核验与交付点,必要未知参数就地占位。成功判据只含用户给出的检查;未要求的打开、可读、无乱码、失败留痕和当日上报均标为建议。成功判据包括已知检查和交接,并排除每一种所问异常,不增加未要求的下游操作。例(虚构):总额正确但凭证重复,仍不能正常结案。异常发现环节未知,仅该环节待确认,不能省去异常判断。

总结性成功判据只在一处完整列出;步骤按执行顺序写,但每步仍须就地写明执行所必需的前置条件、判断门槛和保护点,即使这会与总结判据重合。例如,“仅在行数一致时保存”应写在保存步骤中。必要时可简短引用已列判据;不能为避免重复而删掉执行门槛。标题不复述终点,结尾不复制成功判据或重复待确认参数。每个异常分支只写该分支特有的识别、恢复和交接信息。

例(虚构):“助理上传已审核稿,核对预览后交编辑;编辑有发布权。”本次手册的成功是上传确认、预览通过、交编辑,不能要求编辑发布后才算助理交接完成。

异常分支

先列已授处置,再列待定恢复,分开表达:

已知范围分支中的处置
已授暂停、保留原件等直接沿用已授动作,不重新索取该动作权限。
恢复方式或权限未给写“恢复方案待确认:〔具体缺项〕;确认后按获批方案执行”。
用户要求设计恢复方案单列“建议方案”,说明条件与待采纳参数,不冒充现行步骤。

重做、重传、重新导出都是恢复执行。次数或权限未知时,不能在一个分支先写“核实后重新生成”,再靠下一句“次数待确认”补救。正常流程执行一次与异常后重复执行区分开。

例(虚构):“核对清单后归档;核对不一致,重制权限和次数未给。”异常可写“差异及恢复方案待确认(重制权限、次数);确认后按获批方案执行”。不能写“核实后重新制作并核对,再确认重制次数”。必要的新增暂停、留档或升级动作,未获授权时标为建议,接收角色未知就地留缺。

输出前单独走一遍每个分支:已知成功条件全部保留,未定恢复没有提前执行,已给参数前后不矛盾。未知的恢复权限与次数按各分支获批方案的适用范围分别确认,不能因占位名称相同就推定共用授权或次数。最后一个必要分支结束即结束,不追加参数一致性说明;复杂交接才补展开参数、审计及失败推演。编写手册不等于实际操作。

More in Engineering