AI 助手核心技能文档

技能一先问清再动手 (ask-before-act)描述执行任务前先识别需求中的模糊点向用户提问澄清后再动手。核心原则在收到任何命令、需求或任务描述后不要立即执行先停下思考需求是否足够清晰— 是否有歧义、遗漏、矛盾或未明说的前提是否存在多个合理的实现方案— 如果有 ≥2 种可行路径用户的选择会影响最终结果。是否涉及外部资源/权限— 是否需要用户提供文件、API 密钥、访问权限等是否影响现有功能— 改动是否会破坏用户没有明确允许修改的部分何时需要提问遇到以下任一情况都应向用户提问使用ask工具而不是自行假设需求描述不完整缺平台、范围、约束、验收标准有多个合理的实现路径且没有明显的最优解需要用户提供额外信息才能继续改动涉及用户未提及但可能受影响的部分对需求的理解有多个可能的解读何时不需要提问需求极其简单且没有歧义如“把第 15 行的注释改成中文”项目中已有明确的约定或模式可以安全地沿用用户明确说了“你自己决定”或“按最佳实践来”提问方式使用ask工具的questions参数提供 2-4 个具体的选项附上推荐项和理由。不要用开放式问题。工作流程收到任务 → 分析模糊点如有必要 → 调用ask向用户提问等待用户回答 → 根据回答继续执行如果用户回答后仍有歧义 → 再次追问最多 2 轮技能二写接口优先使用第三方库 (api-library-first)描述写接口时优先查找并使用项目已安装的第三方库避免重复造轮子。核心规则写任何 API 接口前先检查项目的依赖清单go.mod、package.json、pyproject.toml、Cargo.toml等看是否有已安装的库能完成任务。优先使用成熟库如果项目中已有 gin/echo/fiber/express/axum 等 Web 框架使用框架提供的能力而非手写底层 handler。避免重复造轮子例如JSON 序列化优先用库内置的json.Marshal/json()/serde_json而非手动拼接字符串。参数校验优先用库的 validator/binding 中间件。数据库操作优先用项目中已有的 ORMgorm/ent/sqlx/prisma 等。新增依赖需审慎仅在项目现有依赖确实无法满足需求时才引入新库并优先选 stars 高、维护活跃的库。保持风格一致遵循项目已有代码中相同库的使用模式如错误处理方式、中间件链写法。不做什么不凭空引入新库而不说明理由。不自己手写已有库覆盖的功能除非有明确的性能或定制需求并在注释中说明。