Agentpit Prd

API 层能力（已有路由，可直接复用）：

GET  /api/v1/agents          Agent 列表（支持分页、分类筛选）
GET  /api/v1/agents/:id      Agent 详情
POST /api/v1/agents          创建 Agent
PUT  /api/v1/agents/:id      更新 Agent
GET  /api/v1/agents/:id/stats Agent 统计数据

然后询问：

基于以上能力，你想要构建什么功能？

第二轮：收集核心需求

提问：

1. 功能目标：这个功能主要解决什么问题？要达成什么效果？
2. 目标用户：这个功能是给谁用的？（普通用户 / 开发者 / 管理员）

第三轮：功能细化

根据功能类型（从 state.json 的 config.route_group 读取）针对性提问：

如果是用户功能页面 (platform)：

• 页面上需要展示哪些核心信息？
• 用户可以执行哪些操作（查看、编辑、删除、调用）？
• 需要列表页还是只要详情页？
• 是否需要实时数据更新？

如果是管理后台 (platform)/admin：

• 需要管理哪些数据实体？
• 需要哪些批量操作？
• 需要数据导出功能吗？

如果是公开营销页面 (marketing)：

• 页面的主要转化目标是什么？
• 需要哪些 SEO 关键词？
• 是否需要服务端渲染（SSR）以优化搜索引擎？

如果是纯 API 接口：

• 请求/响应的数据结构是什么？
• 是否需要分页？
• 是否需要 Rate Limiting（频率限制）？

第四轮：UI 设计偏好

提问：

1. 界面风格（单选）：

   • 简约现代（白色背景、灰色边框、简洁排版）
   • 数据展示型（表格、图表、数字为主）
   • 卡片式（卡片网格布局，适合列表展示）

2. 配色偏好（可选）：有特别偏好的主色调吗？

第五轮：需求确认

汇总展示需求摘要：

📋 功能需求摘要

功能概要：[描述]

核心功能：
- [功能点 1]
- [功能点 2]
- [功能点 3]

目标用户：[描述]

UI 风格：[风格描述]

确认以上需求是否正确？

更新 state.json

确认后，更新 .agentpit/state.json 的 prd 字段：

{
  "stage": "prd",
  "prd": {
    "summary": "功能概要描述",
    "features": [
      "功能点 1",
      "功能点 2"
    ],
    "target_users": "目标用户描述",
    "design_preference": "简约现代",
    "ui_layout": "卡片式列表"
  }
}

输出结果

✅ 功能需求已定义！

概要：[summary]

功能列表：
- [feature 1]
- [feature 2]

设计偏好：[design_preference]

已保存到 .agentpit/state.json

下一步：运行 /agentpit-dev 生成代码