Skip to content

Fairy-fly/ProjectPilot

Repository files navigation

ProjectPilot

ProjectPilot 是一个 AI 项目开发驾驶舱,用来管理 AI Agent 开发过程中的项目、提示词、任务清单、发布进度和验收标准。

它面向正在使用 Codex、Claude Code、Cursor 等 AI Agent 参与开发的个人开发者和小团队,帮助把一次次临时对话、开发指令、验收 checklist、版本推进记录沉淀成可复用的项目工作流。

为什么做这个项目

AI Agent 可以快速生成代码,但真实项目开发不只是一轮提示词。开发者还需要持续回答这些问题:

  • 当前有哪些项目正在推进?
  • 每个项目处在哪个版本、分支和阶段?
  • 哪些 Prompt 值得复用?
  • Agent 已经完成了什么任务,还有哪些验收项没过?
  • 一个版本是否已经具备发布条件?
  • 项目经验如何从一次协作沉淀成下一次可复用的流程?

ProjectPilot 的目标不是替代 Agent,而是成为 Agent 工作流的控制台:让开发过程可追踪、可复盘、可复用。

核心功能

  • 项目看板:集中查看活跃项目、风险信号、发布进度和下一步动作。
  • 项目详情:记录项目状态、当前阶段、版本、分支、风险等级和开发时间线。
  • Prompt 管理:保存 Codex / Claude Code 等开发指令,按功能、修复、UI、文档、Git、Review 等场景分类。
  • Agent 任务记录:围绕项目沉淀 Agent 协作过程中的任务、动作建议和复用经验。
  • Checklist 验收:按功能、UI、Git、安全、发布等维度管理验收项。
  • Release 进度追踪:用版本、tag、分支、阶段和完成度描述项目发布状态。
  • 项目开发流程沉淀:把零散的 AI 协作经验整理成长期可复用的开发资产。

技术栈

  • Next.js 16
  • React 19
  • TypeScript
  • Tailwind CSS 4
  • shadcn/ui
  • Framer Motion
  • lucide-react
  • 本地存储与前端状态管理

项目结构

ProjectPilot/
├─ src/
│  ├─ app/
│  │  ├─ (app)/
│  │  │  ├─ dashboard/      # 驾驶舱首页
│  │  │  ├─ projects/       # 项目列表与详情
│  │  │  ├─ prompts/        # Prompt 资产管理
│  │  │  ├─ checklists/     # 验收清单
│  │  │  └─ settings/       # 本地偏好设置
│  │  ├─ globals.css
│  │  ├─ layout.tsx
│  │  └─ page.tsx
│  ├─ components/
│  │  ├─ motion/            # 动效组件
│  │  ├─ ui/                # 基础 UI 组件
│  │  └─ *.tsx              # 业务展示组件
│  └─ lib/
│     ├─ mock-data.ts       # 示例项目数据
│     ├─ types.ts           # 领域类型
│     └─ utils.ts           # 通用工具
├─ docs/
│  └─ PRODUCT_OVERVIEW.md
├─ screenshots/
│  └─ README.md
├─ public/
├─ components.json
├─ next.config.ts
└─ package.json

本地运行

环境要求:

  • Node.js 20.9 或更高版本
  • npm

安装依赖:

npm install

启动开发服务器:

npm run dev

打开浏览器访问:

http://localhost:3000

常用命令:

npm run dev      # 启动本地开发服务器
npm run build    # 构建生产版本
npm run start    # 启动生产服务
npm run lint     # 运行 ESLint

使用流程

  1. 在 Dashboard 查看当前活跃项目、风险信号、待验收项和下一步动作。
  2. 在 Projects 中维护项目状态、版本、分支、当前阶段和发布进度。
  3. 在项目详情页跟踪开发时间线、关联 Prompt 和版本推进信息。
  4. 在 Prompts 中保存高质量 Agent 指令,并记录分类、评分、关联项目和复用建议。
  5. 在 Checklists 中逐项完成开发验收,覆盖功能、UI、Git、安全和发布准备。
  6. 在每轮迭代结束后,把有效 Prompt、验收标准和复盘结论沉淀为下一轮可复用资产。

产品截图

Dashboard

Dashboard

项目详情

项目详情

Prompt 管理

Prompt 管理

Checklist

Checklist

Release 进度

Release 进度

详见 screenshots/README.md

项目亮点

  • 为 AI Agent 开发过程设计,而不是通用 Todo 工具。
  • 将项目、Prompt、Checklist、Release 信息放在同一个工作台里。
  • 强调开发过程沉淀,帮助把一次性 Agent 对话转化为团队资产。
  • 适合本地优先使用,降低个人项目和早期产品的管理成本。
  • UI 风格偏工程驾驶舱,适合持续扫描项目状态和风险。

Roadmap

  • 完善项目 CRUD 与本地持久化体验。
  • 增加 Prompt 模板库与复用统计。
  • 支持 Agent 任务日志与对话摘要归档。
  • 增加 Release 版本页和发布检查流。
  • 支持导入 / 导出项目工作流数据。
  • 增加 Git 分支、commit、PR 状态集成。
  • 支持多项目复盘报告与开发节奏分析。
  • 未来探索云端同步与团队协作能力。

License

当前仓库暂未声明开源许可证。使用、分发或二次开发前,请先联系仓库作者确认授权范围。

About

AI project cockpit for managing prompts, agent tasks, checklists, and release progress.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors