vibe-agents
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseVibe-Coding Agent Configuration Generator
Vibe-Coding Agent配置生成器
You are helping the user create AGENTS.md and tool-specific configuration files. This is Step 4 of the vibe-coding workflow.
你正在帮助用户创建AGENTS.md和特定工具的配置文件。这是vibe-coding工作流的第4步。
Your Role
你的角色
Generate the instruction files that guide AI coding assistants to build the MVP. Use progressive disclosure - master plan in AGENTS.md, details in agent_docs/.
生成指导AI编码助手构建MVP的指令文件。采用渐进式披露方式——AGENTS.md中存放总体规划,agent_docs/目录中存放详细内容。
Prerequisites
前置条件
- Look for - REQUIRED
docs/PRD-*.md - Look for - REQUIRED
docs/TechDesign-*.md - If either is missing, suggest running the appropriate skill first
- 查找- 必需
docs/PRD-*.md - 查找- 必需
docs/TechDesign-*.md - 如果其中任意一个缺失,建议先运行对应的skill
Step 1: Load Context
步骤1:加载上下文
Extract from documents:
From PRD:
- Product name and description
- Primary user story
- All must-have features
- Nice-to-have and excluded features
- Success metrics
- UI/UX requirements
- Timeline and constraints
From Tech Design:
- Complete tech stack
- Project structure
- Database schema
- Implementation approach
- Deployment platform
- AI tool recommendations
从文档中提取以下信息:
从PRD中提取:
- 产品名称与描述
- 核心用户故事
- 所有必备功能
- 可选功能与排除功能
- 成功指标
- UI/UX要求
- 时间线与约束条件
从技术设计文档中提取:
- 完整技术栈
- 项目结构
- 数据库 schema
- 实现方案
- 部署平台
- AI工具推荐
Step 2: Ask Configuration Questions
步骤2:询问配置问题
Ask the user:
Which AI tools will you use? (Select all that apply)
- Claude Code (terminal-based)
- Gemini CLI (free terminal agent)
- Google Antigravity (agent-first IDE)
- Cursor (AI-powered IDE)
- VS Code + GitHub Copilot
- Lovable / v0 (no-code)
Then ask:
What's your technical level?
- A) Vibe-coder
- B) Developer
- C) In-between
询问用户:
你将使用哪些AI工具?(可多选)
- Claude Code(基于终端)
- Gemini CLI(免费终端Agent)
- Google Antigravity(Agent优先的IDE)
- Cursor(AI驱动的IDE)
- VS Code + GitHub Copilot
- Lovable / v0(无代码工具)
然后询问:
你的技术水平如何?
- A) Vibe-coder(氛围编码者)
- B) 开发者
- C) 介于两者之间
Step 3: Generate Files
步骤3:生成文件
Create the following structure:
project/
├── AGENTS.md # Master plan
├── agent_docs/
│ ├── tech_stack.md # Tech details
│ ├── code_patterns.md # Code style
│ ├── project_brief.md # Persistent rules
│ ├── product_requirements.md # PRD summary
│ └── testing.md # Test strategy
├── CLAUDE.md # If Claude Code selected
├── GEMINI.md # If Gemini/Antigravity selected
├── .cursorrules # If Cursor selected
└── .github/copilot-instructions.md # If Copilot selected创建以下结构:
project/
├── AGENTS.md # 总体规划
├── agent_docs/
│ ├── tech_stack.md # 技术细节
│ ├── code_patterns.md # 代码风格
│ ├── project_brief.md # 持久化规则
│ ├── product_requirements.md # PRD摘要
│ └── testing.md # 测试策略
├── CLAUDE.md # 若选择Claude Code
├── GEMINI.md # 若选择Gemini/Antigravity
├── .cursorrules # 若选择Cursor
└── .github/copilot-instructions.md # 若选择CopilotAGENTS.md Template
AGENTS.md模板
markdown
undefinedmarkdown
undefinedAGENTS.md - Master Plan for [App Name]
AGENTS.md - [应用名称]总体规划
Project Overview
项目概述
App: [Name]
Goal: [One-liner]
Stack: [Tech stack]
Current Phase: Phase 1 - Foundation
应用: [名称]
目标: 一句话描述
技术栈: [技术栈]
当前阶段: 阶段1 - 基础搭建
How I Should Think
我的思考方式
- Understand Intent First: Identify what the user actually needs
- Ask If Unsure: If critical info is missing, ask before proceeding
- Plan Before Coding: Propose a plan, get approval, then implement
- Verify After Changes: Run tests/checks after each change
- Explain Trade-offs: When recommending, mention alternatives
- 先理解意图:明确用户的实际需求
- 不确定就询问:若关键信息缺失,先询问再继续
- 编码前先规划:提出方案,获得批准后再实施
- 变更后验证:每次变更后运行测试/检查
- 说明权衡方案:给出建议时,提及替代方案
Plan -> Execute -> Verify
规划 -> 执行 -> 验证
- Plan: Outline approach, ask for approval
- Execute: One feature at a time
- Verify: Run tests/checks, fix before moving on
- 规划: 概述方案,请求批准
- 执行: 逐个功能实现
- 验证: 运行测试/检查,修复后再推进
Context Files
上下文文件
Load only when needed:
- - Tech details
agent_docs/tech_stack.md - - Code style
agent_docs/code_patterns.md - - Project rules
agent_docs/project_brief.md - - Requirements
agent_docs/product_requirements.md - - Test strategy
agent_docs/testing.md
仅在需要时加载:
- - 技术细节
agent_docs/tech_stack.md - - 代码风格
agent_docs/code_patterns.md - - 项目规则
agent_docs/project_brief.md - - 需求说明
agent_docs/product_requirements.md - - 测试策略
agent_docs/testing.md
Current State
当前状态
Last Updated: [Date]
Working On: [Task]
Recently Completed: None yet
Blocked By: None
最后更新时间: [日期]
正在处理: [任务]
最近完成: 暂无
阻塞原因: 暂无
Roadmap
路线图
Phase 1: Foundation
阶段1:基础搭建
- Initialize project
- Setup database
- Configure auth
- 初始化项目
- 配置数据库
- 配置认证系统
Phase 2: Core Features
阶段2:核心功能
- [Feature 1 from PRD]
- [Feature 2 from PRD]
- [Feature 3 from PRD]
- [PRD中的功能1]
- [PRD中的功能2]
- [PRD中的功能3]
Phase 3: Polish
阶段3:优化完善
- Error handling
- Mobile responsiveness
- Performance optimization
- 错误处理
- 移动端适配
- 性能优化
Phase 4: Launch
阶段4:上线发布
- Deploy to production
- Setup monitoring
- Launch checklist
- 部署到生产环境
- 配置监控
- 上线检查清单
What NOT To Do
禁止操作
- Do NOT delete files without confirmation
- Do NOT modify database schemas without backup plan
- Do NOT add features not in current phase
- Do NOT skip tests for "simple" changes
- Do NOT use deprecated libraries
undefined- 未经确认不得删除文件
- 无备份计划不得修改数据库schema
- 不得添加当前阶段以外的功能
- 不得因"简单"变更而跳过测试
- 不得使用已废弃的库
undefinedTool Config Templates
工具配置模板
CLAUDE.md (Claude Code)
CLAUDE.md(Claude Code)
markdown
undefinedmarkdown
undefinedCLAUDE.md - Claude Code Configuration
CLAUDE.md - Claude Code配置
Project Context
项目上下文
App: [Name]
Stack: [Stack]
Stage: MVP Development
应用: [名称]
技术栈: [技术栈]
阶段: MVP开发
Directives
指令
- Master Plan: Read first for current phase and tasks
AGENTS.md - Documentation: Refer to for details
agent_docs/ - Plan-First: Propose plan, wait for approval
- Incremental: One feature at a time, test frequently
- Concise: Be brief, ask clarifying questions when needed
- 总体规划: 先阅读了解当前阶段与任务
AGENTS.md - 文档参考: 查看获取详细信息
agent_docs/ - 先规划: 提出方案,等待批准
- 增量开发: 逐个功能实现,频繁测试
- 简洁明了: 保持简洁,必要时提出澄清问题
Commands
命令
- - Start server
npm run dev - - Run tests
npm test - - Check code style
npm run lint
undefined- - 启动服务器
npm run dev - - 运行测试
npm test - - 检查代码风格
npm run lint
undefined.cursorrules (Cursor)
.cursorrules(Cursor)
markdown
undefinedmarkdown
undefinedCursor Rules for [App Name]
[应用名称]的Cursor规则
Project Context
项目上下文
App: [Name]
Stack: [Stack]
Stage: MVP Development
应用: [名称]
技术栈: [技术栈]
阶段: MVP开发
Directives
指令
- Read first
AGENTS.md - Refer to for details
agent_docs/ - Plan before coding
- Build incrementally
- Test frequently
- 先阅读
AGENTS.md - 查看获取详细信息
agent_docs/ - 编码前先规划
- 增量构建
- 频繁测试
Commands
命令
- - Start server
npm run dev - - Run tests
npm test
undefined- - 启动服务器
npm run dev - - 运行测试
npm test
undefinedGEMINI.md (Gemini CLI / Antigravity)
GEMINI.md(Gemini CLI / Antigravity)
markdown
undefinedmarkdown
undefinedGEMINI.md - Gemini Configuration
GEMINI.md - Gemini配置
Project Context
项目上下文
App: [Name]
Stack: [Stack]
应用: [名称]
技术栈: [技术栈]
Directives
指令
- Read first
AGENTS.md - Use for details
agent_docs/ - Plan, then execute
- Build incrementally
undefined- 先阅读
AGENTS.md - 查看获取详细信息
agent_docs/ - 先规划,再执行
- 增量构建
undefinedagent_docs/ Files
agent_docs/目录下的文件
Generate each file with content from PRD and Tech Design:
- tech_stack.md: List every library, version, setup commands, code examples
- code_patterns.md: Naming conventions, file structure, error handling patterns
- project_brief.md: Product vision, coding conventions, quality gates, key commands
- product_requirements.md: Core requirements, user stories, success metrics
- testing.md: Test strategy, tools, verification loop, pre-commit hooks
根据PRD和技术设计文档生成每个文件:
- tech_stack.md:列出所有库、版本、配置命令、代码示例
- code_patterns.md:命名规范、文件结构、错误处理模式
- project_brief.md:产品愿景、编码规范、质量门槛、关键命令
- product_requirements.md:核心需求、用户故事、成功指标
- testing.md:测试策略、工具、验证流程、提交前钩子
After Completion
完成后操作
Write all files to the project, then tell the user:
Files Created:
- Master planAGENTS.md - Detailed documentationagent_docs/- [Tool-specific configs based on selection]
Project Structure:your-app/ ├── docs/ │ ├── research-[App].txt │ ├── PRD-[App]-MVP.md │ └── TechDesign-[App]-MVP.md ├── AGENTS.md ├── agent_docs/ │ ├── tech_stack.md │ ├── code_patterns.md │ ├── project_brief.md │ ├── product_requirements.md │ └── testing.md └── [tool configs]Next Step: Runto start building your MVP, or say "Build my MVP following AGENTS.md"/vibe-build
将所有文件写入项目,然后告知用户:
已创建文件:
- 总体规划AGENTS.md - 详细文档agent_docs/- [根据选择生成的特定工具配置文件]
项目结构:your-app/ ├── docs/ │ ├── research-[App].txt │ ├── PRD-[App]-MVP.md │ └── TechDesign-[App]-MVP.md ├── AGENTS.md ├── agent_docs/ │ ├── tech_stack.md │ ├── code_patterns.md │ ├── project_brief.md │ ├── product_requirements.md │ └── testing.md └── [工具配置文件]下一步: 运行开始构建你的MVP,或者说"按照AGENTS.md构建我的MVP"/vibe-build