AI导哈

临时笔记工具

note-taker是一款用于临时、会话范围内工作笔记的Codex技能，适用于需要跨步骤或压缩保存中间事实、决策、文件和待办事项的长或多步骤代理任务。

  • by chriskyle
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 chriskyle/note-taker-mcp

使用说明

记笔记技能

note-taker 是一种用于临时、会话范围工作笔记的Codex技能。它专为长时间或多步骤的代理任务而设计，在这些任务中，中间事实、决策、文件和TODO需要在转弯或压缩过程中生存，而不会成为持久的交叉运行内存。

运行时工件是技能目录：

skill/
  SKILL.md
  scripts/
    notes.py

没有MCP服务器、软件包安装、矢量存储或运行时依赖关系。

设计

该技能从以下方面解决确定性临时会话：

  1. NOTE_TAKER_SESSION_ID，如果设置。
  2. CODEX_THREAD_ID，如果设置。
  3. 否则，它会大声失败并要求 NOTE_TAKER_SESSION_ID.

会话密钥是以下哈希值：

session identity + workspace root + git branch/ref

默认情况下，会话文件位于以下位置：

/tmp/note-taker/v1/sessions/<session-key>/
  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 .

相关 MCP