用途:Credo: Journal 用于维护一份只追加的研究日志,记录值得解决的问题(想法)、在决策时做出的预测,以及事后复盘(hindsight),并通过每月回顾查看哪些判断长期成立。它延续 Carlini 的 ideas.txt 习惯:只追加、记录问题而非解决方案、每年重读几次,让每个想法在时间间隔后被再次评判。
主要能力:记录研究想法、与论文相关工作决策相关的预测、以及用户要求或项目有明确日志政策时的复盘。日志追踪长期组合,供每月回顾阅读;日常任务进度、产品工作和单次运行仍留在原有记录中。
使用方式:日志路径优先取项目 AGENTS.md 中 owner 设置指定的路径,其次用户指定路径,否则为 ~/research/journal.md。日志属于用户数据,不得重排、去重或编辑旧条目;更正以新的带日期条目指出早先日期。追加使用脚本,例如:python3 scripts/journal.py append --kind idea --title "One line naming the problem" --field "why it might matter=...";预测用 --kind prediction,复盘用 --kind hindsight;读取用 python3 scripts/journal.py read --older-than 90。非默认位置可加 --path <file>,否则使用 CREDO_JOURNAL 环境变量,再否则 ~/research/journal.md。脚本仅以追加模式打开文件、写入当天日期、拒绝未知类型,需要 Python 3.10 或更新版本且无需额外包。若无法使用 Python,可按相同格式手工追加(## YYYY-MM-DD kind: title 后跟 - field: value 行)并说明。
规则:想法记录问题而非解决方案;若用户带来解决方案,先问它要解决什么问题并记录该问题。只记录用户当前认为好的想法。在重要决策时保留用户陈述的预期及会改变预期的因素;仅在缺失预测重要且日志工作被授权时询问。代理提出的预测标记为提案,不转化为用户信念。授权复盘时,将结果与相关预测比较,并把用户判断与代理解释分开保留。捕获时不评估想法,追加后让用户回到任务。日常工作中不主动展示条目,仅在决定下一步和每月回顾时阅读。
每月回顾:输入为用户在途或搁置的长期努力清单,以及先用 --older-than 90 读取的日志;没有对应复盘的预测优先提出。分两轮提问:问题 1、2、4 一起,然后对存活的努力问 3 和 5。仅在用户要求时每轮只问一个问题。五个问题后停止,或用户说明下月改变时提前停止。以用户的话追加一条回顾条目:优秀候选、被终止或搁置及原因、领先月数猜测、下月的一个改变,然后一行写出下周第一个行动。
输出:确认路径和追加条目标题,或读回预测。若文件无法写入,给出条目文本供用户粘贴。
限制:资料未提供具体收费、平台支持范围或效果保证;脚本依赖 Python 3.10+,无 Python 时需手工追加。