工具脚本术语：任务、管道与幂等

工具脚本的价值在于把重复动作固定下来，但脚本写多了会出现另一种混乱：同一个词在不同脚本里含义不同。任务、管道、参数、幂等这几个术语最容易被含糊使用，直接影响脚本能否被他人安全复用。

一、核心术语解释
任务指脚本要完成的一件独立事情，应有明确的输入、输出和成功判据。管道指多个任务按顺序衔接，前一步的输出作为后一步的输入，衔接处需要约定格式。参数指调用时传入的可变配置，分为必填与可选，应有默认值和取值范围说明。幂等指同一操作执行一次与执行多次的结果一致，是脚本能否被反复调用的关键属性。四者共同决定脚本的可用性：任务定义清楚才能组合，管道约定清楚才能串联，参数设计清楚才能复用，幂等成立才能重跑。

二、编写步骤
第一步把要解决的问题拆成若干独立任务，每个任务只做一件事。第二步为每个任务定义输入、输出与失败表现。第三步设计参数，必填项缺失时立即报错，可选项给出安全默认值。第四步处理管道衔接，统一中间结果的格式与位置。第五步让每个任务尽量幂等：先检查现状再决定是否执行，避免重复追加。第六步加入执行日志，记录开始、结束与关键判断。

三、适用场景与注意事项
批量整理文件、定时检查配置、生成重复性文本、清理临时资源，都适合用脚本固化。注意事项集中在边界：不要在脚本里写死路径和账号信息；不要假设目录一定存在；不要在失败后继续执行后续任务；不要静默吞掉错误。管道越长，越要在每一步保留可检查的中间结果。参数越多，越要提供示例调用。

四、复用检查清单
逐项确认：任务是否单一职责；输入输出是否写明；必填参数缺失是否报错；默认值是否安全；重复执行是否产生重复结果；失败是否中止并留下线索；日志是否足以定位问题。这七项过一遍，脚本才具备交给他人使用的条件。

术语统一后，脚本之间的组合会变得自然：任务可替换，管道可重排，参数可复用，幂等让重跑不再可怕。写脚本的人少解释，用脚本的人少猜测，这才是工具化的意义。