通过对话定义 AgentPit 功能需求,根据功能类型针对性提问,更新 state.json
通过对话式交互帮助开发者明确功能需求,根据已选功能类型针对性提问。
工具使用: 收集用户输入时使用 AskUserQuestion 工具,支持单选和多选问题。
检查 .agentpit/state.json 是否存在
请先运行 /agentpit-init 初始化功能配置检查 stage 字段
stage == "init" → 正常继续 PRD 对话stage == "prd" 或 "ready" → 询问:已有需求定义,是否要重新定义?读取 state.json 中的配置,展示可用的数据和功能:
数据层能力(可直接查询的 Prisma model):
| 能力 | 数据来源 |
|---|
| 说明 |
|---|
| 用户信息 | User | 邮箱、名称、角色、余额 |
| Agent 列表与详情 | Agent | 名称、分类、价格、状态、评分 |
| 调用统计 | UsageLog | 调用次数、响应时间、Token 用量、费用 |
| 收藏与评价 | AgentFavorite / AgentReview | 用户行为数据 |
| 应用与 API Key | Application / ApiKey | 开发者数据 |
| 评测报告 | AgentEvaluation | 准确率、速度、成本评分 |
| 排行榜 | Leaderboard | 综合/准确率/速度/人气排名 |
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 统计数据
然后询问:
基于以上能力,你想要构建什么功能?
提问:
根据功能类型(从 state.json 的 config.route_group 读取)针对性提问:
如果是用户功能页面 (platform):
如果是管理后台 (platform)/admin:
如果是公开营销页面 (marketing):
如果是纯 API 接口:
提问:
界面风格(单选):
配色偏好(可选):有特别偏好的主色调吗?
汇总展示需求摘要:
📋 功能需求摘要
功能概要:[描述]
核心功能:
- [功能点 1]
- [功能点 2]
- [功能点 3]
目标用户:[描述]
UI 风格:[风格描述]
确认以上需求是否正确?
确认后,更新 .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 生成代码