vibe-coding

氛围编程

氛围编程意味着由你掌舵，Agent 协助你交付。你不必一开始就精通所有内容——你需要的是紧密的迭代循环、诚实的检查，以及在恰当时机提供恰到好处的少量上下文。这适用于任何项目。

习惯

1. 切分出最小的可交付变更。一个功能、一种故障模式、一个界面——无论什么，只要能让下一步一目了然。
2. 实现时参考合适的资料：项目技能、框架文档或官方 API 页面，而不是聊天中一大堆临时规则。
3. 验证后再宣布完成：运行测试、脚本、代码检查工具，或用户可以复现的步骤。如果什么都没运行，请说明应该运行什么。
4. 迭代。除非用户明确提出，否则避免一次性提交混合认证、UI 和数据的大型差异。

技能与长提示词

• 优先使用简短的领域技能（或指向权威文档的链接），而不是每次会话都粘贴同一段冗长指令。
• 如果 Agent 总在猜测某个库的 API，请阅读最新文档（或专用技能），不要根据训练数据即兴发挥。

生态系统：分开处理各层

• 应用和 UX（框架、组件、无障碍、设计、路由）：使用针对该层的技能或文档。可浏览的示例包括 skills.sh 和团队提供的资源。
• 数据和 API（数据库、HTTP 客户端、模型／语音／翻译服务提供商）：使用该产品的官方参考文档或特定提供商的技能。不要把 UI 技能中的 HTTP 调用示例照搬到实际客户端中，除非已确认它们符合真实规范。
• 模型、语音、翻译或视觉功能：像对待其他 API 一样处理——供应商文档和提供商技能优先于通用聊天猜测。

易踩的坑

问题	应对方法
过时或虚构的 API	打开当前项目文档或提供商文档；不要只相信记忆。
某个技能的示例误用于错误的层	React 技能中的 fetch 代码片段并不自动适用于你的模型 API——请根据正确的规范进行核对。
每次请求都粘贴一大段内容	精简为技能、文档链接或几条要点；库发生变化时及时更新。
“大爆炸式”重构	拆分、验证、重复。