技能 planning-with-files
📦

planning-with-files

安全 ⚙️ 外部命令

使用持久化文件规划复杂任务

也可从以下获取: ZhanlinCui,AmmarCodes,OthmanAdi

长时间 AI 会话会导致上下文丢失和目标遗忘。此技能使用 Markdown 文件作为外部存储器,在无限次的工具调用中维护任务状态。

支持: Claude Codex Code(CC)
🥈 79 白银
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“planning-with-files”。 Initialize planning for a Python CLI todo app with add, list, and delete commands

预期结果:

  • Created task_plan.md with 5 phases: Requirements, Planning, Implementation, Testing, Delivery
  • Created findings.md with sections for requirements, research, and technical decisions
  • Created progress.md with session timestamp and initial status

正在使用“planning-with-files”。 Log error: FileNotFoundError when reading config.json

预期结果:

  • Added to Errors Encountered table: FileNotFoundError, Attempt 1, Resolution: Create default config file
  • Updated progress.md error log with timestamp
  • Phase status remains in_progress until error resolved

安全审计

安全
v1 • 2/24/2026

All static analysis findings were evaluated and determined to be false positives. The shell command patterns detected are from markdown documentation code blocks and legitimate bash helper scripts that only perform file operations. No cryptographic code, network exfiltration, or credential access exists. This is a safe productivity skill for planning complex tasks using persistent markdown files.

8
已扫描文件
1,146
分析行数
1
发现项
1
审计总数
审计者: claude

质量评分

59
架构
100
可维护性
87
内容
50
社区
100
安全
91
规范符合性

你能构建什么

多步骤开发项目

通过阶段跟踪、错误日志和决策文档,在 50 多次工具调用中跟踪复杂的编码任务。

研究和文档

在结构化的 Markdown 中捕获网页搜索结果、浏览器结果和原始资料,防止上下文丢失。

系统探索和调试

在探索不熟悉的代码库或调试问题时,记录发现、失败的尝试和解决方案。

试试这些提示

初始化规划会话
在我的项目目录中创建 task_plan.md、findings.md 和 progress.md 文件。目标是:[描述你的任务目标]。从第一阶段开始收集需求。
跟踪 bug 修复进度
读取 task_plan.md 并更新当前阶段状态。记录遇到的错误:[粘贴错误]。在错误记录表中记录根本原因和尝试的修复方案。
捕获研究发现
我刚刚完成了两个关于 [主题] 的网页搜索。用关键发现、相关 URL 以及基于此研究做出的任何技术决策来更新 findings.md。
阶段完成和审查
在 task_plan.md 中将第 [X] 阶段标记为完成。总结完成的内容、创建或修改的文件,并使用测试结果更新 progress.md。然后将第 [X+1] 阶段设置为进行中。

最佳实践

  • 在开始任何 3 步以上的复杂任务前,创建所有三个规划文件
  • 在做出重大决策前阅读 task_plan.md,以保持目标在注意力范围内
  • 每完成 2 次视图或浏览器操作后立即更新 findings.md
  • 记录遇到的每个错误,即使很快解决,以防止重复
  • 明确标记阶段状态变更:待处理 → 进行中 → 完成

避免

  • 未先创建 task_plan.md 文件就开始执行
  • 静默重试失败的操作而不记录错误
  • 重复相同的失败操作而不是改变方法
  • 在技能目录中创建规划文件而不是项目目录中
  • 使用 TodoWrite 进行持久化而不是基于文件的存储

常见问题

我应该在哪里创建规划文件?
在你正在工作的项目目录中创建 task_plan.md、findings.md 和 progress.md,而不是在技能安装文件夹中。这将使规划文件与你的代码放在一起。
我应该什么时候更新规划文件?
每个阶段完成后更新 task_plan.md。每完成 2 次视图或浏览器操作后更新 findings.md。在会话中随着操作完成随时更新 progress.md。
什么是 2 次操作规则?
每完成 2 次视图、浏览器或搜索操作后,立即将关键发现写入 findings.md。这可以防止视觉或多模态信息在上下文重置时丢失。
如何处理此技能中的错误?
在错误记录表中记录每个错误,包括尝试次数和解决方案。永远不要重复相同的失败操作。3 次尝试失败后,向用户升级,说明你尝试了什么。
我可以将其用于简单任务吗?
对于简单的问题、单文件编辑或快速查询,跳过规划文件。对于 3 步以上的任务、研究项目或任何需要在多次工具调用中保持组织的任务,使用此模式。
Shell 脚本是做什么用的?
init-session.sh 使用模板内容创建所有三个规划文件。check-complete.sh 验证 task_plan.md 中的所有阶段是否标记为完成。两者都是可选的自动化辅助脚本。