pdf

TraeSkill 是一个标准化的 Prompt Context 与 AI 技能集合，专门为 Trae IDE 的 .trae/Skills 机制 设计。

它的目标是：

• 把「行业最佳实践」沉淀为可复用的 Skill（Markdown 规则文件）
• 让 AI 在 Trae 中不再是“通用聊天”，而是：

- 会写 PRD 的产品经理

- 懂架构与技术选型的架构师

- 熟悉 React/Flutter 性能优化的大前端工程师

- 懂自动化测试与 DevOps 的质量与运维专家

💡 快速查阅

• [常用开发技能及场景指南](./开发常用技能及场景指南.md)：推荐初学者优先阅读，快速掌握各阶段技能用法。
• [自然语言唤醒指南](./自然语言唤醒指南.md)：学习如何通过自然语言高效触发专家角色。
• [TraeSkill 从 0 到 1 开发蓝图 (PLAN.md)](../PLAN.md)：了解如何用本仓库支撑完整的研发流程。

---

仓库的核心在于 .trae/Skills 目录，每个子目录代表一个专业领域的 Skill 套件，例如：

• 00_Meta_Dispatcher：任务调度与蓝图生成中枢，负责解析需求、拆解阶段并路由到其他 Skill。
• 01_ProductManager_Brainstorming：产品需求梳理、用户故事拆解、竞品分析与 PRD 草案生成。
• 01_Architect_TechStackSelector：技术栈选型评估（性能、复杂度、团队熟悉度等）、方案对比与推荐。
• 02_Architect_APIDesign：REST / GraphQL API 设计规范、资源建模与接口契约梳理。
• 02_Designer_UIUXIntelligence：UI/UX 智能知识库：组件风格、配色、排版、交互模式、UX 准则等。
• 02_Designer_WebGuidelines：Web 可访问性、响应式设计与通用前端 UI 规范审查。
• 03_Developer_ArtifactsBuilder：用于在 Trae 中快速生成前端 Artifact（如 React/Tailwind/shadcn UI 代码片段）。
• 03_Developer_ReactBestPractices：React/Next.js 性能与可维护性最佳实践：渲染优化、状态管理、数据获取模式等。
• 03_Mobile_Flutter：Flutter 架构（整洁架构、分层设计）、状态管理与性能调优相关参考与模板。
• 04_Tester_BrowserAutomation：基于浏览器自动化的端到端测试思路与脚本示例。
• 05_Backend_Node / 05_Backend_Python：后端工程实践：接口层设计、异步编程模式、性能优化与测试策略。
• 05_Backend_Database：数据库建模、索引设计、SQL 优化模式与迁移策略。
• 05_DevOps_GitWorkflow / 05_DevOps_GitOps：Git 分支模型、CI/CD 思路、GitOps 与 Kubernetes 相关实践。
• 06_Office_Docx：面向文档自动化处理（docx/ooxml）的技能与参考规范。

你可以将其理解为：这是一个按“角色/环节”组织的 AI 专家团队，每个目录就是一位长期在线的专家顾问。

---

TraeSkill 在 Trae IDE 中的工作流

```mermaid

flowchart LR

U[开发者提问] --> T[Trae IDE]

T --> I[索引 .trae/Skills 目录]

I --> D[00_Meta_Dispatcher 调度中心]

D --> P[01_ProductManager_Brainstorming
产品需求与脑暴]

D --> A[01_Architect_TechStackSelector
架构与技术选型]

D --> F[03_Developer_ReactBestPractices
前端/React 最佳实践]

D --> B[05_Backend_Node / Python
后端实现]

D --> QA[04_Tester_BrowserAutomation
测试与自动化]

D --> O[05_DevOps_GitWorkflow / GitOps
运维与发布]

P --> OUT[面向开发者的回答]

A --> OUT

F --> OUT

B --> OUT

QA --> OUT

O --> OUT

```

Skill 分类概览（按生命周期分组）

