关于 persistent-side-effects
Persistent Side Effects 是一项 Agent 技能,界定已接受的实现请求涵盖哪些操作,以及哪些操作需要单独批准。它帮助 Agent 控制变更范围,并区分必要的本地验证与外部或破坏性操作。
主要功能
- 01界定实现授权的范围
- 02列明请求涵盖的变更
- 03要求敏感操作取得批准
- 04按范围和影响核对授权
- 05设定副作用完成标准
适用场景
- 01判断实现步骤是否需要批准
- 02使代码变更遵循已接受的计划
- 03在破坏性或外部操作前核查权限
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ liaoann/ skills --skill persistent-side-effects安装后在 Claude Code 中输入/persistent-side-effects确认已加载。
详细介绍
持续性副作用
已接受的实现请求或计划授权在其范围内进行必要更改,而非授权 Agent 可以采取的所有操作。仅提出问题、进行调查或制定计划,并不意味着授权实施。
实现审批涵盖的操作
无需针对每个文件或命令再次询问:
- 创建或编辑实现已接受结果所需的源文件和测试。
- 必要时,使用项目预期的工具更新因这些更改而需要更新的生成产物。
- 运行已知安全的本地验证,并在同一范围内修复由请求的更改导致的失败。若已知环境与生产环境隔离,则一次性测试夹具和预期的构建/测试输出也包括在内。
- 在
/agentic-change-governance下进行必要的本地支持性编辑。
计划不必列出确切的文件名。授权取决于已接受的结果和边界;测试要求进行某项更改,本身并不构成授权。运行命令前,必须先确认未知的测试隔离情况、生产环境访问权限或命令的破坏性行为。
需要明确审批的操作
除非已针对当前任务明确批准,否则以下操作需要审批:
- 暂存、提交、创建或切换分支、推送、发布或部署。
- 删除或移动现有用户可见文件、覆盖无关工作、删除数据,或移除容器或卷等破坏性操作。
- 更改已接受范围之外的内容,或在
/agentic-change-governance下作出新的设计决策。 - 创建持久化环境,或更改共享/外部系统。
- 创建交付物不需要的临时、规划、笔记或便利性产物。默认情况下,将这些内容保留在对话中。
对一项操作的批准不代表对其他操作的批准:实施不意味着可以提交,创建容器也不意味着有权将其移除。现有的测试框架限制和用户明确的禁止要求仍然适用。
审批检查
明确指出要执行的操作、受影响的资源,以及授权该操作的请求或计划。只有在操作超出授权范围且缺少相应决定时才询问;对于已经明确批准的操作,不要再次询问。如果范围或影响不明确,先进行澄清。
完成标准
每项副作用都必须是已接受的实现范围内的必要操作并符合上述规定,或在执行前获得明确批准。不得基于推断出的概括性授权开展无关工作,也不得更改受保护资源或外部系统。
评论
支持 Markdown