记笔记技能
note-taker 是一种用于临时、会话范围工作笔记的Codex技能。它专为长时间或多步骤的代理任务而设计，在这些任务中，中间事实、决策、文件和TODO需要在转弯或压缩过程中生存，而不会成为持久的交叉运行内存。
运行时工件是技能目录：
skill/
SKILL.md
scripts/
notes.py没有MCP服务器、软件包安装、矢量存储或运行时依赖关系。
设计
该技能从以下方面解决确定性临时会话：
NOTE_TAKER_SESSION_ID，如果设置。CODEX_THREAD_ID，如果设置。- 否则，它会大声失败并要求
NOTE_TAKER_SESSION_ID.
会话密钥是以下哈希值：
session identity + workspace root + git branch/ref默认情况下，会话文件位于以下位置：
/tmp/note-taker/v1/sessions//
MANIFEST.json
NOTES.md
TODO.md这给出了预期寿命：
- 相同的线程、仓库和分支：不同轮次的临时注释相同
- 新线：新笔记
- 新分支/ref：新注释
- 缺少会话标识：无模糊重用
MANIFEST.json 是脚本拥有的元数据。面向模型的文件包括：
NOTES.md：可变的工作理解、发现、决策、相关文件、未决问题和更正的假设。TODO.md：具有当前、已阻止和已完成部分的可变任务跟踪。
用法
直接运行捆绑的脚本：
python skill/scripts/notes.py resume有用的命令：
python skill/scripts/notes.py init
python skill/scripts/notes.py where
python skill/scripts/notes.py resume
python skill/scripts/notes.py search "query"
python skill/scripts/notes.py gc使用 NOTE_TAKER_ROOT 或 --root 覆盖临时基目录。
安装为Codex技能
复制 skill/ 进入您的Codex技能目录 note-taker.中的技能说明 skill/SKILL.md 描述代理何时以及如何使用捆绑的脚本。
发展
此回购保留 pyproject.toml 仅用于开发工具。它不是Python包，也不适用于PyPI发行版。
python3 -m venv .venv
.venv/bin/python -m pip install pytest ruff
.venv/bin/python -m pytest
.venv/bin/python -m ruff check .