通过唯一入口
@AgentTools使用 Agent/Codex 诊断与跨会话本机环境说明、AGENTS.md策略模板、任务上下文梳理和 Codex Skill 清单。
AgentTools 帮助发现 AI 编码代理环境中的网络、编码、换行、路径与 Codex 连接风险，也能把经过筛选的本机环境信息保存在一个用户自有文件中，供后续新会话读取。它还可以重建任务上下文并列出当前 Codex 实际发现的全部 Skill。这些功能封装在一个只接受显式调用的 Skill 中；安装本身不会触发任何功能。
| 功能 | 解决的问题 | 平台 | 详细说明 |
|---|---|---|---|
| Agent/Codex 诊断 | 常见会话环境问题、本机环境延续、PowerShell/Conda、编码、Git 行尾、代理、TUN 与 Codex 重连信号 | 诊断以 Windows 为主；本机说明支持 Windows、Ubuntu/Linux、macOS | 本机环境说明 · 仓库与终端诊断 · 连接诊断 |
| AGENTS.md 策略模板 | 全局、Windows 增强与仓库级执行规则 | Windows、macOS、Linux | 查看文档 |
| 任务上下文梳理与续接 | 当前任务主线、代码或执行流程、关键做法、有效状态、未决分支与下一步 | Windows、macOS、Linux | 查看文档 |
| Codex Skill 清单 | 全部 Skill 的启用状态、调用模式、语法、用途与 README 位置 | Windows、macOS、Linux | 查看文档 |
安装仓库中的插件：
codex plugin marketplace add ksukie/AgentTools
codex plugin add agent-tools@agenttools
旧版的 Marketplace 和插件身份不会自动变成新名称。已安装旧版的用户应先移除旧身份，再重新添加：
codex plugin remove agent-policy@agentguard
codex plugin marketplace remove agentguard
codex plugin marketplace add ksukie/AgentTools
codex plugin add agent-tools@agenttools
安装后开始一个新会话。在支持 Skill 选择器的界面使用 @AgentTools；文本客户端使用带插件命名空间的 $agent-tools:agent-tools。
@AgentTools 检查当前仓库
@AgentTools 排查 VS Code 终端启动报错
@AgentTools 排查最近 1 小时的 Codex 重连
@AgentTools 查找当前上下文中的常见环境问题并总结原因
@AgentTools 初始化我的本机环境说明
@AgentTools 展示全局 AGENTS.md 模板
@AgentTools 总结当前任务上下文
@AgentTools 列出当前 Codex 的全部 Skill
上下文梳理支持按主题、任务、组件、阶段或状态限定本次范围。明确限定范围时，只合并该范围内的既有规则、决定与证据；仅提到或要求重点说明某一方面，不会自动变成排他范围。未限定时，仍按原有规则梳理完整的当前有效上下文。
Skill 清单功能只保留上面这一条公开示例，但它不是固定口令：凡是显式调用 AgentTools 后提出的本地 Skill 发现、查找、检查、审计或排查请求，都会进入同一条运行时清单路线。
空调用会展示固定能力菜单；任务明确时会直接执行，不会要求重复选择。
首次显式调用 @AgentTools 初始化我的本机环境说明 时，AgentTools 先进行只读检测并展示完整预览。只有用户确认后，它才会创建 $CODEX_HOME/agent-tools/local-environment.md，并在当前真正生效的全局 AGENTS.override.md 或 AGENTS.md 中加入一个有边界标记的短指针。默认 CODEX_HOME 为 ~/.codex。
用户以后只需维护 local-environment.md 这一份文件。AgentTools 主线升级不会自动改它；显式更新时也只替换受管设备快照，保留用户补充与已记录问题。相同问题用稳定的问题 ID 合并，固定包含状态、适用设备、问题、证据、原因、方案、验证方式和来源。详见本机环境说明。
在安装后的首次显式调用中，如果尚未配置本机环境说明，AgentTools 会在完成主要任务后给出一次可选初始化提示；状态检查只读，不会自动进入预览或创建文件。
只有当前消息显式调用 @AgentTools（或文本客户端中的 $agent-tools:agent-tools）时，Skill 才会运行。它不会因为已经安装、请求内容碰巧匹配、上一轮调用过或会话很长而隐式启动，也不会自动诊断、总结上下文或扫描 Skill。
用户确认安装的全局指针只让新会话读取本机环境说明，不会调用 AgentTools，也不会自动诊断、写文件或发送数据。全局 AGENTS 指令链在会话启动时构建，因此首次初始化或更新指针后需要开启新会话。
更新检查同样只在显式调用后运行。插件没有全局消息提交 Hook，也没有安装后常驻的后台任务。
AgentTools 会在显式调用后进行低频版本检查：正常情况下每 72 小时最多联网一次，失败后 12 小时重试，发现新版本后每 36 小时最多提醒一次。检查失败保持静默，更新提醒只在主要任务完成后显示。
它不会自动拉取、安装或覆盖文件，也不会在插件升级时触碰用户的 local-environment.md。更新插件：
codex plugin marketplace upgrade agenttools
codex plugin remove agent-tools@agenttools
codex plugin add agent-tools@agenttools
更新后开始一个新会话。设置 AGENT_TOOLS_UPDATE_CHECK=0 可关闭更新检查。
本仓库没有第三方运行时依赖。提交变更前运行：
py -3 -B -m unittest discover -s tests -p 'test_*.py' -v
pwsh -NoProfile -File .\tests\doctor-internal.tests.ps1
powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\tests\doctor-internal.tests.ps1
git diff --checkCI 会在 Windows 和 Linux 的 Python 3.9 / 3.14，以及 PowerShell 7 / Windows PowerShell 5.1 上执行相应测试。正式发布前还需按发布清单同步全部版本来源并创建 Git tag。
默认不上传源代码，不读取密钥或 auth.json，不修改注册表、系统代理、TUN、路由、Git 或 Codex 配置。唯一的配置写入例外是用户显式要求本机环境管理、查看预览并确认后：只写用户自有的 local-environment.md 和全局 AGENTS 中的 AgentTools 托管指针。代理检测只保存“哪些变量已配置”和是否存在不一致，不保存代理地址、主机或凭据。Skill 清单只读取 Codex 运行时返回的公开元数据及本地调用策略，并只从工作区外的绝对 PATH 目录解析 Codex CLI；更新检查只读取固定的 GitHub release.json，并仅在插件数据或用户状态目录写入自己的节流状态和并发锁。