无原创，纯转发https://localhosthttps://localhost/posts/134https://localhost/posts/134Wed, 10 Jun 2026 14:47:19 GMT<b>聪明人的分工：让昂贵模型做规划，便宜模型去执行</b><br /><br />知名开源开发者 shadcn 刚刚开源了一个全新项目——<b>improve</b>。<br /><br />这是一个非常巧妙的 Agent Skill，它的核心理念是：<b>用你最聪明（也最昂贵）的 AI 模型来做高杠杆的脑力劳动（审计代码、写技术方案），然后把脏活累活（编写代码、跑测试）交给更便宜的 AI 模型去执行。</b><br /><br />这个工具本身绝对不会直接修改你的一行代码，它的产出就是<b>一份清晰、可执行的 Markdown 格式实施方案</b>。<br /><br /><b><i><b>💡</b></i> 它是如何工作的？</b><br /><br />1. <b>项目审计 (</b><code>/improve</code><b>)</b>：高阶模型会深度扫描并分析你的代码库，指出潜在的 Bug、性能瓶颈、安全隐患或技术债，并产出一份按“投入产出比”排序的发现清单。<br />2. <b>制定方案 (</b><code>plans/</code><b>)</b>：当你挑选出需要解决的问题后，高阶模型会针对每个问题输出一份极其详尽的方案（Plan）。这些方案是“自包含”的，带有明确的验证命令、执行边界和异常中止条件（STOP conditions）。<br />3. <b>分发执行 (</b><code>/improve execute &lt;plan&gt;</code><b>)</b>：你可以把这些高可读性的方案直接扔给任何便宜的轻量级 AI Agent。轻量级模型只需像个机械的执行者一样，按照步骤修改代码、运行测试，最后向你提交 Pull Request。<br /><br /><b><i><b>🚀</b></i> 核心指令一览</b><br /><br />• <code>/improve</code>：全局审计并输出优化点。<br />• <code>/improve quick</code>：快速扫描重点。<br />• <code>/improve deep</code>：对每个包、每个分类进行详尽审计。<br />• <code>/improve plan &lt;description&gt;</code>：跳过审计，直接为指定任务编写执行方案。<br />• <code>/improve execute &lt;plan&gt;</code>：派发给便宜的执行器模型并审核其成果。<br /><br /><b>安装方式</b><br /><br />项目支持 <a href="https://agentskills.io/" target="_blank">Agent Skills</a> 规范：<br /><br /><pre><code>npx skills add shadcn/improve </code></pre><br /><br /><a href="https://github.com/shadcn/improve" target="_blank">https://github.com/shadcn/improve</a><br /><br /><a href="/search/result?q=%23AI%E5%BC%80%E5%8F%91">#AI开发</a> <a href="/search/result?q=%23%E6%99%BA%E8%83%BD%E4%BB%A3%E7%90%86">#智能代理</a> <a href="/search/result?q=%23%E8%BD%AF%E4%BB%B6%E5%B7%A5%E7%A8%8B">#软件工程</a> <a href="/search/result?q=%23GitHub%E5%BC%80%E6%BA%90">#GitHub开源</a> <a href="/search/result?q=%23shadcn">#shadcn</a><a href="https://agentskills.io/" target="_blank"> <div>Agent Skills</div> <img class="link_preview_image" alt="Agent Skills Overview - Agent Skills" src="https://memo.miantiao.me/static/https://cdn4.telesco.pe/file/cCFVWhRrA1RcaXcJsCKyU7eBjRYZPG2TPp2JhVyaG02DK_MARyQy28nv0ToDlgwnVuh5W0MnG_Y9PKa2CHYkeLW4GhkX_t3Uz3zXRzN4Yq2Ja8nzwNOIvaxwGAJfDqxkO14T03nNArhp_LVMMUS5gWvXhcslXU02-Axlq1_Nl1nj7RBckWzNyhOv0T-P-YdCjzMVkeK0_-w5xWFfrGgTa7_R-iCgWuVQR2L2ESEXM-Vi3pI_2VZAcSF1Y0NJDutON8J5sgdELrd0kgn1rKj0NlvEZCGhgWAMCT4d7KWoleQ7ljazHY-PHNbKrmKb1VXq-adwZ054wpeO4uD4fuQdpg.jpg" width="1200" height="630" loading="eager" /> <div>Agent Skills Overview - Agent Skills</div> <div>A standardized way to give AI agents new capabilities and expertise.</div> </a>https://localhost/posts/40https://localhost/posts/40Wed, 26 Nov 2025 15:38:12 GMT<b>如何编写出色的 </b><code>agents.md</code><b> 文件？</b><br /><b>GitHub 分析超 2500 个仓库的经验总结</b><br /><br />GitHub Copilot 新推出的自定义代理功能，允许你通过 <code>agents.md</code> 文件构建专属的 AI 专家团队，例如 <code>@docs-agent</code> (文档工程师) 或 <code>@test-agent</code> (测试工程师).<br /><br />然而，大多数代理文件因指令模糊而效果不佳。“你是一个有用的编程助手” 这类宽泛的描述是行不通的.<br /><br />GitHub 团队通过分析超过 2500 个 <code>agents.md</code> 文件，总结出了编写高效代理的关键要素：<i>为 AI 提供具体的操作手册，而不是模糊的提示</i>。<br /><br /><b>成功的 </b><code>agents.md</code><b> 文件都具备以下特点：</b><br /><br /><b>1. 明确角色与专长</b><br /><blockquote>清晰定义代理的身份，例如：“你是一名测试工程师，为 React 组件编写测试”.<br /></blockquote><br /><b>2. 提供可执行命令</b><br /><blockquote>将 <code>npm test</code>, <code>pytest -v</code> 等具体命令放在前面，代理会频繁引用它们.<br /></blockquote><br /><b>3. 代码范例优于解释</b><br /><blockquote>一个真实的代码片段比三段描述更能清晰地传达你的代码风格.<br /></blockquote><br /><b>4. 设定清晰的边界</b><br /><blockquote>明确告知 AI <b>不</b>能做什么，例如：“绝不提交密钥”、“不要修改 <code>src/</code> 目录下的源代码”.<br /></blockquote><br /><b>5. 详细说明技术栈</b><br /><blockquote>使用 “React 18 with TypeScript, Vite, and Tailwind CSS”，而不是笼统的 “React project”.<br /></blockquote><br /><b>6. 覆盖六大核心领域</b><br /><blockquote>命令、测试、项目结构、代码风格、Git 工作流和边界.<br /></blockquote><br /><b>如何开始？</b><br />从一个简单的任务开始，比如编写单元测试或修复 lint 错误. 你可以让 Copilot 帮助生成初始的 <code>agents.md</code> 文件，然后在此基础上进行迭代优化.<br /><br /><a href="https://github.blog/ai-and-ml/github-copilot/how-to-write-a-great-agents-md-lessons-from-over-2500-repositories/" target="_blank">原文链接</a><br /><br /><a href="/search/result?q=%23GitHub">#GitHub</a> <a href="/search/result?q=%23Copilot">#Copilot</a> <a href="/search/result?q=%23AI">#AI</a> <a href="/search/result?q=%23Agents">#Agents</a> <a href="/search/result?q=%23Developer">#Developer</a><a href="https://github.blog/ai-and-ml/github-copilot/how-to-write-a-great-agents-md-lessons-from-over-2500-repositories/" target="_blank"> <div>The GitHub Blog</div> <img class="link_preview_image" alt="How to write a great agents.md: Lessons from over 2,500 repositories" src="https://memo.miantiao.me/static/https://cdn4.telesco.pe/file/dPm9GJ5PDrD_VSZNCmL--bBOi312Z-8zD0bxjwxJ45Nvf5dvUd1B-lhgsP6yR6iS9f9cMLFudBkN2IAyIiMtp_qFYjRlzyqLeT-mfR7udI6tpmgl5Ka0PQaGi_0N8E-gWL9oVwktL_z0XTwn9Dzydp9QRoskBPRrxyY8pIH_-6vOcm7w0dULmIw-51Q-G4aMIbsDjI-elRPiLgzsyUP670HdM8Ia1tJEHnUx3FjfEArTtOJKymjlZBMtMgdcGHAF9XpKp6OGPS71f9QUymwkygCRNx70O5D1r0to5m2nOjfVm6oQQf8lfaemLkDjI-V_xf0ltfFgxes1totfeXEDYw.jpg" width="1200" height="630" loading="eager" /> <div>How to write a great agents.md: Lessons from over 2,500 repositories</div> <div>Learn how to write effective agents.md files for GitHub Copilot with practical tips, real examples, and templates from analyzing 2,500+ repositories.</div> </a>