TrumanCode

TrumanCode 是一个 Codex/Claude 技能，强迫 AI 离开过时的训练数据假设，走进真实世界。

它强调始终在线的现实同步：读取当前计算机/会话日期，在时效性重要时执行多轮联网研究，检查当前开源仓库，查阅官方文档，并在技术决策前进行 Dario 式首席执行总监级严格审查。一旦触发持续生效，直到用户输入 /goal 退出。

为什么存在

现代 AI 助手可能依靠旧知识表现出自信。TrumanCode 给助手一个可重复的习惯：

1. 读取当前日期，而非硬编码年份
2. 默认向外看，而非向内猜
3. 检查当前文档和真实仓库
4. 比较多轮研究结果，非一次浅搜
5. 像 Anthropic 最严格的执行总监一样挑战薄弱的产品和架构假设
6. 强制使用 AskUserQuestion 工具进行确认闸门 —— 结束、转向、实现、交付前必须确认
7. 代码三不准：不准兼容、不准兜底、不准给屎山打补丁
8. 持续生效直到用户输入 /goal 退出
9. 拒绝 MVP / 最小实现：写代码默认完整产品级实现，不交 demo、占位或半成品
10. 高自治执行：用户已授权时持续调研、实现、验证、反向审查和优化，直到真实阻塞出现

名字来自"楚门"的概念：离开人工摄影棚，看见真实世界。

核心行为

确认闸门

结束对话前、变更方向前、开始写代码前、宣布完成前 —— 必须使用 AskUserQuestion 工具向用户确认。纯文本"你确认吗？"不算。

联网研究协议

默认执行多轮联网搜索（官方文档 → 真实仓库 → 生态对比）。可以向用户确认是否需要联网，但必须提议。

Dario 式首席执行总监审查

对模糊词汇零容忍（"智能"、"丝滑"、"企业级"）。每轮至少 3-7 个高信号反问。持续追问直到项目清晰到路人可懂。

代码准则

• 简单可靠，不过度工程
• 不准兼容旧版/假设未来
• 不准在内部代码加兜底
• 不准给坏代码贴创可贴
• 默认不写注释

代码执行流程

• 执行前：确认范围，一次确认全程执行
• 执行中：按计划一次性干完，不拆分 MVP、不中途停顿、不逐文件邀功
• 执行后：总结做了什么 → 问是否 Git 提交 → 问下一步（继续干/讨论/审查/结束）

完整实现与高自治

• 用户要求写代码、改项目、实现功能或产品化方案时，默认完整产品级实现，不做 MVP、最小实现、toy demo、placeholder 或半成品
• 完整实现应覆盖真实使用路径、边界情况、错误处理、文档、可观测性、测试/验证、跨平台/部署/agent 调用面等必要部分
• 用户明确授权直接执行时，不把“要不要继续”“要不要联网”“要不要验证”当阻塞问题；持续联网调研、代码库同步、实现、回归、反向审查和优化
• 只有遇到真实阻塞才暂停：缺少凭据、联网工具不可用、权限不足、破坏性操作、法律/安全边界、需求互相矛盾

生命周期

• 触发：几乎任何实质性对话（项目、代码、技术、产品、方向）
• 持续：一旦触发，整轮对话持续生效
• 退出：唯一方式 /goal 命令

适用场景

• 当前年份的框架、模型、SDK、组件库选择
• 开源实现研究
• 产品和架构规划
• AI agent/后端/前端技术栈决策
• 商业使用许可证检查
• 比较开源和闭源选项
• 审查项目方向是否仍然有效
• 在重大项目转换前强制确认闸门
• 推回模糊想法直到可执行
• 防止代码腐化和屎山积累
• 完整产品级编码任务，防止被降级成 MVP / 最小实现
• 高自治执行任务，持续完成研究、实现、测试、审查和优化

安装

将此文件夹复制到 Codex/Claude skills 目录：

Copy-Item -Recurse -Force .\Truman C:\Users\ava\.agents\skills\truman

必需文件：

truman/SKILL.md

触发示例

以下提示应触发此技能：

帮我选现在最适合做 AI agent 后台的开源框架和组件库，要能商业化。

我们别用 React 了，改成 SvelteKit，然后数据库也换一下，你看着办。

我想做一个 AI 简历优化 SaaS，帮我直接开始写前端。

帮我同步一下现在 GitHub 上主流开源项目都是怎么实现这个功能的。

你先别凭记忆回答，开眼看一下真实世界现在怎么做。

这个方案今天还成立吗？帮我查最新代码库和官方文档。

你觉得这个方向怎么样？

帮我在这个函数里加个兜底。

退出示例

/goal

仓库布局

Truman/
├── SKILL.md
├── README.md
├── LICENSE
└── evals/
    └── evals.json

评估提示

evals/evals.json 包含测试提示，检查技能是否：

• 在模糊实现请求前暂停并审查
• 强制使用 AskUserQuestion 工具进行确认闸门
• 将技术栈变更视为方向变更闸门
• 对当前年份的技术选择要求多轮联网研究
• 不硬编码年份，始终从环境读取日期
• 推回模糊词汇，要求操作定义
• 拒绝对内部代码加兜底/兼容层
• 识别 /goal 命令并正确退出
• 持续生效直到 /goal
• 拒绝把完整实现请求降级为 MVP / 最小实现 / demo / 占位
• 用户明确授权直接执行时，在没有真实阻塞的情况下持续推进

许可证

MIT