KISS My Agent 主视觉：复杂的 Agent 路径汇聚为一个清晰结果

KISS My Agent

Keep It Simple, Scientist. Less ceremony. More science.

减少 Codex 的过度设计和过度防御。先做出能运行、能验证的科研 MVP，让错误尽早暴露，再根据真实结果快速迭代。

KISS My Agent 是什么

KISS My Agent 是一个面向科研和探索性工程的开源 Codex 插件。它给 Codex 一套简单的工作原则：围绕当前目标或假设，先做出能运行、能验证的最小版本，再根据真实结果决定继续、修改还是停止。

它以目标为导向，不以过程或工作量为导向：改了多少文件、调用多少 Agent、跑了多少检查、流程走到哪一步，都不能替代“当前问题是否真正得到回答”。

它解决的两个核心问题

问题	是什么	常见结果
过度设计	当前假设还没有验证，就先按成熟产品去建设，为未来可能性增加现在没人使用的抽象、配置、迁移或平台	一个实验变成大型系统，反馈变慢，改动范围和新 bug 一起增加
过度防御	不让错误自然暴露，而是叠加校验、重试、回退、异常捕获或门禁，甚至把失败包装成成功	真正原因被隐藏，错误结果看起来“正常”，下一轮迭代失去可靠起点

范围越做越大、没有修到实际生效的代码、把测试通过当成目标，或让多个 Agent 在同一件事上相互冲突，通常都是这两种倾向带来的后果。

为什么 Codex 容易产生这些问题

Codex 倾向产出“看起来完整、稳健、成功”的答案。用户又常只要求“全面”“稳健”或“生产级”，没有把当前假设、最小目标和停止条件说清；于是增加框架、校验、重试或回退既容易生成，也容易表现为工作有进展。同时，Codex 往往会尽量避免给出明显失败，错误就可能被捕获、绕开或包装成可用结果。成熟产品在有真实需求和风险时当然可能需要完整架构与防护，但科研早期过早加入这些东西，会延长反馈周期，也会遮住最有价值的信号：这次真实运行为什么成功或失败。

KISS 怎样推动科研闭环

目标或假设 → 最小可运行、可验证版本 → 真实运行 → 暴露成功或失败 → 下一轮迭代或停止

先把这一轮要回答的问题和最小成功条件说清，不让实现过程悄悄改写目标。
只做让假设能够运行和验证的必要部分；先得到科研 MVP，再决定是否值得产品化。
尽快在真实路径上运行。允许低成本、可恢复的试错，让错误带着原始原因尽早出现，而不是用回退或空结果遮住它。
根据真实结果行动：修复最先暴露的问题进入下一轮；假设已回答或目标已满足时就停止，不用更多流程和改动证明“做过很多工作”。

多 Agent 只是可选的加速手段：任务确实能独立拆分时才使用，共享文件、设备或输出仍由一个明确负责人操作。这里的“不怕犯错”只指低成本、可恢复的试错；认证、权限、不可逆操作和其他高风险安全边界不能删除或绕过。

它适合你吗？

比较适合	不是它要解决的场景
科研原型、算法验证、实验工具和其他需要尽快完成 MVP 的工作	已经有稳定需求、且确实需要完整兼容、迁移、审计或安全体系的成熟产品环节
方案还不确定，需要用真实运行结果快速探索	失败代价不可恢复，必须先完成严格安全论证的高风险操作
调试隐藏错误，或让 Codex 停止为假想未来提前产品化	需要确定性安全强制、形式化验证、通用编排平台或非 Codex Host 支持

KISS 不保证第一次就做对；它追求的是更快得到可信结果，再据此做对下一步。

快速开始

已在完成认证且支持 Plugin 的 Codex CLI 0.152.1 和 0.153.0 上测试。还需要 git 与 GitHub 网络访问；其他 Codex 版本未验证。普通用户不需要 Python、Node.js、Docker 或其他语言运行时。

确认当前 Codex build 支持 Plugins：

codex --version
codex plugin --help

安装 Plugin：

codex plugin marketplace add AoiOTA/Kiss-My-Agent
codex plugin add kiss-my-agent@kiss-my-agent

此时只是安装了 Plugin；新的 Codex 会话可以发现它提供的两个 Skills，但项目规则和角色还没有配置。

在复杂项目中打开一个新的 Codex 会话。在已测试的 Codex CLI 0.152.1 baseline 上，先输入 $，再在 Skill picker 中选择 kiss-my-agent-setup (kiss-my-agent)。Picker 会插入一个结构化 Skill reference；继续补充 setup 请求并提交 prompt 后，才会调用该 Skill。如果直接粘贴文字，请使用下面完整限定的命令：

$kiss-my-agent:kiss-my-agent-setup set up this project with the default team

Project setup 会写入持久项目规则和角色配置。通过 Codex 界面信任该项目，再打开一个新会话；只有这个可信的新会话才会加载项目规则和角色。之后像平常一样提任务：

Find the cause of this failing parser test, make the smallest correct fix, and run the affected tests.

