跳转到主要内容
TaskForge 3.0:AI 能读任务了

让 ChatGPT 帮你管理任务

先说实话。ChatGPT 的聊天窗口碰不到你电脑上的文件,因此它没法自己编辑你的仓库。它能做的是帮你起草确切的命令,而 OpenAI 的 Codex 智能体则可以直接读写你的仓库。你的任务是纯 Markdown,因此不管走哪条路,都能按你的格式写入,不需要插件,也不需要你自己搭建 API。

两条靠谱的路

Codex 是 OpenAI 的编码智能体,工作方式和 Claude Code 一样:把它指向你的仓库,它就会编辑文件。如果你更愿意留在 ChatGPT 的聊天窗口里,就让它帮你写 taskforge 命令,自己动手运行。两条路径最终都会在你的仓库里留下一个真实的任务。

  1. 生成仓库契约文件

    用 TaskForge 3.0 或更高版本打开仓库,进入“设置 → AI 与智能体”,保持“生成智能体文件”开启。TaskForge 会写入 TaskForge/Settings/ 文件夹,描述你的任务格式;下面两条路径都会用到它,让写入的任务符合你的写法。

  2. 路径 A:让 Codex 编辑仓库

    Codex 运行在你的终端里,编辑其工作目录中的文件。在那里打开你的仓库,让它读取 TaskForge/Settings/agents.md,它就会像 Claude Code 一样管理任务,精确匹配你的格式。

    cd ~/Documents/MyVault
    codex "先读取 TaskForge/Settings/agents.md,然后把今天笔记里的后续事项
    添加到 tasks/this-week.md,截止日期设为周五。"
    Codex 会读取契约文件,写下这些行,并向你展示 diff。
  3. 路径 B:ChatGPT 起草,你来运行

    安装 taskforge CLI,然后让 ChatGPT 为你想做的事写出对应的命令。它对 taskforge 的查询语法足够熟悉,能帮你起草;你把它粘贴进终端运行,改动就会真正写入。

    npm install -g taskforge-md
    
    # 然后运行 ChatGPT 起草的命令,例如:
    taskforge add "call the plumber" --due 2026-07-10 --priority high
    这个 CLI 使用的是与应用相同的解析器,因此重复任务会正常推进,你的格式也能保持完整。
  4. 在 TaskForge 里查看结果

    不管走哪条路,任务现在都是你仓库里的一行 markdown。打开 TaskForge,它就在那里,仓库一同步,你的手机上也会有。

两条路径都会读取什么

不管是 Codex 还是 CLI 写下任务,TaskForge/Settings/ 文件夹都是保证它符合你格式的关键。Codex 像对待任何源文件一样读取 agents.md;CLI 则读取 dialect.json 来了解你的任务写法。两者都不靠猜。

TaskForge/Settings/agents.md 用通俗英文写的任务语法说明,Codex 写入前会先读它。
TaskForge/Settings/dialect.json 机器可读的版本,taskforge CLI 读取它来匹配你的格式。
TaskForge/Settings/spaces.json 你保存的空间以及新任务的归属,这样归入某个指定空间的任务就能落在正确的笔记里。

实际效果是什么样

Codex 会替你编辑文件;用 CLI 的话,ChatGPT 起草命令,你来运行。结果是一样的:一个符合你格式、留在仓库里的任务。

你提出的请求

“Codex:读取 meeting-notes.md,把每个行动项都加到 tasks/this-week.md,周五截止。”

落进仓库里的内容

- [ ] 把签好的合同发给法务 📅 2026-07-10

- [ ] 支付场地定金 📅 2026-07-10

Codex 读取笔记和契约文件,然后用你仓库的语法写下这两行,并展示 diff。

你提出的请求

“ChatGPT:帮我写一条 taskforge 命令,列出所有紧急任务,最紧急的排在最前。”

落进仓库里的内容

taskforge query 'prop:priority_label=urgent' --sort priority

ChatGPT 根据查询语法起草命令,你运行它就能得到列表。整个过程中,你仓库的任何内容都不会离开你的电脑。

你的文件留在本地

Codex 和 taskforge CLI 都运行在你自己的电脑上,只接触你指向的那个仓库。唯一会发给 OpenAI 的是你对话的文字内容,和任何一次 ChatGPT 聊天一样。没有 TaskForge 账号,你的任务也不会有云端副本。

大家常问的问题

ChatGPT 能直接编辑我的 Obsidian 任务吗?

ChatGPT 的聊天窗口碰不到你电脑上的文件,所以单靠它自己做不到。OpenAI 的 Codex 智能体可以,因为它运行在本地并直接编辑文件。或者你可以让 ChatGPT 起草 taskforge CLI 命令,自己动手运行。两种方式最终都会在你的仓库里留下真实的编辑。

为什么不直接用 ChatGPT 连接器?

taskforge MCP 服务器通过 stdin 和 stdout 在本地运行,这正是 Claude Desktop 和 Cursor 采用的方式。ChatGPT 的连接器是为托管服务设计的,因此对本地仓库来说,可靠的 OpenAI 路径是 Codex 和 CLI。我们宁愿把这点告诉你,也不想卖给你一个并不合适的连接器。

什么是 Codex?

Codex 是 OpenAI 的编码智能体。它运行在你的终端里,读写工作目录中的文件,并遵循 TaskForge/Settings/agents.md 这样的指令。在管理仓库任务这件事上,它的表现和 Claude Code 很相似。

任务会出现在 TaskForge 应用里吗?

会。不管是 Codex 还是 CLI 写下的这一行,它都是你仓库里一个纯 markdown 任务。那台设备上的 TaskForge 当下就能读到它;等仓库同步后,它也会到你的手机上。

这两个工具是怎么知道我的任务格式的?

两者读取的都是 TaskForge 写入你仓库的契约文件。Codex 读取 TaskForge/Settings/agents.md,CLI 读取 TaskForge/Settings/dialect.json。这就是为什么写出来的任务用的是你的写法,而不是一行通用的复选框。

相关设置

在 ChatGPT 这条路径里,主要工作都由 CLI 来完成,AI 总览页面则涵盖每一种智能体。如果你用的是 Claude 或 Cursor,也各有专门的教程。

用 ChatGPT 起草,留在你的仓库里。

纯 markdown,由你已经在用的工具编辑。TaskForge 可在 iPhone、iPad、Mac、安卓和 Windows 上免费下载。