Aitishiku.com📌 Skill基础信息
Skill名称：planning-with-files
简称：文件规划器
来源：社区第三方（OthmanAdi）
运行宿主：Claude Code CLI 及兼容的60+ AI编码Agent（包括Codex、Cursor、OpenCode等）
核心定位：为AI编码Agent提供基于文件的持久化规划能力，解决长周期任务中的上下文丢失和会话恢复问题，确保崩溃后可继续执行。
🧩 内部核心组成
本Skill主要通过以下机制实现持久化规划：
核心组件：
- Markdown计划文件：采用结构化Markdown格式存储任务规划
- 会话恢复系统：支持在
/clear后恢复执行状态 - 防上下文腐化机制：每轮自动重新注入规划上下文
- 确定性完成门：确保任务执行的完整性
主要能力：
- 持久化存储规划状态
- 崩溃后自动恢复
- 长周期任务管理
- 避免Agent上下文丢失
🛠 安装与启用方式
安装命令：
skills install --user OthmanAdi/planning-with-files替代安装方式：
- 通过npm安装
- Claude Code插件市场安装
- 使用npx skills工具安装
前置要求：
- 兼容的AI编码Agent环境（Claude Code CLI、Cursor等）
- Node.js运行环境（部分安装方式需要）
📋 标准工作流
- 初始化规划：用户提出复杂编码任务需求
- 计划生成：Skill自动创建结构化Markdown规划文件
- 分步执行：Agent按照规划文件逐步完成任务
- 状态持久化：每步执行结果自动保存到规划文件
- 中断恢复：如遇崩溃或
/clear，从最后记录点恢复 - 完成验证：通过确定性完成门确保任务完整性
⚠️ 关键限制、缺陷、注意事项
平台限制：
- 仅支持兼容MCP协议的AI Agent环境
- 不支持传统IDE插件体系
资源消耗：
- 需要额外的文件存储空间
- 每轮重新注入会增加一定的token消耗
使用限制：
- 不适合简单单次查询任务
- 对超大规模项目可能产生规划文件管理复杂度
- 生产环境使用需测试稳定性
✅ 适用场景 & ❌ 不适合场景
✅ 适用场景：
- 多步骤复杂编码任务
- 长周期开发项目（需要数小时或数天）
- 需要崩溃恢复的重要任务
- 团队协作中的可追踪开发过程
❌ 不适合场景：
- 简单代码查询或调试
- 一次性快速任务
- 对响应速度要求极高的场景
- 无持久化存储需求的小型任务
如何安装
skills install --user OthmanAdi/planning-with-files通用安装教程：在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器，把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同，按下面操作即可：
- 打开工具自带的终端面板，或系统终端（macOS「终端」、Windows「PowerShell」、Linux「Terminal」）。
- 把上面的安装命令复制进去，回车运行，等待下载与注册完成。
- 重启或重新加载 AI 工具，让新安装的 Skill 被识别。
- 新建对话并触发：直接描述用途，或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版（macOS / Windows）
桌面版没有内置命令行，Skill 需通过 Claude Code CLI 安装。打开系统终端，先执行 npm install -g @anthropic-ai/claude-code，再运行上面的安装命令；完成后完全退出并重新打开 Claude。
Claude Code（终端 CLI）
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面，再在对话中引用该 Skill（/ 斜杠菜单或直接描述用途）。
VS Code（含 GitHub Copilot）
打开终端面板：菜单「终端 → 新建终端」，或快捷键 Ctrl+`（macOS 为 ⌃+`）。在终端里运行上面的命令；装完后执行「重新加载窗口」（Ctrl+Shift+P → Reload Window），让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板（Ctrl+`）即是内置终端。粘贴运行上面的命令，完成后在命令面板执行「Reload Window」刷新，再开始对话。
Windsurf
底部「终端」面板运行命令；也可直接使用其内置 Agent 终端，在对话侧执行安装。
其他工具（ChatGPT、本地脚本等）
不支持本地终端的产品，可先在本机终端完成安装，再在对话中描述该 Skill 的能力让其调用；不同工具的命令格式请以其官方文档为准。
风险提示
自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。