让 AI 在不丢安全边界和工作习惯的前提下，审计、瘦身和重建 AGENTS.md、CLAUDE.md、GEMINI.md。
它是一套给 LLM 使用的纯提示词方法，不是自动执行工具。
Agent Skill 可以先理解成“AI 在特定任务中按需读取的一份工作说明”；AGENTS.md、CLAUDE.md、GEMINI.md 则通常是长期或项目级的协作说明。
先弄清旧规则保护了什么，再决定保留、迁移、改写还是删除。
A prompt-only Agent Skill for simplifying AI-agent instructions without silently losing behavior.
如果你的编程助手能够运行本地命令并管理 Skill 目录，把下面这句话发给它：
请安装这个 Agent Skill：https://github.com/wuxiiing/agent-guide
安装后告诉我真实安装路径，确认客户端已经发现 agent-guide，并说明怎样调用。不要只口头说安装成功。
不确定客户端是否支持？可以跳过安装，直接打开 SKILL.md 并把内容复制给 AI。
这条安装命令需要 Node.js 18 或更高版本，并会通过 skills CLI 获取和安装 Skill：
npx skills add wuxiiing/agent-guide -g-g 表示作为个人通用 Skill 安装。如果只想让它在当前项目可用，请先进入目标项目目录，再去掉 -g 运行。按提示选择你正在使用的 AI 工具，安装完成后直接说：
请用 agent-guide 无损精简当前项目的 AGENTS.md。
先不要修改文件。先识别旧版原本想保留的能力，逐条说明应该保留、迁移、改写还是删除。
最后给出精简草案，并检查有没有丢失原来的功能和安全边界。
安装完成后的 agent-guide 本体只有 Markdown：不需要 API Key，不需要 MCP，不含可执行脚本，也没有后台服务。
通常会，但不一定每次都做完整。
直接让 AI“精简一下 AGENTS.md”，它可能只追求文字变短，也可能忘记旧规则为什么存在，悄悄删掉权限边界、验证步骤或工作习惯。
agent-guide 不给模型增加新能力。它只是把最容易漏掉的步骤固定下来：
flowchart LR
A[确认范围] --> B[识别每条旧规则的原意]
B --> C[逐条决定去向]
C --> D[生成更薄的草案]
D --> E[检查能力是否丢失]
如果你只想让 AI 随手改短，直接说一句话就够了。
如果你希望不同模型、不同窗口都尽量按照同一种方法工作，这个 Skill 才有价值。
下面假设用户已经确认安装了名为 edit-article 的写作 Skill。它只是示例中的已有工具，不是安装 agent-guide 的依赖。
整理前：
# AGENTS.md
- 默认使用中文回答。
- 像资深工程师一样工作。
- 遇到问题要认真思考。
- 始终遵循最佳实践。
- 输出要专业、清晰。
- 不要未经同意修改全局配置。
- 修复 bug 前先复现，修改后运行测试。
- 写文章前先整理结构。
- 写完文章后逐段检查表达和逻辑。
- 只修改当前任务需要的内容。
- 完成后汇报改动、验证和风险。整理后：
# AGENTS.md
- 默认使用中文回答。
- 修改全局配置或长期规则前，先给出 diff 并等待确认。
- 修复 bug 时先复现；修改后运行最相关的测试。
- 只修改当前任务需要的内容，不重构无关代码。
- 写作任务使用 `edit-article` Skill。
- 完成后汇报改动、实际验证和未验证风险。这次整理：
- 保留了语言、权限、调试、修改范围和汇报要求；
- 把重复的写作流程移动到了按需加载的 Skill；
- 删除了“认真思考”“保持专业”“遵循最佳实践”等无法检查的空话；
- 从 11 条常驻规则减少到 6 条，没有静默删除关键能力。
这里追求的不是越短越好，而是每一条留下来的规则都有明确作用。
完整示例见 examples/。
- 审计现有 Agent 指令；
- 找出重复、空泛、冲突或放错位置的内容；
- 为每条旧规则建立去向记录；
- 生成更薄、更具体的草案；
- 对比新旧版本，检查能力是否丢失；
- 在必要信息不完整时，引导你重建个人 Agent 指令。
- 不会自动修改你的全局配置；
- 不会替你执行或测试 Hook、MCP、插件和权限系统；
- 不能保证模型绝对服从文字规则；
- 不能代替 Hook、CI 和权限系统进行强制约束；
- 不负责修 bug、写业务代码或部署项目。
它可以判断“某条文字规则更适合交给 Hook 强制，或者只保留一条 MCP 调用路由”，但这不等于它检查过对应系统是否真的配置正确。
用 agent-guide 审计这个文件。
不要直接修改。逐条说明原意、建议去向和删除风险。
用 agent-guide 精简这份 Agent 指令。
每条旧规则都必须有明确去向；给出新版草案和能力回归检查。
用 agent-guide 帮我重建个人 Agent 指令。
先了解我的主要工作、安全边界和长期偏好。
只问真正会改变设计的问题，再给出草案。
如果你的 AI 工具暂时不支持 Agent Skills：
- 打开
SKILL.md； - 把内容复制给 AI；
- 再发送上面的任意一个使用提示词。
区别只是它不会被工具自动识别和按需加载，方法本身仍然可以使用。
| 内容 | 建议位置 |
|---|---|
| 几乎每次都要遵守的稳定边界 | 全局或当前层级的持久指令 |
| 只对一个项目成立的命令、架构和禁改路径 | 项目指令或项目文档 |
| 只在特定任务出现的多步流程 | Skill 或按需参考资料 |
| 会变化、非权威的个人偏好和经验 | Memory |
| 必须可靠阻止或自动执行的行为 | Hook、权限、CI、设置或脚本 |
| 外部系统中的实时事实 | 保留简短调用路由，通过对应能力查询真实来源 |
| 教程、背景、案例、来源说明 | README、文档或 references |
| “认真、专业、最佳实践”一类空话 | 删除，或改写成可验证动作 |
不同工具的指令加载和覆盖规则并不相同。遇到优先级冲突时，agent-guide 会先确认目标平台，不能用一张自创的通用优先级表代替官方规则。
SKILL.md：提供给 AI 的核心提示词方法；examples/：整理前、整理后和逐条对比；templates/：可复用的审计与重建模板；references/：判断标准、术语和参考来源；article.md：适合人类阅读的长文版本。
本项目遵循开放的 Agent Skills 规范。是否能被自动发现、怎样调用，取决于你使用的客户端。
Skill 本体只有 Markdown，不依赖特定模型、操作系统、MCP 或运行时。即使客户端不支持自动安装，也可以直接复制 SKILL.md 使用。
核心方法来自真实的 Agent 指令维护经验，并参考：
- OpenAI：Custom instructions with AGENTS.md
- OpenAI：Harness engineering
- Anthropic：How Claude remembers your project
- Gemini CLI：Provide context with GEMINI.md files
- Agent Skills Specification
社区文章和具体归属说明见 references/source-notes.md。本项目总结和转换公开资料，不复制原文，也不替代原文阅读。