呜啦！日常碎碎念，偶尔掉落优质前端博文推荐、学习资源等
网页：https://tg.cosine.ren
本频道的搜索Bot 来辣 👉 @cosSearchBot
私聊直接发消息就可以搜索啦～
🔖tags
#优质博文 #资源推荐 #博客更新 #碎碎念 #项目更新 #手工 #书摘 #阮一峰的科技周刊 #新动态
图频：Cosine 🎨 Gallery @CosineGallery
猫片： @cosine_cat
联系频道主：@cosine_yu
网页：https://tg.cosine.ren
本频道的搜索Bot 来辣 👉 @cosSearchBot
私聊直接发消息就可以搜索啦～
🔖tags
#优质博文 #资源推荐 #博客更新 #碎碎念 #项目更新 #手工 #书摘 #阮一峰的科技周刊 #新动态
图频：Cosine 🎨 Gallery @CosineGallery
猫片： @cosine_cat
联系频道主：@cosine_yu
#优质博文 #AI #prompt #agents
How to write a great agents.md: Lessons from over 2,500 repositories
[以下是方便搜索索引的大纲 (AI 生成)，请读原文]
author Matt Nigh
How to write a great agents.md: Lessons from over 2,500 repositories
AI 摘要：本文分析了超过 2500 个公开仓库中的 agents.md 文件，归纳出优秀自定义代理（Custom Agent）的关键写法：让每个代理具备明确角色、具体命令、严格边界与真实示例。成功的代理不是“通用助手”，而是专职专家，如 @docs-agent 负责文档、 @test-agent 负责测试。掌握六个核心领域（命令、测试、项目结构、代码风格、Git 工作流、边界）即可写出高效 agent 文件。
[以下是方便搜索索引的大纲 (AI 生成)，请读原文]
1. 背景与概念
• GitHub 推出新特性：以 agents.md 文件定义自定义代理（Custom Agent），让 Copilot 从通用助手变成具备明确角色的团队成员。
• 每个代理文件定义 persona（角色设定）、技能栈 (tech stack)、可操作命令、代码风格、及禁止行为。
2. 从 2500+ 文件分析得到的经验
• 成功的 agents 明确任务（如 documentation、testing、security），而失败的往往太模糊。
• 要点总结：
• 早放命令：在文件开头就定义可执行命令（含参数/flag）。
• 示例优于解释：展示代码风格比写长篇说明更有效。
• 明确边界：清楚列出“能做”“需确认”“禁止”的操作。
• 标注技术栈：注明版本与依赖，如 “React 18 + TypeScript + Vite + Tailwind CSS”。
• 六大领域覆盖：commands、testing、project structure、code style、git workflow、boundaries。
3. 优秀 agents.md 示例解构 (@docs-agent)
• 文件结构：YAML frontmatter 描述 → 角色与任务 → 项目知识 → 可用命令 → 写作准则 → 三层边界（Always / Ask first / Never）
• 成功原因：具体 persona、可执行命令在前、展示项目知识、有实例代码、边界分层清晰。
4. 构建你的第一个 agent
• 建议从小而具体的任务开始，如编写函数文档、添加单元测试、修复 linter 报错。
• 组成要素：名称、描述、persona 定义。
• Copilot 可辅助生成初稿，用 IDE 编辑 .github/agents/test-agent.md 并微调。
5. 实用代理类型推荐（六类）
• @docs-agent：生成文档，读 src/ 写 docs/。
• @test-agent：编写测试，永不删除失败测试。
• @lint-agent：执行格式修复，仅限风格层面修改。
• @api-agent：搭建 API 接口，修改数据结构需批准。
• @dev-deploy-agent：仅部署到开发环境，操作需批准。
• @security-agent（隐含）：执行安全分析或代码扫描。
6. 模板与最佳实践
• Starter template 提供完整结构：frontmatter、persona、project knowledge、tools、standards、boundaries。
• 强调命名规范、风格示例与边界设置的重要性。
7. 结论与启示
• 优秀 agent ≠ 冗长 prompt，而是清晰角色手册 (operating manual)。
• 核心在于：明确 persona、具体命令、真实样例、明确定义边界。
• 通过迭代完善 agent，让 Copilot 团队协作更像真实开发团队。
author Matt Nigh
The GitHub Blog
How to write a great agents.md: Lessons from over 2,500 repositories
Learn how to write effective agents.md files for GitHub Copilot with practical tips, real examples, and templates from analyzing 2,500+ repositories.
#AI #prompt #提示词
试了试，好玩儿
https://fixupx.com/hellokaton/status/1895718975402823855
katon (hellokaton)：今年开始学前端的人是什么感受？地狱开局🥲
在原贴基础上调整了一下提示词使用 tailwindcss 减少 token 消耗，加上分步处理（文件太大很容易失败）和设计优化，生成了一个社交APP试了下效果炸裂。
提示词我发这里了：
你是一位资深全栈工程师，参考 ui_ux_design 设计一个年轻会社交APP【我聊】，模拟产品经理提出需求和信息架构，请自己构思好功能需求和界面，然后设计 UI/UX。
仅支持暗色模式，要高级有质感（运用玻璃拟态等视觉效果），遵守设计规范，注重UI细节。
请引入 tailwindcss CDN 来完成，而不是编写 style 样式，图片使用 unslash，界面中不要有滚动条出现。
然后像上面那样给我所有页面的 html，写入到一个 sj.html 中（为每个页面创建简单的mockup边框预览，横向排列）。
由于页面较多，你每完成一部分就让我来确认，一直持续到结束。
试了试，好玩儿
https://fixupx.com/hellokaton/status/1895718975402823855
katon (hellokaton)：今年开始学前端的人是什么感受？地狱开局🥲
在原贴基础上调整了一下提示词使用 tailwindcss 减少 token 消耗，加上分步处理（文件太大很容易失败）和设计优化，生成了一个社交APP试了下效果炸裂。
提示词我发这里了：
你是一位资深全栈工程师，参考 ui_ux_design 设计一个年轻会社交APP【我聊】，模拟产品经理提出需求和信息架构，请自己构思好功能需求和界面，然后设计 UI/UX。
仅支持暗色模式，要高级有质感（运用玻璃拟态等视觉效果），遵守设计规范，注重UI细节。
请引入 tailwindcss CDN 来完成，而不是编写 style 样式，图片使用 unslash，界面中不要有滚动条出现。
然后像上面那样给我所有页面的 html，写入到一个 sj.html 中（为每个页面创建简单的mockup边框预览，横向排列）。
由于页面较多，你每完成一部分就让我来确认，一直持续到结束。
