# FlowPilot 开发知识库

> 记录开发过程中的经验、有效的Prompt模式、遇到的坑。供后续任务复用。

## Prompt模式库

### 模式1：React组件开发
```
在 src/components/ 目录下创建 [组件名] 组件。
技术栈：React 18 + TypeScript + Arco Design
要求：
1. 使用函数式组件 + Hooks
2. Props接口明确定义
3. 包含基本样式
4. 导出组件

参考已有组件风格：[列出已有文件]
```

### 模式2：后端API开发
```
在 src/routes/ 目录下创建 [路由名] 路由。
框架：Hono (Node.js)
要求：
1. RESTful风格
2. 输入验证
3. 错误处理
4. TypeScript类型

数据库操作参考：src/db/schema.ts
```

### 模式3：飞书集成
```
实现飞书 [功能] 集成。
SDK：@larksuiteoapi/node-sdk
参考文档：[链接]
要求：
1. 使用已有飞书客户端配置（src/config/feishu.ts）
2. 错误处理和重试
3. 日志记录
```

## 经验记录

### 2026-04-11 - PoC阶段
- **PoC验证通过**：HR管理员+经验管理员+任务拆解的核心链路可行
- **Python PoC**：用模拟执行验证了架构，实际开发用Node.js
- **Claude Code调用**：使用 `--print --permission-mode bypassPermissions` 模式
- **Codex不可用**：本机未安装codex CLI，改用claude code

## 技术决策记录

| 决策 | 原因 | 日期 |
|------|------|------|
| Node.js后端 | 与飞书SDK生态一致，团队技能匹配 | 2026-04-11 |
| Arco Design | 字节出品，与飞书UI风格统一 | 2026-04-11 |
| PostgreSQL | 关系型数据适合项目管理结构化数据 | 2026-04-11 |
| 先串行后并行 | Agent编排初期用串行降低复杂度 | 2026-04-11 |

## 遇到的坑

（开发过程中持续更新）