把四类重复判断整理成可安装的 Codex Agents

2026-11-06：默认两个日常入口

当前源码与安装说明 把日常使用收敛到两个入口：_manuel 帮助理解目标、检查判断并迈出下一步；_mantou 帮助把需求说清楚。

运行默认安装器会安装这两个入口，以及 manuel 所需的五本书方法资料。研究方法、用户选择、改变过程和研究落地等旧书籍顾问仍保留为兼容入口；事实核验与投资研究也可按需安装。使用 -All 才安装全部八个角色，默认更新不会自动删除已经安装的旧角色。

截至这次同步，GitHub 最新正式 Release 仍为历史发布包 v0.1.1 。要试用两个入口的新行为，请按当前源码 README 安装。旧发布包、当前源码和真实任务中的效果，是三件需要分别核对的事。

11 月 3 日，本案例曾补记源码扩展到八位 Agent；这次调整的是默认使用入口。下方四位 Agent 与 v0.1.1 的说明保留为早期阶段记录。新版整合和调研流程仍在试用，已有的安装检查与旧版回答记录不能证明新版效果，具体范围见验证状态 。

它可以用来做什么

我现在从两个日常入口开始使用，遇到专项任务时再按需选择其他角色。

如果你想把一个模糊的要求写清楚，可以从 _mantou 开始；如果想弄清真正的目标、比较选择，或检查一段话里的前提和推论，可以试试 _manuel。manuel 按需要使用五本书的方法，也可以结合你授权的笔记理解问题。它对你的理解需要你纠正，不是读心，也没有自动导入聊天记录或后台监控。

manuel 还提供调研与分析学习流程 供试用：围绕具体问题核验来源、检查前提和反证，并学习一个可迁移的方法。实际效果待使用检验，不承诺市场预测准确率。

这些入口提供辅助整理和检查，输出仍需要自己判断。

安装说明与环境要求 在 GitHub 仓库中。使用前需要兼容的 Codex 环境、PowerShell 和可用模型权限。

旧版已有的使用情况

除了我自己，同事和朋友也已经重复使用，主要用于改善提示词，以及发现话术和思路中的漏洞。

目前还没有整理出完整的任务对比，能够展示哪些修改被采用、哪些输出仍需要人工纠正。这些使用情况值得继续记录，但还不足以说明它在不同任务中的效果。

如果你试过，欢迎留下反馈 ：当时想完成什么、哪里有帮助、哪里仍需要自己修改。安装遇到问题，也可以邮件联系我 。分享样例前，请先去掉私人信息。

问题与假设

我经常重复处理四类任务：优化提示词、检查论证、核验事实和审计投资论点。过去每次都要重新解释任务边界、证据标准和禁止事项；提示词越写越长，但不同会话中的执行仍然容易漂移。

这次要验证的假设是：把不同任务拆成职责狭窄的自定义 Agent，再把安装、说明和回归验证一起交付，能否比保存几段提示词更稳定、更容易维护。

Codex 官方文档允许通过独立 TOML 文件定义个人或项目级自定义 Agent，并为每个 Agent 设置名称、用途说明和行为指令。这个仓库是在该机制上制作的个人配置包，不是 OpenAI 官方产品或官方 Agent 集合。

约束与关键决策

早期版本按决策性质拆成四个角色：

• _mantou 只负责澄清和优化提示词，不执行提示词中的任务；
• _manuel 用批判性思考框架检查问题、证据和推论；
• _factbot 区分主张、证据、推论与观点，并检查来源独立性和不确定性；
• _invest 用于长期投资研究与论点审计，但不执行证券交易。

公开边界同样是交付物的一部分：个人 Obsidian 路径和案例索引放在被忽略的本地文件中；仓库不包含私人笔记、真实持仓、密钥，也不包含参考书原文。

本阶段产出与验证

这一阶段发布的版本为 v0.1.1 ，源码与完整说明位于 GitHub 仓库 。这一阶段完成了：

• 四个 Agent 的配置、职责说明和调用示例；
• 支持预览与强制更新的 PowerShell 安装器；
• 不写入真实 Codex 目录的隔离安装回归测试；
• 配置语法、文件完整性、隐私边界和安装结果检查；
• 兼容性、贡献、安全、变更记录与发布流程文档；
• 带版本号和变更说明的 GitHub Release。

完整仓库验证和 Release 压缩包的隔离安装验证均已通过。v0.1.1 还修复了 Windows 环境中找不到 python 命令时的验证问题：脚本会尝试标准的 py -3 启动器。

反证、限制与边界

• 自动化测试证明配置和安装行为符合预期，不证明 Agent 回答一定正确；
• 不同模型、推理强度、Codex 版本和权限设置可能产生不同结果；
• 事实核验和投资研究仍需要检查来源，不能把 Agent 名称当作可信度保证；
• _invest 只支持研究与审计，不提供自动交易能力；
• 官方自定义 Agent 格式仍可能演进，仓库需要持续跟踪兼容性。

复盘与下一步

这一阶段，我把常用的提示词整理成了可以安装、检查和更新的配置包。安装验证已经有记录，实际任务中的表现还需要继续积累。

接下来先记录已有使用中的具体任务、输出问题和人工修正，再根据这些记录决定需要改什么。

关于自定义 Agent 的平台机制和配置边界，以 Codex 官方文档 为准。