SuperAPI AI 工具集

ai-agent-prd

智能体与模型

查看项目

更新于 10-16 02:36

技能介绍

该技能用于为 AI Agent 产品编写完整 PRD,强调不仅定义智能体做什么,还要定义它如何思考、决策与行动。它扩展通用 PRD 写作指南,要求在每项能力上应用七视角,遵循其写作风格,并以开发者测试作为质量标准;产出的 Agent PRD 可交给 prd-to-engineering-spec 做技术设计,后者含 Agent 专项验证分支。核心思路是把传统“输入→确定性逻辑→输出”改为“目标→感知→思考→决策→行动→学习”的闭环。

主要能力按七个阶段组织:一是智能体身份,定义角色、使命、边界与用户关系模型(Copilot、Autopilot、Peer、Expert、Executor);二是能力架构,规范技能、工具、记忆、RAG 与工作流,并给出检索分块、嵌入、top-k、重排、质量阈值、知识缺口与来源冲突处理;三是行为与系统提示,涵盖推理策略(ReAct、先规划后执行、思维树、反思)和决策优先级,系统提示设计规格为核心交付物;四是黄金对话,按场景类型设计示例对话作为验收标准与评估数据集;五是安全与护栏,含能力边界、人工介入、输入输出护栏与错误处理;六是评估框架,含任务成功、质量、安全、效率、体验指标及自动测试、人工评估、LLM-as-Judge、红队、A/B 测试;七是运营模型,含成本、扩展与迭代。

使用方式:运行 bash scripts/generate_agent_prd_skeleton.sh ./docs/agent-prd "Customer Support Agent" 生成文档骨架,按 references 中模板填写,再用清单校验完整性;骨架生成器会写入一组 .md 文件,应使用新空目录避免覆盖。输出结构包含 AGENT_PRD.md、IDENTITY.md、USE_CASES.md、SKILLS.md 等十余个文件。限制:资料未提供具体定价、平台兼容性或实际效果说明;属性、能力与流程细节需以 references 文件为准。