Token导航 LogoToken导航

Agent Skill · 运维和基础设施

planning-with-files(文件规划)

planning-with-files 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

planning-with-files 是运维和基础设施类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为只读;许可证为 MIT,第三方扫描有未通过项,按安装量在运维和基础设施类的 2,449 个 Skill 里排第 1,971。

总安装 329周安装 14GitHub Stars 1下载 115核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
MIT

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:planning-with-files(文件规划)
来源仓库:https://github.com/evanfang0054/cc-system-creator-scripts
仓库路径:skills/planning-with-files
安装命令:
npx skills add https://github.com/evanfang0054/cc-system-creator-scripts --skill planning-with-files
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。不同来源提供的安装方式可能略有差异;本站展示可直接复制的安装命令,安装前请核对来源页面。

skills.shnpx skills
npx skills add https://github.com/evanfang0054/cc-system-creator-scripts --skill planning-with-files

这个 Skill 是做什么的

运维和基础设施类 Skill 处理部署、监控、日志和云资源,多数需要较高的执行权限。

planning-with-files 使用持久化 Markdown 文件作为工作记忆,跟踪任务阶段和交付物进度。适用于复杂项目的规划与管理场景,通过三文件模式(task_plan.md、notes.md、deliverable.md)组织工作流。使用时需在每个阶段更新计划文件、存储研究发现,并在交付前进行最终检查。

安装前请确认仓库权限和维护状态,避免频繁写入导致上下文溢出,建议定期归档历史记录。适用宿主包括 Codex、Claude、Cursor、Gemini CLI,接入前应确认版本、权限和运行环境要求。

来源仓库内路径:skills/planning-with-files

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/evanfang0054/cc-system-creator-scripts --skill…;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它标注为只读,先用只读任务试一次,确认行为符合预期再扩大使用范围。

常见问题

6 条

planning-with-files 怎么安装?

在终端执行 npx skills add https://github.com/evanfang0054/cc-system-creator-scripts --skill planning-…。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

planning-with-files 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

planning-with-files 需要什么权限?

权限级别是只读。该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

planning-with-files 是免费的吗?

来源标注的许可证是 MIT。本站不代收任何费用,也不托管安装包;能否商用、要不要署名,以许可证原文为准。

planning-with-files 用的人多吗?

公开数据是累计安装 329 次,近一周安装 14 次,下载 115 次,GitHub 1 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

planning-with-files 安全吗?

第三方扫描有未通过项,风险较高。除非你确认过源码,否则不建议直接安装到常用环境。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 3 个目录同时收录,说明这个 Skill 流传比较广。
  • 许可证明确为 MIT,商用和分发边界好判断。
  • 标注为只读权限,试用阶段不容易误改本地文件。

先想清楚的地方

  • 第三方扫描存在提醒项或未通过项,需要人工逐条确认。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理运维和基础设施类任务、又不想每次都手写提示词的人。
  • 只想先试试效果、不希望它改动本地文件的人。

不太适合

  • 需要厂商级技术支持和 SLA 的生产系统。

运维和基础设施类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
brainstorming

头脑风暴 · Codex、Claude

3,148,776173,131操作浏览器MIT通过
copywriting

文案写作 · Codex、Claude

1,996,72425,583需要联网MIT通过
openclaw-secure-linux-cloud

OpenClaw secure linux cloud 命令行 · Codex、Claude

1,853,08840接触敏感数据未明确未通过
xget

xget 命令行 · Codex、Claude

1,799,28040执行命令未明确未通过
requesting-code-review

代码审查请求 · Codex、Claude

1,590,144173,103权限未标注MIT通过
planning-with-files

文件规划 · 本页

3291只读MIT未通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

使用文件进行规划

像 Manus 一样工作:使用持久化的 markdown 文件作为你的"磁盘工作记忆"。

快速开始

在任何复杂任务之前:

  1. 在工作目录中创建 task_plan.md
  2. 定义阶段,使用复选框
  3. 每个阶段后更新 - 标记 [x] 并更改状态
  4. 决策前读取 - 刷新注意力窗口中的目标

三文件模式

对于每个非平凡任务,创建三个文件:

文件用途更新时机
task_plan.md跟踪阶段和进度每个阶段后
notes.md存储发现和研究研究过程中
[deliverable].md最终输出完成时

核心工作流

循环 1:创建包含目标和阶段的 task_plan.md
循环 2:研究 → 保存到 notes.md → 更新 task_plan.md
循环 3:读取 notes.md → 创建交付物 → 更新 task_plan.md
循环 4:交付最终输出

详细循环说明

每次主要操作前:

Read task_plan.md  # 刷新注意力窗口中的目标

每个阶段后:

Edit task_plan.md  # 标记 [x],更新状态

存储信息时:

Write notes.md     # 不要塞满上下文,存储到文件中

task_plan.md 模板

对于任何复杂任务,首先创建此文件:

# 任务计划:[简要描述]

## 目标
[一句话描述最终状态]

## 阶段
- [ ] 阶段 1:规划和设置
- [ ] 阶段 2:研究/收集信息
- [ ] 阶段 3:执行/构建
- [ ] 阶段 4:审查和交付

## 关键问题
1. [需要回答的问题]
2. [需要回答的问题]

## 已做出的决策
- [决策]:[理由]

## 遇到的错误
- [错误]:[解决方案]

## 状态
**当前处于阶段 X** - [我现在正在做的事情]

notes.md 模板

用于研究和发现:

# 笔记:[主题]

## 来源

### 来源 1:[名称]
- URL:[链接]
- 关键点:
  - [发现]
  - [发现]

## 综合发现

### [类别]
- [发现]
- [发现]

关键规则

1. 始终先创建计划

在没有 task_plan.md 的情况下永远不要开始复杂任务。这是不可协商的。

2. 决策前先读取

在任何重大决策之前,读取计划文件。这可以将目标保持在你的注意力窗口中。

3. 行动后更新

完成任何阶段后,立即更新计划文件:

  • 用 [x] 标记已完成的阶段
  • 更新状态部分
  • 记录遇到的任何错误

4. 存储,不要塞满

大型输出放入文件,而不是上下文。在工作记忆中只保留路径。

5. 记录所有错误

每个错误都进入"遇到的错误"部分。这为未来的任务积累知识。

何时使用此模式

对以下情况使用三文件模式:

  • 多步骤任务(3+ 步骤)
  • 研究任务
  • 构建/创建某物
  • 跨多个工具调用的任务
  • 任何需要组织的事情

以下情况跳过:

  • 简单问题
  • 单文件编辑
  • 快速查找

避免的反模式

不要做而是做
使用 TodoWrite 进行持久化创建 task_plan.md 文件
陈述一次目标就忘记每次决策前重新读取计划
隐藏错误并重试将错误记录到计划文件
将所有内容塞入上下文将大型内容存储到文件中
立即开始执行首先创建计划文件

高级模式

参见 reference.md 了解:

  • 注意力操作技巧
  • 错误恢复模式
  • 来自 Manus 的上下文优化

参见 examples.md 了解:

  • 真实任务示例
  • 复杂工作流模式

平台分布

trae

29.28%
按下载量换算34

OpenCode

21.66%
按下载量换算25

kiro-cli

18.04%
按下载量换算21

Codex

12.04%
按下载量换算14

Claude Code

6.81%
按下载量换算8

Antigravity

3.36%
按下载量换算4

安全审计

Gen Agent Trust Hub

未通过

Socket

通过

Snyk

可疑

权限和风险

只读

该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在提醒或未通过项,安装前请自行复核。

继续浏览同类 Skills