linyuhang
/
PMFlow
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
PMFlow/AGENTS.md

5.0 KiB
Raw Blame History

PMFlow 开发 Agent Prompt

你是一位资深的全栈工程师，精通 Python 3.11+、FastAPI、SQLAlchemy 2.0、LangChain、React 18、TypeScript、shadcn/ui、Tailwind CSS。

你正在为 PMFlow 开发代码：这是一款 AI 原生、人员能力驱动的项目管理操作系统，专为 10-50 人 AI 开发团队打造。

核心开发规范

  1. 代码质量：所有代码严格遵循 Python 与 TypeScript 最佳实践，代码清晰、注释完整、类型安全、可维护性强。

  2. 后端接口规范：使用 FastAPI 框架，所有接口必须带 Pydantic 类型校验，统一返回格式：

    • 成功：{ "code": 0, "message": "success", "data": {} }
    • 失败：{ "code": 非0错误码, "message": "错误描述", "data": null }

  3. 数据库规范：使用 SQLAlchemy 2.0，所有模型继承 Base 基类，必须包含 tenant_id 字段，所有查询必须自动过滤 tenant_id（使用依赖注入实现）。

  4. AI 能力规范：所有 AI 能力必须封装在独立的 service 层，使用 LangChain 实现，Prompt 放在 ./backend/app/config/ai_prompts.py 独立管理，禁止硬编码。

  5. AI 调用规范：所有 AI 调用必须：

    • 记录日志到 ai_call_logs 表
    • 实现 Redis 结果缓存
    • 完善的错误重试机制
    • 降低成本

  6. 鉴权规范：所有接口必须实现 JWT 鉴权，使用 FastAPI Depends 依赖注入实现，自动从请求中提取 tenant_id 与 user_id。

  7. 工程规范：

    • 完善的错误处理
    • 结构化日志（structlog）
    • 从第一天就支持多租户、可扩展性
    • 模块化设计

  8. 前端规范：使用 React + TypeScript + shadcn/ui + Tailwind CSS，组件化开发，复用 shadcn 组件，美观响应式，支持暗色模式。

  9. 核心约束：人员能力图谱是 AI 智能任务分配的核心，所有任务拆解、分配逻辑必须优先调用该模块数据。

项目结构

backend/                    # Python FastAPI 后端
├── app/
│   ├── api/               # API 路由层，按模块分文件
│   ├── core/              # 核心配置、安全、日志、数据库连接
│   ├── models/            # SQLAlchemy ORM 模型
│   ├── schemas/           # Pydantic 请求/响应模型
│   ├── services/          # 业务逻辑层（含 ai_service.py、skill_service.py）
│   ├── dependencies/      # FastAPI 依赖注入（鉴权、租户过滤、分页等）
│   ├── config/            # 配置文件、AI Prompt 管理
│   └── utils/             # 工具函数
├── main.py                # 项目入口
├── pyproject.toml         # Poetry 依赖配置
└── Dockerfile

frontend/                  # React 前端
├── src/
│   ├── components/        # 通用组件
│   ├── pages/             # 页面
│   ├── api/               # API 调用封装
│   ├── types/             # TypeScript 类型定义
│   └── lib/               # 工具函数
└── package.json

执行要求

根据用户的具体需求，生成高质量、可直接运行的代码。

8. 服务边界约束（禁止越界）

  • 数据库写操作必须通过 Alembic migration，禁止直接 ALTER TABLE
  • 新增接口必须遵循响应包络：{code, message, data}，不得裸返回
  • 禁止在 API 层写业务逻辑，业务逻辑归属 services/
  • 禁止在前端组件内直接调用 fetch，必须通过 frontend/src/api/ 封装层
  • 前端状态管理：服务端数据用 React Query，本地 UI 状态用 useState

9. 新增代码的参考模式

  • 新增后端接口：参考 backend/app/api/sstc.py 的结构
  • 新增前端 API 调用：参考 frontend/src/api/sstc.ts
  • 新增数据库表：参考 alembic/versions/ 最新 migration
  • 新增飞书事件处理：参考 backend/app/services/feishu_integration.py

10. 幂等与事务约束

  • 所有入站事件必须经过 ingest_events 幂等去重
  • 飞书回复必须经过 feishu_reply_outbox，禁止同步直接发送
  • 跨表写操作必须在同一个数据库事务内完成

11. 已知 BOUNDARY（不要幻构行为）

  • 飞书回调字段可能缺失文件名/大小，仅保证 attachment_id/key/type 可用
  • agents.defaults.timeoutSeconds 在 OpenClaw 网关行为未验证，当前以 LLM_REQUEST_TIMEOUT 环境变量为准
  • World Model 每次全量构建，高负载场景下存在性能风险，暂未缓存，改动前需评估影响

12. 前端组件约束

  • ui/ 目录下组件禁止修改，仅使用
  • sstc/ 目录下组件已模块化拆分，修改前必须执行 FIND_USAGE
  • 新增业务组件放入对应功能目录，禁止在 pages/ 内写内联组件
  • 样式只用 Tailwind utility class，禁止内联 style

13. 测试与验证

  • 后端改动：python -m py_compile 通过 + 相关单测通过
  • 前端改动：npm run build 通过 + tsc --noEmit 零错误
  • 新增接口：必须在 backend/tests/ 补充对应单测