planning-with-files 在 Autohand Code 中的完整接入指南Agent Skills 安装、作用域选择与三文件规划工作流【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files本指南以仓库文档 docs/autohand.md 为主体系统讲解如何将 planning-with-files 这一持久化文件规划技能接入 Autohand Code涵盖技能发现机制、三种安装路径共享 Agent Skills 标准、用户级、项目级、Autohand Catalog 浏览方式以及安装后task_plan.md/findings.md/progress.md三文件工作流在 Autohand 会话中的实际用法。读完本文你将掌握在 Autohand Code 中从零安装、按作用域部署、验证安装并启动规划工作流的完整实操能力。一、Autohand Code 集成概览这条安装路径能带来什么planning-with-files 的核心思路是把 Agent 的“工作记忆”从易失的上下文窗口搬到磁盘上在项目根目录维护task_plan.md阶段与进度、findings.md研究发现和progress.md会话日志与测试结果三个纯 Markdown 文件并通过生命周期钩子把选定的计划内容重新注入上下文从而在/clear、压缩compaction或崩溃后仍能恢复现场详见 README.md 与 SKILL.md。在 Autohand Code 上接入该技能属于标准 Agent Skills 支持路径。也就是说Autohand 通过自身的技能发现机制加载技能获得以下三方面能力标准技能加载Autohand Code 通过技能发现skill discovery机制识别并加载 planning-with-files。完整技能内容规范技能canonical skill中的全套模板templates、脚本scripts与参考文档随安装一并落地不裁剪、不降级。灵活作用域既支持用户级user-level安装也支持项目级project-level安装。需要特别说明的边界是这条路径只安装标准 Agent Skills。Claude Code 专属的插件命令如/plan-goal、/plan-loop、/plan-attest等 slash 命令以及 Claude 专属 hooksUserPromptSubmit、Stop、PreCompact等定义见 SKILL.md不会通过此路径安装。如果这些机制对你至关重要应参考 docs/installation.md 中推荐的 Claude Code 插件路线。规划文件本身是工具无关的同一套文件可以在 Claude Code、Cursor、Codex、Autohand Code 及其他 60 Agent 之间通用docs/autohand.md。二、Autohand Code 的技能发现位置Autohand Code 会从多个位置发现技能安装前需要先明确这些搜索路径以便选择正确的目标目录优先级/位置路径说明用户级技能~/.autohand/skills/Autohand 原生用户级目录仅对当前用户生效项目级技能project/.autohand/skills/Autohand 原生项目级目录随仓库提交可团队共享共享 Agent Skills~/.agents/skills/跨工具的共享 Agent Skills 约定目录Autohand Code 也会扫描从仓库源码结构看项目已在树内维护了与共享 Agent Skills 标准一致的布局.agents/skills/planning-with-files/含SKILL.md、scripts/、templates/等完整内容这正是第三条路径“共享 Agent Skills 约定”所对应的标准形态而第一条、第二条路径~/.autohand/skills/与project/.autohand/skills/需要按下方安装步骤自行创建并复制。三、安装方式一共享 Agent Skills 安装器推荐最简单的方式是使用共享 Agent Skills 安装器一步完成npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g参数说明OthmanAdi/planning-with-files技能所在仓库标识--skill planning-with-files指定安装的技能名若需其他语言变体可替换为planning-with-files-de、planning-with-files-zh等参见 docs/installation.md 中的语言变体说明-g全局global安装即写入共享目录最终落点在~/.agents/skills/planning-with-files/。安装完成后该目录位于 Autohand Code 的共享 Agent Skills 扫描范围内启动 Autohand Code 即可被发现。四、安装方式二Autohand 原生用户级安装如果只想为当前用户账户安装使用 Autohand 原生目录git clone https://gitcode.com/GitHub_Trending/pl/planning-with-files.git /tmp/planning-with-files mkdir -p ~/.autohand/skills cp -r /tmp/planning-with-files/skills/planning-with-files ~/.autohand/skills/ rm -rf /tmp/planning-with-files操作流程克隆仓库 → 创建~/.autohand/skills/目录 → 将规范技能目录skills/planning-with-files仓库内即 skills/planning-with-files整体复制到该目录 → 清理临时克隆。该技能随后仅对当前系统用户可见不影响项目仓库或其他用户。五、安装方式三Autohand 原生项目级安装如果希望把技能提交到项目仓库让整个团队使用完全一致的规划工作流采用项目级安装git clone https://gitcode.com/GitHub_Trending/pl/planning-with-files.git /tmp/planning-with-files mkdir -p .autohand/skills cp -r /tmp/planning-with-files/skills/planning-with-files .autohand/skills/ git add .autohand/skills/planning-with-files git commit -m Add planning-with-files skill for Autohand Code rm -rf /tmp/planning-with-files与用户级安装的区别仅在于目标目录换成了项目内的.autohand/skills/并额外执行了git add与git commit把技能固化到版本库。这样团队成员克隆项目后即获得同一版本的技能避免因各自环境中的技能版本不一致导致规划行为漂移。六、Autohand Catalog 技能浏览Autohand Code 自带社区目录catalog浏览能力可用以下命令交互式查找可安装技能autohand --skill-install若需要项目级安装目录中的技能可带--project参数指定作用域autohand --skill-install skill-name --project需要说明的是只有当 planning-with-files 出现在 Autohand catalog 中时上述目录命令才可用。在它进入目录之前请优先使用第五节的npx skills add或第四、五节的直接 clone 复制路径完成安装docs/autohand.md。七、安装后的使用三文件规划工作流在项目目录中启动 Autohand Code。对于复杂任务技能会引导 Agent 创建并持续维护三个规划文件文件职责更新时机task_plan.md阶段phases、进度progress与决策decisions每个阶段完成后findings.md研究记录与发现任何新发现产生时progress.md会话日志与测试结果整个会话过程中持续记录关键点这三个规划文件位于你的项目根目录而不是技能安装目录。技能安装目录如~/.agents/skills/planning-with-files/只存放模板、脚本和参考文档docs/autohand.md规划文件属于任务目录本身。task_plan.md的标准骨架可直接从仓库模板获得templates/task_plan.md包含Goal、Next Step、Current Phase、Phases仅使用pending/in_progress/complete三种状态、Key Questions、Decisions Made、Errors Encountered等区块。规划工作流遵循若干强制性规则详见 SKILL.md先建计划任何复杂任务开工前必须先有task_plan.md不可跳过每 2 次视图/浏览/搜索操作后立即保存发现防止多模态信息随上下文丢失决策前重读计划让目标始终停留在注意力窗口内行动后更新阶段状态按in_progress → complete流转并同步刷新## Next Step记录所有错误以“错误/尝试/解决”表格形式沉淀进计划文件避免重复犯错。仓库内还提供了初始化脚本 scripts/init-session.sh带任务名参数时会在.planning/YYYY-MM-DD-slug/下创建隔离计划适合并行任务无参数时在项目根写task_plan.md保持向后兼容的旧模式以及 scripts/check-complete.sh 等辅助脚本Autohand 会话中同样可以直接调用。八、注意事项与边界标准 Agent Skills 支持此路径不会安装 Claude Code 插件命令与 Claude 专属 hooksdocs/autohand.md。需要完整 hooks 能力的场景请改用 docs/installation.md 中的插件路线。文件工具无关性规划文件本身跨 Agent 通用同一套task_plan.md/findings.md/progress.md可在 Claude Code、Cursor、Codex、Autohand Code 及其他 Agent 之间无缝迁移docs/autohand.md。避免重复安装如果同时使用共享~/.agents/skills/与 Autohand 原生目录请勿在两边安装同一技能的重复副本否则可能造成技能发现歧义docs/autohand.md。安装完成后可打开 Autohand Code 发起一个复杂任务验证技能是否被加载观察 Agent 是否在项目根目录生成/读取task_plan.md、findings.md、progress.md并按阶段推进、更新状态。从仓库的测试与文档体系如 tests/test_skill_frontmatter_valid.py 等对技能前言的校验可以看出技能目录的SKILL.md前言、模板与脚本是经过严格同步与校验的直接复制skills/planning-with-files目录即可获得一致、可用的完整技能。【免费下载链接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.项目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考