Agented
专为LLM设计的带状态文本编辑器
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Agented。 它的用途是：专为LLM设计的带状态文本编辑器 完整的 Skill 内容见：https://321skill.com/skills/agented-x-8/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用ae打开src/main.go，获取状态令牌，然后将第20-22行替换为新的错误处理逻辑，传入expect token'。AI会执行`ae open src/main.go`获取初始状态，然后调用`ae s src/main.go -r 20:22 -w "if err != nil { return err }" -x <token>`，并返回新token供后续操作使用。
介绍
这个Skill解决了AI编码代理在编辑文件时缺乏历史记录和并发控制的问题。在实际开发中，AI代理需要多步修改代码，但传统的“先读后写”模式容易因文件被其他进程修改而导致冲突或丢失改动。Agented通过状态令牌（state_token）和事务机制，确保每次写入都是基于最新状态的，冲突时自动拒绝并返回新状态，让AI可以安全地重试。
使用方式很简单，你只需要安装ae二进制后，在终端中通过命令行动词操作。首次接触文件时使用ae open <path>获取状态令牌，后续的读取、替换、插入等操作都带上--expect <token>参数。所有编辑都会持久化到SQLite工作区中，形成一个可回溯的撤销树，支持分支跳转。对于多行内容，可以通过标准输入管道传递，避免复杂的引号转义。
它非常适合需要多步骤、跨文件编辑的AI编码代理。尤其是那些需要处理复杂重构、事务性多文件修改（如重命名变量、迁移API调用）的场景，或者希望保留完整编辑历史以便后续回溯的团队。对于单次一次性修改，或者不需要历史记录的场景，可以直接使用平台内置的编辑器。
建议在开始复杂重构任务时统一使用此工具，并启用concurrency.require_expect: writes配置以强制检查。需要注意的是，它只支持纯文本文件，不支持二进制文件；同时要求安装Go运行时才能自编译，或者通过Homebrew安装预编译二进制。
核心特点
与Git的版本控制不同，Agented专注于文件级别的编辑历史，粒度更细（每次插入/替换都是一个版本），且支持事务回滚和并发冲突检测。与普通编辑器（如vim）不同，它专为AI代理设计，所有操作通过命令行动词完成，返回结构化的状态令牌，便于程序化交互。
注意事项
仅支持文本文件，不支持二进制；依赖SQLite作为状态存储；需要安装ae二进制（通过Homebrew或Go编译）；版本要求1.4.0+；在多AI代理并发编辑时需严格使用`--expect`参数。
常见问题
如何安装Agented？
在macOS上通过Homebrew安装：`brew tap frane/tap && brew install agented`。其他系统需要从源码编译：`git clone https://github.com/frane/agented && cd agented && make install`。
如何开始一个新文件编辑？
使用`ae open <filename>`首次打开文件，返回状态令牌。然后可以用`ae s <filename> -r <range> -w <newtext> -x <token>`进行替换。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agented-x-8/raw/index.md 读取 Agented 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agented-x-8/raw/index.md（查看排版版本）