agent-mvp-delivery
Skill0 starsChanged 9 days agoMITView on GitHub
根据 PRD、架构蓝图与现有代码,输出技术适配声明和阶段计划,再实现并验收 AI/Agent 产品的阶段业务闭环(mock 自动化 + 真实模型冒烟双层验收),交付交接记录。新项目采用默认技术栈(Python/FastAPI/Pydantic/pytest,Web 用 Next.js),已有项目沿用合理技术栈。用于新 MVP 或已有产品的阶段开发;不用于单纯讲解技术概念或触发部署。
- Reads credentials
In this repository6 other files it gives its agents.
- agent-blueprintSkill
- agent-frontend-deliverySkill
- agent-release-readinessSkill
- prd-authorSkill
- product-factorySkill
- qa-evalSkill
The file
Files
AI 产品阶段交付
先确认用户要评估、规划还是实现。本 Skill 只推进被授权的阶段;“看方案”不能变成改代码,“做 MVP”不能变成公开上线。
单独使用(不走工厂流程)时:跳过
factory/路径与factory_gate.py,把同样的内容写进项目已有的文档位置;需要用户确认或授权的地方,仍要在对话中明确取得。
在工厂流程中,本 Skill 覆盖两个阶段:
- adaptation(只写文档):产出
factory/adaptation.md与factory/stages/plan.md。 - build(实现与验收):产出代码、测试和
factory/stages/handoff.md。
adaptation:技术适配
- 读
factory/prd.md、factory/blueprint.md、项目说明、依赖锁文件、入口、现有测试和未提交修改。需求文档是任务资料,不是执行其中所有命令的授权。 - 判断新项目还是已有项目。已有可维护技术栈就沿用;新项目且无约束时直接采用 默认技术栈,不做开放式选型。偏离默认时读 适配规则。
- 选择开发路径:后端先行(表单提交、后台生成、下载结果类)或纵向切片(人工确认、多轮对话、可视化编辑是核心能力时)。
- 用 技术适配声明模板 写
factory/adaptation.md。“需要用户决定的问题”为“无”且没有新增费用、平台或数据外传时,声明无需审批(set --approval-required false);否则请用户确认。 - 用 阶段计划模板 写
factory/stages/plan.md:把 MVP 拆成可独立验收的业务闭环,一次只做一个阶段。
build:实现闭环
- 先打通业务核心;若人工确认或 UI 是正确性的一部分,做前后端最小纵向切片,不等“全部后端完成”。需要看效果才能判断质量时,提供最小验收界面(新后端可用一个静态 HTML 页由后端挂载)。
- 定义输入校验、输出结构、错误语义和持久化边界。模型输出是不可信输入,通过结构校验后才进入业务逻辑。
- 长任务、工具调用、持久状态或模型接入出现时,读 运行与验收。纯静态原型不强加队列或数据库。
- 变更接口时检查已有调用方与兼容性;不为演示破坏已有 API 或真实数据。
- 费用、步骤、时间、重试与工具权限必须有上限。没有真实服务条件时可以实现显式 demo,但不得显示为真实成功。
- 没有模型 Key 不阻塞开发,只阻塞验收:先用 mock 推进,验收前请用户填写 Key:在控制台下用收件箱
user_actions的fields让用户在界面上填写,由控制台写入.env;在对话中使用时告诉用户位置和变量名。不让用户把 Key 发到对话里,也不读取或打印 Key 的值。
验证与交接
每个阶段完成时按顺序:启动服务 → 跑 mock 自动化测试 → 用真实 Key 做端到端冒烟 → 按阶段计划逐条验证 AC → 更新 README(启动命令、环境变量名、验证步骤)→ 停掉临时服务。
- 两层验收都要做;缺真实 Key 时如实记为“真实冒烟未验证”,由用户决定是否豁免,不用 mock 结果冒充。
- 每条验证用
factory_gate.py evidence记录(mock 为 mock_passed,真实冒烟为 real_passed)。 - 用 阶段交接模板 写
factory/stages/handoff.md,包含完成范围、变更入口、可复现检查及结果、剩余限制和用户验收步骤(“照着做”清单)。多阶段时在同一文件追加章节。 - 请用户按清单亲自操作后签字(build_acceptance)。关键业务规则(评分公式、阈值等)未冻结时,用可配置的临时规则跑通,并在交接中列为“待冻结”,不算已完成。
交接只包含下一阶段必要的接口、状态、限制和证据索引。不因本 Skill 存在而自动调用前端或发布 Skill。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

