Loading...
Loading...
与AI Agent协作的智能体开发通用原则。定义了分而治之、上下文管理、抽象层级选择、自动化理念。适用于所有AI编码工具。
npx skill4agent add supercent-io/skills-template agentic-development-principles"AI是副驾驶，你才是主角" AI Agent是为了放大开发者的思路并替代重复工作，但最终的决策权和责任始终在开发者手中。
| 错误示例 | 正确示例 |
|---|---|
| "帮我做一个登录页面" | 1. "创建登录表单UI组件" |
| 2. "编写登录API端点" | |
| 3. "连接认证逻辑" | |
| 4. "编写测试代码" | |
| "帮我优化这个应用" | 1. "分析性能瓶颈" |
| 2. "优化数据库查询" | |
| 3. "减小前端打包体积" |
1阶段：模型/架构设计与验证
2阶段：核心逻辑实现（最小功能）
3阶段：API/接口连接
4阶段：编写并执行测试
5阶段：集成与重构会话1：处理认证系统
会话2：处理UI组件
会话3：编写测试代码
会话4：DevOps/部署工作# HANDOFF.md
## 已完成工作
- ✅ 实现用户认证API
- ✅ 编写JWT令牌发放逻辑
## 当前状态
- 正在处理令牌刷新逻辑
## 下一步工作
- 实现刷新令牌
- 添加登出端点
## 尝试过但失败的操作
- Redis会话存储集成失败（网络问题）
## 注意事项
- 注意与现有会话管理代码冲突| 指标 | 推荐值 | 操作 |
|---|---|---|
| 会话长度 | 保持合理水平 | 过长时生成HANDOFF.md |
| 主题数量 | 1个（单一目标） | 新主题开启新会话 |
| 活跃文件 | 仅保留必要文件 | 移除不必要的上下文 |
| 模式 | 说明 | 使用时机 |
|---|---|---|
| Vibe Coding | 只看整体结构的高层级 | 快速原型开发、想法验证、一次性项目 |
| Deep Dive | 逐行钻研代码的低层级 | 修复Bug、安全审查、性能优化、生产代码开发 |
添加新功能时：
1. 高层级抽象："帮我做一个用户资料页面" → 掌握整体结构
2. 中层级抽象："展示资料编辑表单的验证逻辑" → 审查特定功能
3. 低层级抽象："解释为什么这个正则表达式无法通过邮箱验证" → 细节调试如果同一工作重复3次以上 → 寻找自动化方法
连自动化的过程本身 → 也要自动化| 层级 | 方式 | 示例 |
|---|---|---|
| 1 | 手动复制/粘贴 | 将AI输出复制到终端 |
| 2 | 终端集成 | 直接使用AI工具 |
| 3 | 语音输入 | 语音转写系统 |
| 4 | 重复指令自动化 | 利用项目配置文件 |
| 5 | 工作流自动化 | 自定义命令/脚本 |
| 6 | 判断自动化 | 利用Skills |
| 7 | 规则强制自动化 | 利用Hooks/防护机制 |
"帮我编写这个函数的测试，要包含边缘案例。""帮我用这些变更创建一个Draft PR""帮我重新检查刚才生成的代码。
验证所有内容，并在最后用表格整理验证结果。"| 原则 | 核心 | 实践 |
|---|---|---|
| 1. 分而治之 | 小而明确的单元 | 拆分为可独立验证的步骤 |
| 2. 上下文管理 | 保持新鲜 | 单一目标会话、HANDOFF.md |
| 3. 抽象层级选择 | 适配场景的深度 | 调整Vibe ↔ Deep Dive模式 |
| 4. 自动化的自动化 | 消除重复 | 重复3次则自动化 |
| 5. 规划/执行平衡 | 优先谨慎 | 规划70-90%，执行10-30% |
| 6. 验证与复盘 | 确认输出 | 测试、审查、自我验证 |
"要真正掌握AI工具，必须充分使用它"
向AI下达指令时：
1. 明确具体（Specific）
2. 分步执行（Step-by-step）
3. 可验证（Verifiable）