← 返回首页

AI 接入

每个平台一页接入方法:一键命令或一条规则,人和 AI 读写同一个本地库。

最快方式:把这段提示词发给你的 AI

它清楚自己的规则机制该往哪写:会读契约、自己落配置,完成后跑验证命令向你汇报。下面各平台的手动步骤,留给你不想让 AI 动配置时用。

帮我接入本地待办应用「拾事」(PickDone)的 CLI,以后你可以直接帮我管理任务。 第一步:如果你支持技能(Agent Skills)机制,用你自己的技能安装方式把 %LOCALAPPDATA%\Programs\PickDone\resources\cli\SKILL.md 注册为技能;也可以直接执行 node "%LOCALAPPDATA%\Programs\PickDone\resources\cli\pickdone.js" skill install(写入 Claude Code / ZCode 技能目录)。 第二步:读取并遵循这份契约,并把它持久化——有记忆/规则机制就写入(CLAUDE.md、全局 AGENTS.md、.cursor/rules、GEMINI.md 等),让以后每个会话自动遵守。 第三步:用 pickdone add "🎉 PickDone CLI 接入成功" --date today 帮我创建第一个任务作为里程碑,再用 pickdone list --undone --json 确认并告诉我结果。 全程遵守契约:始终加 --json,写操作后回读,不要直接写 SQLite。

Claude Code 文档 ↗

Claude Code 按 Agent Skills 标准读取 ~/.claude/skills/ 下的技能目录。拾事自带一键注册,装完即用。

1

运行一键安装命令

node "%LOCALAPPDATA%\Programs\PickDone\resources\cli\pickdone.js" skill install

开发者在仓库 pickdone/ 目录下:node cli/pickdone.js skill install

2

重启会话生效

重启会话(或新开一个),它就能看到 pickdone 技能;App 升级后重跑同一命令即可同步最新契约。想双保险,也可以让它把契约写进全局 CLAUDE.md。

ZCode

ZCode 按 Agent Skills 标准读取 ~/.zcode/skills/ 下的技能目录,安装方式与 Claude Code 同一条命令。

1

运行一键安装命令

node "%LOCALAPPDATA%\Programs\PickDone\resources\cli\pickdone.js" skill install

2

重启会话生效

重启会话(或新开一个),它就能看到 pickdone 技能;App 升级后重跑同一命令即可同步最新契约。

Cursor 文档 ↗

Cursor 原生支持 Agent Skills,自动加载 ~/.cursor/skills/ 与 .cursor/skills/——skill install 一条命令即完成。偏好规则文件的话,也可手动接入。

1

运行一键安装命令

node "%LOCALAPPDATA%\Programs\PickDone\resources\cli\pickdone.js" skill install

2

重启会话生效

重启工具或新开会话后,对 AI 说「用 pickdone CLI 列出我今天未完成的任务」——它应执行 pickdone list --undone --json 并读回结果。之后增删改查都走同一命令面。

备选:规则文件方式

项目根新建 .cursor/rules/pickdone.mdc;全局则打开 Settings → Rules 新建一条。

--- description: PickDone CLI 使用契约 alwaysApply: true --- 请先阅读并遵循 %LOCALAPPDATA%\Programs\PickDone\resources\cli\SKILL.md 中的约定;调用该 CLI 时始终加 --json;写操作后用 get / list 回读验证;永远不要直接写 SQLite。

Codex CLI 文档 ↗

Codex 从 ~/.codex/AGENTS.md(全局)与项目根 AGENTS.md 读取指令,层级合并、就近优先。

1

打开对应文件

打开(或新建)~/.codex/AGENTS.md——全局生效;只想在单个项目生效,就写该项目根的 AGENTS.md。

2

粘入拾事规则

请先阅读并遵循 %LOCALAPPDATA%\Programs\PickDone\resources\cli\SKILL.md 中的约定;调用该 CLI 时始终加 --json;写操作后用 get / list 回读验证;永远不要直接写 SQLite。

3

重启会话生效

重启工具或新开会话后,对 AI 说「用 pickdone CLI 列出我今天未完成的任务」——它应执行 pickdone list --undone --json 并读回结果。之后增删改查都走同一命令面。

OpenCode 文档 ↗

OpenCode 读取项目根 AGENTS.md 与全局 ~/.config/opencode/AGENTS.md;opencode.json 的 instructions 字段还能挂额外规则文件。

1

打开对应文件

打开(或新建)~/.config/opencode/AGENTS.md——全局生效;项目级写项目根 AGENTS.md。

2

粘入拾事规则

请先阅读并遵循 %LOCALAPPDATA%\Programs\PickDone\resources\cli\SKILL.md 中的约定;调用该 CLI 时始终加 --json;写操作后用 get / list 回读验证;永远不要直接写 SQLite。

3

重启会话生效

重启工具或新开会话后,对 AI 说「用 pickdone CLI 列出我今天未完成的任务」——它应执行 pickdone list --undone --json 并读回结果。之后增删改查都走同一命令面。

Gemini CLI 文档 ↗

Gemini CLI 用 GEMINI.md 做层级记忆:全局在 ~/.gemini/GEMINI.md,项目根可放 .gemini/GEMINI.md,还支持 @ 路径引入其他文件。

1

打开对应文件

编辑 ~/.gemini/GEMINI.md——全局生效;项目级在项目根建 .gemini/GEMINI.md。

2

粘入拾事规则

请先阅读并遵循 %LOCALAPPDATA%\Programs\PickDone\resources\cli\SKILL.md 中的约定;调用该 CLI 时始终加 --json;写操作后用 get / list 回读验证;永远不要直接写 SQLite。

不想复制内容的话,也可以在 GEMINI.md 里加一行 @ 引入 SKILL.md 的绝对路径。

3

重启会话生效

重启工具或新开会话后,对 AI 说「用 pickdone CLI 列出我今天未完成的任务」——它应执行 pickdone list --undone --json 并读回结果。之后增删改查都走同一命令面。

其他工具

Cline、Windsurf、Aider 等任何带规则/记忆文件机制的工具都能接入,方法完全相同。

1

打开对应文件

找到该工具的全局或项目级规则文件(各家命名不同,见其文档)。

2

粘入拾事规则

请先阅读并遵循 %LOCALAPPDATA%\Programs\PickDone\resources\cli\SKILL.md 中的约定;调用该 CLI 时始终加 --json;写操作后用 get / list 回读验证;永远不要直接写 SQLite。

3

重启会话生效

重启工具或新开会话后,对 AI 说「用 pickdone CLI 列出我今天未完成的任务」——它应执行 pickdone list --undone --json 并读回结果。之后增删改查都走同一命令面。

验证与排障

接入是否成功,一句话即可验证:对 AI 说「用 pickdone CLI 列出我今天未完成的任务」——它应执行 pickdone list --undone --json 并读回结果。之后所有增删改查都走同一命令面。

AI 找不到命令?让它先跑 pickdone doctor 自检环境,或把「运行前提」里的完整调用路径发给它。