deepworkplan-skill

将代码仓库转化为AI优先的结构化工作环境,用于执行长期、复杂的开发任务。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:deepworkplan-skill。
它的用途是:将代码仓库转化为AI优先的结构化工作环境,用于执行长期、复杂的开发任务。
完整的 Skill 内容见:https://321skill.com/skills/deepworkplan-skill/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请为当前仓库创建一个深度工作计划,目标是将用户认证模块从JWT迁移到OAuth 2.0。” 它会先调用 `deepworkplan-onboard` 技能分析仓库结构,将其转化为AI优先环境。然后,调用 `deepworkplan-create` 与你交互,共同制定一个包含依赖分析、代码迁移、测试更新、文档修订等步骤的详细计划。最后,你可以让AI调用 `deepworkplan-execute` 自动按计划分步执行并验证每个任务。

介绍

DeepWorkPlan Skill Pack 是一个专为AI编程助手设计的技能包,旨在解决AI在处理长期、多步骤、高复杂度的代码库任务时,因缺乏上下文和结构化指导而导致的执行偏差、中断后难以恢复等问题。它通过将普通代码仓库改造为“AI优先”的结构化环境,为AI提供清晰的上下文、执行护栏和持久化计划。

该技能包的核心工作流程是“规划-执行-优化-恢复-报告”。首先,使用 deepworkplan-onboard 技能分析仓库的技术栈和架构类型,并自动生成适配的 AGENTS.md、文档目录、模块文档以及 .agents/ 配置文件。随后,开发者或AI可以创建详细的“深度工作计划”,将宏大的目标拆解为可验证的原子任务。AI助手将严格按计划分步执行,每个任务完成后进行验证,并将所有进度和输出持久化存储在 .dwp/ 目录中,支持随时中断和精准恢复。

它非常适合需要AI助手协作完成大型重构、复杂功能开发、系统迁移或长期维护项目的开发团队和个人开发者。尤其适用于那些代码库庞大、依赖关系复杂,需要AI在数小时甚至数天内分阶段、有监督地完成工作的场景。

与市面上其他单点式的AI编码技能(如仅生成代码或仅写测试)不同,DeepWorkPlan 提供了一套完整的、工程化的“AI驱动开发”框架。它不是一次性的代码生成工具,而是一个将仓库本身作为“执行框架”的持续协作平台。其核心区别在于强调“计划”的持久性和“上下文”的结构化,确保AI在整个长周期任务中保持目标一致、上下文连贯,并能从任何中断点无缝恢复,从而实现真正意义上的“深度工作”。

核心特点

核心区别在于提供了一套完整的“计划驱动开发”框架,而非单点工具。它将仓库本身改造为AI的执行框架,通过持久化的计划文件(.dwp/)和结构化上下文,确保AI在长周期、多任务工作中保持目标一致,并能从任意中断点精准恢复,解决了AI处理复杂任务时常见的“遗忘上下文”和“执行漂移”问题。

注意事项

不适合用于快速、一次性的简单代码片段生成或即时问答场景,其价值在长期、复杂的项目协作中才能充分体现。

常见问题

DeepWorkPlan 和普通的AI写代码有什么区别?

它不是一次性的代码生成,而是为AI提供结构化环境、持久化计划和执行护栏,使其能像人类开发者一样,系统性地完成长期、复杂的项目任务。

安装后会影响我原有的仓库结构吗?

核心改造是添加AI优先的配置和文档(如AGENTS.md, .agents/),以及用于存储计划的.gitignored目录(.dwp/),不会影响你的核心业务代码。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/deepworkplan-skill/raw/index.md 读取 deepworkplan-skill 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。