```mermaid

flowchart TB

Core[TraeSkill 核心 Skill
.trae/Skills] --> Product[产研设计
00/01/02 开头]

Core --> Dev[前后端开发
03/05 开头]

Core --> QAOps[测试与运维
04/05 开头]

Core --> Docs[文档自动化
06_Office_Docx]

Product --> P1[00_Meta_Dispatcher
需求拆解与调度]

Product --> P2[01_ProductManager_Brainstorming]

Product --> P3[01_Architect_TechStackSelector / 02_Architect_APIDesign]

Product --> P4[02_Designer_UIUXIntelligence / WebGuidelines]

Dev --> D1[03_Developer_ArtifactsBuilder / ReactBestPractices]

Dev --> D2[03_Mobile_Flutter]

Dev --> D3[05_Backend_Node / Python / Database]

QAOps --> Q1[04_Tester_BrowserAutomation]

QAOps --> Q2[05_DevOps_GitWorkflow / GitOps]

Docs --> Doc1[06_Office_Docx]

```

---

TraeSkill 覆盖了从“想做什么”到“如何上线”的完整软件开发生命周期：

🧠 Product & Design (产研设计)

• Product Manager：PRD 生成、需求澄清、范围界定、用户故事拆解。
• UI/UX Designer：设计系统、组件化思维、配色与排版、Web 体验准则。

🏗 Architecture & Backend (架构与后端)

• System Architect：系统边界划分、领域建模、接口与数据库的协同设计。
• Backend Engineering：Node.js / Python 服务端模式、数据库迁移、SQL 优化、异步与性能调优。

💻 Frontend & Mobile (大前端)

• React Specialist：渲染性能优化、Hooks 最佳实践、Server Components / Data Fetching 模式。
• Flutter Expert：分层架构、状态管理、性能分析与调优策略。

🛡 Quality & Operations (质量与运维)

• Testing Automation：浏览器自动化测试、回归测试脚本思路、端到端验收。
• Security / DevSecOps：安全需求提取与代码审计规则。
• DevOps / GitOps：Git 工作流、CI/CD 思路、声明式部署与 GitOps 实践。

---

TraeSkill 利用了 Trae IDE 的原生 Skills 特性：

• 所有规则文件均位于 .trae/Skills 目录下，以 Markdown 形式组织。
• 当你在 Trae 中打开此项目，或将其中某些 Skill 目录复制到你自己的项目时：

- Trae 的 AI Agent 会自动索引这些 Skill 文件；

- 当你提问相关问题（如“优化这个 React 组件”）时，会优先查阅对应规则（如 03_Developer_ReactBestPractices）；

- 回答会自动带上这些领域知识，而无需你记住任何具体文件名。

你可以把它理解为：给 AI 预先塞了一整套“团队开发手册 + 经验库”，并由 Trae 帮你在对话时自动检索与应用。

---

1. 克隆仓库

```bash

git clone https://github.com/your-username/TraeSkill.git

```

1. 在 Trae 中打开

- 直接使用 Trae 打开 TraeSkill 目录；或

- 将 .trae/Skills 目录复制到你自己的项目根目录下。

1. 开始对话

- 示例问题：

- 「帮我设计一个用户登录系统的 API」

- 「检查这段 React 代码的渲染性能」

- 「根据这个原型，给我一份简单的 PRD」

- AI 将自动调用合适的 Skill（例如架构设计、React 最佳实践、产品脑暴等）。

1. 与 AgenticFlow-Skills 配合

- 如果你在其他编辑器中使用 AgenticFlow-Skills，可以在其中复用同名 Skill；

- TraeSkill 则是针对 Trae 使用场景进行的定制版，更适合作为 Trae 中的“原生技能库”。

---

Trae IDE, AI Skills, Prompt Engineering, Context Management, React Best Practices, Flutter Architecture, Automated Testing, System Design, GitOps, AI Agent.

---

MIT License