Agented
专为LLM设计的状态化文本编辑器
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Agented。 它的用途是：专为LLM设计的状态化文本编辑器 完整的 Skill 内容见：https://321skill.com/skills/agented/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'用ae打开src/main.go，获取当前状态令牌，然后将第10-15行替换为新的函数实现，最后保存。' 它会执行 ae open src/main.go，然后执行 ae s src/main.go -r 10:15 -w "func newImpl() { ... }" -x <token>，最后用 ae w 提交。
介绍
这个Skill解决了AI编码代理在编辑代码时缺乏持久历史、难以安全并发操作的问题。在实际开发中，AI代理需要多次修改同一文件，但普通编辑器没有状态管理，导致修改冲突、丢失上下文。Agented通过SQLite持久化工作区状态和版本化的undo树，让每次编辑都可追溯、可回滚。
使用方式很简单，你只需要在终端中通过ae命令操作文件。首次使用ae open <path>告诉编辑器你要编辑哪个文件，它会返回文件ID、行数、状态令牌等信息。之后就可以通过ae s foo.go -r 12:14 -w "..." -x <token>进行替换，或使用ae i、ae w等命令。所有操作都通过--expect参数传递状态令牌，确保并发安全。
它非常适合需要多步骤、多文件编辑的AI编码代理。尤其是那些需要安全重构、保留完整历史记录的团队，例如在代码审查、Bug修复、大型重构场景中。人类开发者也能使用，但核心设计目标是为AI代理提供可靠的文件编辑基础设施。
建议在涉及多个文件、需要事务性提交的场景中统一使用此工具。需要注意的是，它不适用于二进制文件编辑，也不适合单次快速修改（直接使用内置编辑器更高效）。另外，安装依赖Homebrew，需要macOS或Linux系统。
常见问题
如何安装Agented？
执行 brew tap frane/tap && brew install agented，然后即可使用 ae 命令。
state_token 是什么？为什么需要它？
state_token 是每次读取文件时返回的版本标识。写入时通过 --expect 参数传递，如果文件已被其他进程修改，写入会失败并返回新内容，避免冲突。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agented/raw/index.md 读取 Agented 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agented/raw/index.md（查看排版版本）