AI 能力包的边界：不是安装命令，而是可回滚的宿主行为

如果一个 AI coding agent 的 powerup 会改变宿主行为，那么它就不能只用“安装成功”来判断可用。

更重要的问题是：

它会写入哪些配置？
它改变哪个宿主？
是否能回滚？
失败后如何停？
哪些能力还没有真实验证？

这正是 Doramagic 能力资源包要处理的边界问题。

资源包不是仓库摘要

以 agent-powerups 为例，普通仓库摘要可能只会写：

这是一个给 AI coding agents 使用的 powerup 项目。

但这对真正使用不够。

一个完整 Doramagic 资源包应该包含：

source map
-> host instructions
-> prompt preview
-> pitfall log
-> install / rollback check
-> boundary risk card
-> human manual
-> test log
-> feedback path

这套结构的作用是让 Agent 在改动宿主配置前先判断风险。

关键边界：安装入口、配置目录、回滚路径

该 pack 里有两个需要被认真处理的点：

1. 仓库名和安装入口可能不一致。
2. powerup 可能影响 Claude、Cursor、Codex、Gemini、OpenCode 等宿主配置。

这不是一个“注意事项”就能解决的问题。

它应该变成 Agent 的执行边界：

1. 先说明 upstream repo 和 install entry。
2. 列出会读取或写入的本地配置目录。
3. 在执行前写出 rollback plan。
4. 先做 smoke check。
5. 如果不能回滚，不扩大权限。
6. 如果 host 行为变化不可解释，停止并要求人工确认。

为什么博客园适合写这个

博客园更适合长期技术笔记，而不是短促公告。

这篇文章的重点不是推广某个 pack，而是记录一个判断原则：

只要 AI 能力会影响宿主行为，就必须把 install、permission、load order、rollback 和 test log 放进同一个资产里。

否则，Agent 很容易把“我安装了”误写成“我拥有了这个能力”。

非官方声明

本文涉及的资源包由 Doramagic 独立整理，不是 yeaight7/agent-powerups 的官方产物，也不代表上游项目立场。

链接

• 资源包：https://github.com/tangweigang-jpg/doramagic-agent-powerups-pack
• 上游项目：https://github.com/yeaight7/agent-powerups