planning-with-files 技能
把长期任务计划及进度留在项目文件中,钩子能力依宿主而定。
社区 · OthmanAdi| 作者 | OthmanAdi |
|---|---|
| 许可证 | MIT |
| 来源 | OthmanAdi/planning-with-files · GitHub 上的 SKILL.md |
| 项目官网 | planningwithfiles.tech |
| 适用于 | Claude Code · Codex、Gemini CLI、Cursor、Copilot |
| 读取源文件日期 |
planning-with-files: 把长期任务计划及进度留在项目文件中,钩子能力依宿主而定。
已核对 v3.28.2,区分项目恢复、明确授权的会话历史读取与选择启用的门控续作。
摘自该技能的 SKILL.md: # Planning with Files
功能
- 选择任务所属计划,保留发现并记录进度。
产出内容
- 计划 Markdown,可选结构化账本及恢复状态。
适用场景
- 需要持久上下文的多步骤工作。
不适用的场景
- 假定所有宿主都有相同的停止门控。
所需条件
- 本地文件、shell/PowerShell 及适用 Python 辅助脚本;生命周期钩子依宿主支持。
技能包含的文件
| 文件或文件夹 | 用途 |
|---|---|
SKILL.md | 入口说明与任务专用流程。 |
2026-11-16 在仓库中查到的许可证:MIT。
示例提示词
安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。
- 用持久项目文件规划这个任务。
- 仅恢复所选计划。
- 解释此宿主支持的完成门控。
如何安装 planning-with-files
准备工作流程
复制完整规范技能目录、脚本和模板。启用前审查钩子;发现文件夹不等于完成各宿主钩子配置。
技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:
Claude Code:把文件夹复制到技能文件夹
把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。
git clone --depth 1 https://github.com/OthmanAdi/planning-with-files.git
mkdir -p ~/.claude/skills
cp -R planning-with-files/skills/planning-with-files ~/.claude/skills/Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /planning-with-files,或直接描述任务。
在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。
Codex、Gemini CLI、Cursor 和 GitHub Copilot
这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:
git clone --depth 1 https://github.com/OthmanAdi/planning-with-files.git
mkdir -p .agents/skills
cp -R planning-with-files/skills/planning-with-files .agents/skills/| 智能体 | 项目文件夹 | 用户文件夹 | 说明 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | 输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。 |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。 |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | 在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。 |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | 适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。 |
这些步骤的来源
已于 2026-11-14 对照各厂商的文档核实:
一个选定计划
命名选择器避免恢复时静默切换任务。守卫仅为建议,不是锁或合并机制。
宿主能力
传统、自主和门控模式不同。没有阻断停止钩子的宿主无法提供最强门控,任何模式都不保证完成。
关于 planning-with-files 的常见问题
本网站会执行技能吗?
不会,这是基于源码的安装指南,技能由您配置的代理环境执行。
这里核实了完整云端流程吗?
没有,因此不提供通用云端上传及 API 执行步骤;仍须满足源码的本地依赖与宿主能力。
恢复会自动读会话历史吗?
默认只读项目计划文件;会话元数据或有界回放须明确模式及用户要求。
证明摘要是安全签名吗?
不是,只有保存摘要可信时才可检测变化,不能让注入文本变安全。
更多 AI 技能
相关技能
free-tools 技能
社区 · Corey Haines按用户价值、业务匹配和维护成本评估免费工具点子。site-architecture 技能
社区 · Corey Haines设计页面层级、导航、URL 映射与有用内链。n8n 自托管技能
社区 · Romuald Członkowski用 Docker 部署和维护 n8n,配置 Caddy HTTPS、私有服务并验证备份。n8n Code JavaScript 技能
社区 · Romuald Członkowski按执行模式编写或调试 n8n JavaScript Code 节点的数据读取与返回值。n8n Code Python 技能
社区 · Romuald Członkowski按明确的沙箱和模式限制,为 n8n 2.x Code 节点编写原生 Python。n8n Code Tool 技能
社区 · Romuald Członkowski为代理编写以 query 输入、字符串输出的 n8n Custom Code Tool。