场景方案库完全指南 —— 让 AI 真正理解你的工作流

场景方案
├── 📋 执行指引 (Commander) - 定义工作流程和步骤
├── 🤖 智能体 (Agent) - 具有专业角色的 AI 助手
├── 📚 技能 (Skill) - 领域知识和规范文档
└── 🔧 自定义工具 (Custom Tool) - 扩展 AI 的执行能力

---
name: 代码重构专家
description: 安全地重构代码，提升可读性和性能
agents: [code-analyzer, refactor-expert]
skills: [clean-code, solid-principles]
tools: [analyze_complexity, run_tests]
---

## 执行流程

1. 分析现有代码结构和复杂度
2. 识别可优化的代码模式
3. 制定重构计划
4. 逐步执行重构（保持测试通过）
5. 验证重构结果

## 注意事项

- 每次重构后运行测试确保功能正常
- 保持 Git commit 粒度小而清晰
- 遵循项目现有的代码风格

---
name: frontend-expert
displayName: 前端开发专家
description: 精通 React、Vue、TypeScript 的前端开发专家
model: main
tools: [read_files, edit_files, bash, web_search]
---

你是一位资深前端开发专家，专精于：

1. **React 生态系统**：React 18+、Next.js、状态管理
2. **TypeScript**：类型系统设计、泛型、类型推导
3. **性能优化**：代码分割、懒加载、缓存策略
4. **最佳实践**：组件设计、测试、可访问性

在回答问题时：
- 提供可运行的代码示例
- 解释设计决策的原因
- 考虑边缘情况和错误处理

skills/
└── code-standards/
    ├── SKILL.md           # 技能定义
    ├── references/        # 规范文档
    │   ├── naming.md      # 命名规范
    │   ├── structure.md   # 目录结构
    │   └── testing.md     # 测试要求
    └── templates/         # 代码模板
        ├── component.tsx  # React 组件模板
        └── service.ts     # 服务类模板

import { toolHelper } from '@/lib/custom-tool-sdk';
import { z } from 'zod';

export default toolHelper({
  name: 'jira_create_issue',
  description: '在 Jira 中创建工单',
  args: z.object({
    project: z.string().describe('项目 Key'),
    type: z.enum(['Bug', 'Task', 'Story']),
    title: z.string().min(1),
    description: z.string().optional(),
  }),
  permissions: ['net'],
  
  async execute(params) {
    const response = await fetch('https://jira.company.com/api/issue', {
      method: 'POST',
      body: JSON.stringify(params),
    });
    return await response.json();
  },
  
  renderToolResult(result) {
    return (
      <div className="p-3 bg-blue-50 rounded">
        <div>✅ 工单创建成功</div>
        <a href={result.url} className="text-blue-500">{result.key}</a>
      </div>
    );
  },
});

👤 创建一个新的 React 项目，名称是 user-portal

🤖 好的，我按「项目脚手架」方案来执行。
   
   1. 使用模板创建项目结构...
   2. 配置 TypeScript 和 ESLint...
   3. 初始化 Git 仓库...
   4. 安装依赖...
   
   ✅ 项目创建完成，已按团队规范配置好所有工具链。

👤 审查这个 PR 的代码

🤖 开始执行代码审查...
   
   📋 检查点：
   ● 代码规范  ○ 性能分析  ○ 安全检查  ○ 测试覆盖
   
   发现 3 个问题：
   1. ⚠️ components/Button.tsx:45 - 未处理加载状态
   2. 🔴 utils/api.ts:23 - SQL 注入风险
   3. 💡 services/user.ts:78 - 建议使用缓存
   
   详细说明和修复建议：...