【免费下载链接】paulPlan-Apply-Unify Loop — Structured AI-assisted development for Claude Code. Quality over speed-for-speeds-sake.项目地址https://gitcode.com/gh_mirrors/paul3/paul点击查看免费下载在AI辅助开发中PAUL框架为 Claude Code 提供了一套严格的Subagent使用标准只有当任务独立性、范围清晰、并行价值等6大判断标准全部满足时才允许启动Subagent否则一律留在主会话中完成。这套机制从根源上避免了更快地产出垃圾more garbage faster的低质量输出是新手理解PAUL质量哲学最好的切入点。为什么PAUL对Subagent三思而后行用过 Claude Code 的朋友可能都遇到过一个问题context rot上下文腐烂。会话越长质量越差。一个直觉的解法是多开Subagent并行干活但PAUL作者 Chris Kahler 在 README.md 中给出的观察很扎心每个Subagent都从零开始建立上下文最终却只交付约70% 质量的代码还需要返工清理。Subagent的真实成本远比省点上下文高成本项说明启动成本每次生成约 2,000–3,000 tokens上下文重建从零开始研究重复主会话已做的工作结果再合成产出必须序列化后合并回主会话质量差距约70%实现类工作常需返工所以PAUL的核心立场是AI本身就是速度增强不需要以质量为代价再加速。完整的思路对比见 PAUL-VS-GSD.md。6大Subagent判断标准详解PAUL把Subagent定位为工具而非默认选项Subagents are a tool, not a default。完整规则定义在 subagent-criteria.md 中——只有以下6条全部成立Subagent才合适。#标准一句话判断1任务独立性执行中不需要人来反复反馈2范围清晰输入输出明确几乎没有歧义3并行价值确实能同时跑、真的省时间4复杂度甜点区15–60分钟2–3个明确任务5Token效率Subagent成本 主会话成本6状态兼容当前工作流支持异步完成标准1任务独立性Task Independence任务必须自包含执行过程中不需要迭代式的人类反馈。✅ 适合按这些字段创建 User 模型、给现有的 calculateTotal 函数写单元测试❌ 不适合设计仪表盘UI需要反馈、找出测试为什么挂可能需要澄清标准2范围清晰Clear Scope输入和输出都要定义良好歧义要低。✅ 适合输入是 PLAN.md 中的具体任务输出是代码文件和测试结果❌ 不适合把API做得更好模糊、优化性能目标不明如果连做完是什么样都说不清就不该交给Subagent。标准3并行价值Parallel ValueSubagent的真正价值是并行多个独立任务同时跑才有实际的时间收益。✅ 适合Plan 01-01User模型和 Plan 01-02Product模型相互独立三个模块各跑一套测试❌ 不适合单个串行任务没有并行收益、共享状态或输出相互依赖的任务注意一个常见反模式串行Subagent链A → B → C。没有并行收益纯增加开销。标准4复杂度甜点区Complexity Sweet Spot太复杂会漂移drift太琐碎则开销不值得。PAUL给出的甜区是✅2–3个定义良好的任务约15–60分钟工作量有明确的验证标准 太复杂多阶段架构工作、需要对模糊需求做判断 太简单加一行import、修个注释typo——5分钟以下的工作Subagent开销直接超过价值标准5Token效率Token Efficiency这笔账要算清楚Subagent的总成本 启动开销约2–3k tokens 完整上下文重建 结果序列化回主会话。只有当它低于主会话直接做同样工作的成本时才划算。标准6状态兼容State Compatibility当前工作流状态必须支持异步完成✅ 好状态处于 APPLY 阶段且计划是自主执行的autonomous没有待决策或阻塞项❌ 坏状态正卡在检查点等待人工输入、或正处于和用户的迭代打磨循环中这6种情况下千万别用Subagent标准文档同样列出了明确的禁用清单任何一条命中就回到主会话任务需要迭代式打磨执行中要人类反馈输出质量依赖只有主会话才有的细腻上下文任务太简单 5分钟开销超过价值任务太复杂 60分钟漂移风险高、难验证与其他工作强耦合依赖正在进行中的任务需求不确定需要先澄清再执行30秒决策清单三步判断能不能启动SubagentPAUL内置了一个简单的决策框架新手可以直接照着问自己任务自包含且定义清晰吗→ 否则主会话做有多个任务可以并行吗→ 否则主会话做没有并行收益复杂度在15–60分钟甜区内吗→ 否则先拆分或简化三步都是是Subagent才登场。⚠️拿不准时的黄金法则优先留在主会话。主会话意味着更低开销、更好的上下文连续性、更容易纠偏以及随时可以人工介入。Subagent 是并行化明确定义好的工作的工具不是卸载上下文的工具。PAUL给Subagent安排的正确位置PAUL并非禁止Subagent而是把它们用在最擅长的场景发现与研究。/paul:research topic研究主题。--codebase使用 Explore agent 探索代码库--web使用 general-purpose agent 查文档。研究工作流见 research.md 代码库测绘与并行探索discovery/exploration 研究结果保存到.paul/research/{topic-slug}.md主会话永远负责审阅从不自动合并进计划或代码而所有实现类工作PAUL坚持在主会话内完成配合上下文分档管理FRESH / MODERATE / DEEP / CRITICAL 四档见 context-management.md来保证质量。总结慢即是快PAUL的Subagent哲学可以浓缩成一句话Quality over speed-for-speeds-sake. In-session context over subagent sprawl.质量优先于盲目求快主会话上下文优先于Subagent泛滥。对新手来说记住两件事就够了启动Subagent前过一遍6大判断标准全部满足才出手拿不准时默认留在主会话——省下的不只是token更是返工时间掌握这套判断标准你就不会再被多开几个Agent是不是更快的冲动带偏而是让每一个token都花在刀刃上。赞分享【免费下载链接】paulPlan-Apply-Unify Loop — Structured AI-assisted development for Claude Code. Quality over speed-for-speeds-sake.项目地址https://gitcode.com/gh_mirrors/paul3/paul点击查看免费下载相关推荐App Store提交被拒6大常见原因Blitz如何帮你逐条规避并快速恢复上架App Store提交被拒6大常见原因Blitz如何帮你逐条规避并快速恢复上架 Blitz 是一款 macOS 原生 App Store Connect 提交如何用 Gitea cron 定时任务 git_gc_repos 自动垃圾回收所有仓库如何用 Gitea cron 定时任务 git_gc_repos 自动垃圾回收所有仓库 如果你自托管 Gitea仓库随着频繁推送、合并和 force pus后端代码托管研发协作CI/CD邮件投递率体检指南emailmd lint 十大规则帮你揪出 Gmail 截断、垃圾词与重图问题邮件投递率体检指南emailmd lint 十大规则帮你揪出 Gmail 截断、垃圾词与重图问题 emailmd 是一个把 Markdown 渲染成邮件安全创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考