SuperAPI AI 工具集

agentic-development-principles

编程与开发

查看项目

更新于 10-15 19:53

技能介绍

用途:这是一套与 AI 智能体协作开发时遵循的通用原则,核心理念是“AI 是副驾驶,你是飞行员”——AI 放大开发者思考并接管重复工作,但最终决策权与责任始终归开发者。适用于与 AI 智能体开始协作、复杂任务前决定方案、建立上下文管理策略、复盘工作流、向队友介绍协作方式,以及采用新 AI 工具时套用基线原则。

主要能力(六大原则):

  1. 分而治之:AI 对小型清晰指令的表现远好于大型模糊任务。把“做个登录页”拆成 UI 组件、API 端点、认证逻辑、测试等可独立验证的步骤;采用分阶段实现(设计模型→核心逻辑→接口→测试→集成重构)。
  2. 上下文如牛奶:上下文需保持新鲜紧凑,旧信息会降低表现,混入多主题可能使性能下降最多 39%。策略包括单一用途会话、用 HANDOFF.md 交接(记录已完成、当前状态、下一步、失败尝试、注意事项)、监控上下文状态、控制会话长度与活跃文件数。
  3. 选择合适抽象层级:Vibe Coding(高层,看整体结构)用于快速原型与想法验证;Deep Dive(低层,逐行)用于修 bug、安全审查、性能优化与生产代码。原型约 80% 高层、生产代码约 70% 低层、修 bug 100% 低层。
  4. 自动化的自动化:同一任务重复 3 次以上就自动化,并自动化自动化过程本身。层级从手动复制、终端集成、语音输入、项目配置文件、自定义命令脚本,到用 Skills 自动化决策、用 hooks/guardrails 强制规则。
  5. 谨慎与速度平衡:计划模式先分析、审查后再执行,适合首次复杂任务、跨文件重构、架构变更、数据库迁移等难回滚工作;执行模式直接改代码跑命令,适合简单清晰、模式成熟、沙箱环境、易回滚工作。建议计划 70–90%、执行 10–30%,危险命令仅在隔离环境自动运行。
  6. 验证与反思:写测试(含边界情况)、通过 diff 视觉审查、创建草稿 PR、要求 AI 自我验证并汇总结果;检查功能、边界、安全、测试充分性与性能,并反思本次收获与可自动化项。

使用方式:作为协作基线原则在会话开始时套用;指令遵循“清晰、分步、可验证”的黄金法则。

限制:资料未提供具体安装命令、平台支持、收费或价格信息;原则中的比例与指标为建议值,实际效果因工具与项目而异。