Setup check 是可选的。它只检查配置文件，不能证明 Agents 的真实行为：

$kiss-my-agent:kiss-my-agent-setup check this project

默认 setup 管理项目中的三个位置：

.codex/config.toml：补齐缺失的 Astra/high、多代理及实验上下文默认值；保留用户值，只更新配置中说明的准确历史 pair。
.codex/agents/：可编辑的员工角色文件
AGENTS.md：带标记的 KISS instructions 区块

它会保留已有用户配置，默认不需要选择。Fresh setup 会创建每个缺失的 starter role；任何已经存在的角色都归用户所有，永不覆盖。Setup 后删除的角色会继续保持缺失。只有目标位置或冲突不明确时才会询问。如果 setup 停止，请按报告中的原因和准确路径处理，不要覆盖文件；详见安装。

Plugin 没有后台服务；真正加载配置和启动 Agents 的是 Codex Host。

默认公司班底

Master 就是你现在正在对话的主 Codex Agent，也就是主会话，不是另一个员工角色。

成员	职责	默认配置
你 / Owner	决定目标、架构、验收标准、非目标和停止点	人来决策
Master	规划、分配工作、解决冲突、判断证据并汇总	默认 `gpt-6-astra` / `high`
`kiss_explorer`	调查并报告事实，不编辑文件	`gpt-6-astra` / `medium`
`kiss_coder`	实现分配的改动并运行相关检查	`gpt-6-astra` / `medium`
`kiss_reviewer`	独立检查结果，不编辑文件	`gpt-6-astra` / `medium`

Setup 为缺失的 Master 字段补入 gpt-6-astra / high；当前 seed roles 显式使用 gpt-6-astra / medium。已有用户显式选择保持不变。Role wizard 只修改选定角色。静态检查不能证明 Host 有效配置，应在新任务中验证。 Master 通常直接分配任务，可以启动同一角色的多个实例，每个共享事项由一个 Agent 负责，大型独立子系统可以临时设一个 lead。

如果 delegation 被禁用、不可用或没有合适角色，Master 可在已有授权和自身能力内继续工作，无需为人员配置另设审批。用户明确要求的独立检查、特定角色或真实能力缺口仍须报告，不能把直接执行冒充为满足这些要求。

公司类比只用于解释职责，不是固定流程或游戏系统。

Setup 默认补入 features.context_management.experimental_mode = true，保留用户显式 false。Ubuntu 24.04 的 ChatGPT Pro 客户端无需 API key；更新插件后，在原 scope 运行 setup，显式 configure 选定的已有角色，再新建可信 Astra 任务验证加载。

只有想修改模型设置时才看这里

Setup 为缺失的 Master 字段补入 gpt-6-astra / high；当前 seed roles 显式使用 gpt-6-astra / medium。已有用户显式选择保持不变。Role wizard 只修改选定角色。静态检查不能证明 Host 有效配置，应在新任务中验证。

对子 Agent，Codex 会先解析显式 spawn 设置，再解析对应的 [agents] 默认值，最后解析 parent；role 文件中的显式值是最终 override。当前 starter roles 显式设置 Astra / medium，作为最后一层 override。

Plugin update 和 setup 会保留每个已有角色。要显式把三个已有 KISS roles 设置为 gpt-6-astra / medium，请使用下面准确的限定 prompt：

$kiss-my-agent:kiss-my-agent-setup configure agents in this project: for kiss_explorer, kiss_coder, and kiss_reviewer, set model to gpt-6-astra and model_reasoning_effort to medium

通过 Codex 配置已有员工角色：

$kiss-my-agent:kiss-my-agent-setup configure agents for this project

Role wizard 只修改已有角色的 model、reasoning effort 和 permission mode，不修改 Master。全局角色、准确优先级、权限与旧 setup 迁移细节见配置。

立即更新

第一条命令立即更新，第二条只核验安装结果：

codex plugin marketplace upgrade kiss-my-agent
codex plugin list --marketplace kiss-my-agent

应看到 kiss-my-agent@kiss-my-agent、状态 installed, enabled，版本与本 README 顶部的当前 release badge 一致。更新后启动新会话。Host refresh 只更新 Plugin 包，不会修改 project/global 配置、instructions 或角色文件。

KISS My Agent 自身没有 updater。Codex 可能在启动时刷新未固定版本的 Git marketplace。已有角色不会被自动更新或判定版本；如需采用新版 model 或 effort，请使用 role wizard 或手工编辑其 TOML。固定版本与回退细节见安装。

局限

已在 Codex CLI 0.152.1 和 0.153.0 上测试；其他版本和其他 Host 未验证。
Instructions 可以改善工作上下文，但不能保证模型服从、结果正确或通过验收。
成功委派或测试通过，不能证明用户的产品目标或科研目标已经实现。
当前 release 没有 MCP 服务、独立 UI、遥测、评测平台或 LTS 承诺。
它不能替代认证、权限、管理员策略、项目安全规则或专业领域判断。

详细文档

完整文档站点提供英文版与简体中文版。

License

MIT