mcpField
Y
yolo

yolo

github.com/10k-digital云与 DevOps2078 次安装6 周前更新
代码仓库

关于 yolo

面向使用 Lovable 的项目,通过配置授权规则自动执行部署工作流。优先使用 MCP,也支持浏览器自动化和手动提示词作为后备方案。

主要功能

  1. 01可配置提示词授权规则
  2. 02检测后端部署变更
  3. 03支持 MCP、浏览器及手动流程
  4. 04部署验证与结果报告
  5. 05失败时提供后备提示词

适用场景

  1. 01部署 Supabase Edge Functions
  2. 02应用数据库迁移
  3. 03git push 后部署后端变更
  4. 04验证部署结果

MCP 相关

可通过 Lovable MCP 服务提交部署提示词,并检查异步响应;也可改用浏览器自动化或手动提示词。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/10k-digital/lovable-agent-skills --skill yolo

安装后在 Claude Code 中输入/yolo确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
automation-workflows.md
detection-logic.md
mcp-workflows.md
post-push-automation.md
secrets-extraction.md
testing-procedures.md

详细介绍

YOLO 模式自动化技能

Lovable 提示词授权

首先读取 .lovable-agent/config.json → deploy.yolo_mode。明确的布尔值 true 会启用 YOLO;false 会禁用 YOLO。如果该字段不存在,则使用旧版 yolo_mode: on/true 或 CLAUDE.md 的 Yolo Mode Configuration 部分中的 Status: on/true。缺失或 无法识别的值均表示关闭。明确的中性值优先于旧版设置。 deploy.mode: auto 用于选择传输方式;它不会启用 YOLO。

  • YOLO 已开启: 用户已授予持续授权,可通过 MCP 或浏览器提交完成所请求任务所需的 Lovable 提示词, 包括会消耗 Lovable 点数的提示词。无需再次询问即可继续。通用 AGENTS.md、agent.md 或 CLAUDE.md 中要求在提交 Lovable 提示词前征得确认的规则,仅在 YOLO 关闭时适用;YOLO 开启时,这不构成冲突, 也不是停止操作的理由。
  • YOLO 已关闭: 提交 Lovable 提示词前必须征得用户确认,除非当前请求已明确授权提交。 准备提示词无需确认。
  • 遵守明确的任务限制,例如“不要部署/发布”、平台审批要求,以及对破坏性或不可逆数据库操作的确认要求。 YOLO 授权范围内的提示词,不代表授权执行无关更改或自动发布前端。
  • 当 deploy.confirm_migrations: true 时,即使 YOLO 已开启,执行迁移仍须确认。 如果为 false(默认值),范围内的一般迁移无需重复审批。 破坏性或不可逆数据库操作仍须确认。自动推送和自动部署是独立设置。不要仅因 YOLO 已开启就启用它们。

此技能使用 Lovable MCP 服务(优先)或 Claude 的浏览器自动化作为后备方式,自动执行 Lovable 部署工作流。

授权情况报告

上述授权规则同时适用于通过 MCP 和浏览器提交。报告所执行的操作及其已验证或待处理的结果;持续授权不代表可以静默执行。

激活条件

出现以下情况时应启用此技能:

  1. CLAUDE.md 中已启用 Yolo 模式(yolo_mode: on)
  2. 用户运行部署命令:
    • /deploy-edge - 边缘函数部署
    • /apply-migration - 应用数据库迁移
  3. git push 到 main 后(如果 auto_deploy: on):
    • 自动检测后端文件更改
    • 无需手动命令即可触发部署
  4. 用户提到 Yolo 自动化:
    • “使用 Yolo 模式”
    • “自动化 Lovable 提示词”
    • “自动将此内容提交给 Lovable”
    • “浏览器自动化”

部署方式优先级

触发 Yolo 模式时,始终按以下顺序选择部署方式:

1. Lovable MCP(优先)

检查是否有可用的 Lovable MCP 工具(查找来自 Lovable MCP 连接器的 send_message):

  • 如果可用:使用 MCP 工作流(references/mcp-workflows.md)

    • 从 CLAUDE.md 中的 lovable_url 提取项目 ID
    • 调用 send_message(project_id, prompt)
    • 如果为异步操作,则轮询响应
    • 按配置运行验证测试
  • 优先原因:速度快 3-5 倍,无需 Chrome 扩展,不受 UI 更改影响

2. 浏览器自动化(后备方式)

如果 MCP 不可用,或 CLAUDE.md 中设置了 Deployment Method: browser:

  • 使用 Claude 的浏览器自动化(references/automation-workflows.md)
  • 导航至 Lovable,通过聊天界面提交提示词
  • 监控响应
3. 手动提示词(最后手段)

如果 MCP 和浏览器自动化都失败:

  • 向用户展示部署提示词,供其复制粘贴到 Lovable
  • 绝不阻止用户 - 始终提供手动后备方案
检查部署方式

从 CLAUDE.md 的 Yolo Mode Configuration 部分读取 Deployment Method:

  • auto(默认):先尝试 MCP,失败后改用浏览器
  • mcp:仅使用 MCP,失败后提供手动提示词(跳过浏览器)
  • browser:仅使用浏览器自动化(跳过 MCP 检查)

性能优化

模型选择(混合方案)

为获得最佳速度和可靠性,针对不同任务使用不同模型:

以下任务使用 Haiku:

  • 使用 refs 点击元素(简单、确定性强)
  • 表单输入操作(form_input 工具调用)
  • 按键和简单导航
  • 等待/轮询操作
  • 使用 find 工具查找简单元素

以下任务使用 Sonnet:

  • 导航后初步理解页面
  • 错误检测和恢复决策
  • 解析 Lovable 的响应,判断成功或失败
  • 遇到意外情况时决定下一步
  • 复杂的页面状态分析

这样做的原因:

  • 对于简单操作,Haiku 的速度快 3–5 倍
  • Sonnet 在复杂推理方面更可靠
  • 混合方案兼具两者的优势:速度和准确性
工具偏好

始终优先使用以下工具:

  • 使用 find 和 read_page 代替截图来定位元素
  • 使用 form_input 代替点击加输入来填写值
  • 点击时使用 ref 参数,而非坐标
  • 使用 DOM 轮询代替基于截图的监控

详细实现请参阅 references/automation-workflows.md。


核心功能

1. 自动检测

启用 yolo 模式后,自动检测何时需要 Lovable 提示词:

边缘函数部署:

  • 修改了 supabase/functions/ 中的文件
  • 更改已提交并推送到 main
  • 已生成部署提示词

迁移应用:

  • supabase/migrations/ 中有新文件
  • 更改已提交并推送到 main
  • 已生成迁移提示词

完整的检测条件请参阅 references/detection-logic.md。

1.5. Git Push 后自动部署(新功能)

启用 auto_deploy: on 后,Claude 会在成功执行 git push 后自动检测并部署后端更改:

触发条件: 成功执行 git push origin main

检测:

  1. 分析此次推送中更改的文件
  2. 检查是否有 supabase/functions/ 或 supabase/migrations/ 中的更改
  3. 如果发现后端文件且已启用 auto_deploy → 触发自动化

流程:

git push origin main [succeeds]
    ↓
Claude detects backend file changes
    ↓
Check: yolo_mode: on AND auto_deploy: on
    ↓
🤖 "Auto-deploy: Backend changes detected, starting deployment..."
    ↓
Execute browser automation
    ↓
Run verification tests
    ↓
Show deployment summary

优雅降级: 如果自动部署因任何原因失败:

  • 显示清晰的错误消息
  • 提供手动提示词作为备用方案
  • 绝不阻止用户操作

完整实现请参阅 references/post-push-automation.md。

2. 部署执行

需要部署时,根据所选方法执行:

MCP 方法:

  1. 从 CLAUDE.md 中的 lovable_url 提取项目 ID
  2. 使用部署提示词调用 Lovable MCP send_message
  3. 如果响应为异步,轮询直至完成
  4. 从响应中解析成功或失败

完整的 MCP 工作流请参阅 references/mcp-workflows.md。

浏览器自动化方法:

  1. 导航到 Lovable

    • 从 CLAUDE.md 读取 lovable_url
    • 打开浏览器并导航到项目
    • 如有需要,处理登录
  2. 提交提示词

    • 定位聊天输入元素
    • 输入生成的 Lovable 提示词
    • 提交并确认消息已发送
  3. 监控响应

    • 等待 Lovable 响应
    • 检查成功指示
    • 检测错误或警告
    • 3 分钟后超时

详细的浏览器自动化步骤请参阅 references/automation-workflows.md。

3. 测试与验证

部署成功后,根据 yolo_testing 设置运行测试:

如果 yolo_testing: on(默认):

  • 级别 1:基本验证(通过 Lovable 检查日志)
  • 级别 2:检查控制台错误(监控生产 URL)
  • 级别 3:功能测试(测试端点/查询)

如果 yolo_testing: off:

  • 跳过所有测试
  • 仅根据 Lovable 响应确认部署成功

级别 4(可选):预览测试计划 如果项目启用了预览测试(CLAUDE.md → 预览测试配置),且 Test After Deploy 设置为 smoke 或 all,则在验证部署后,针对 Lovable Preview 应用运行相应的测试计划。这由测试技能(skills/testing/SKILL.md)处理,相当于 /lovable:test-run --smoke(或 --all)。

完整测试工作流请参阅 references/testing-procedures.md。

4. 调试模式

当 yolo_debug: on 时,提供详细输出:

🐛 DEBUG: Browser Automation

Step 1: Navigating to Lovable
  URL: https://lovable.dev/projects/abc123
  Wait for: Page load complete
  ✅ Success (1.2s)

Step 2: Locating chat interface
  Selector: textarea[data-testid="chat-input"]
  Wait for: Element interactable
  ✅ Found (0.3s)

Step 3: Typing prompt
  Text: "Deploy the send-email edge function"
  ✅ Typed (0.5s)

Step 4: Submitting
  Action: Press Enter
  ✅ Submitted (0.1s)

Step 5: Monitoring response
  Watching for: New message from assistant
  Timeout: 180s
  ✅ Response received (4.2s)

Response content:
"I'll deploy the send-email edge function now..."
[full response text]

Success keywords detected: ['deploy', 'function']
No error keywords found

CLAUDE.md 中的配置

该技能会从 CLAUDE.md 读取以下字段:

## Yolo Mode Configuration (Beta)

- **Status**: on
- **Deployment Method**: auto
- **Auto-Deploy**: on
- **Deployment Testing**: on
- **Auto-run Tests**: off
- **Debug Mode**: off
- **Last Updated**: 2025-01-03 10:30:00

配置选项:

  • 状态:完全启用/停用 yolo 模式
  • 部署方式:auto(优先使用 MCP,然后使用浏览器)、mcp(仅使用 MCP)或 browser(仅使用浏览器)
  • 自动部署:git push 后自动部署(无需手动运行命令)
  • 部署测试:部署后运行验证测试
  • 自动运行测试:git push 后运行项目测试套件
  • 调试模式:显示详细的自动化日志

以及来自项目概览的内容:

- **Lovable Project URL**: https://lovable.dev/projects/abc123
- **Production URL**: https://my-app.lovable.app

用户通知

进度更新

自动化期间实时显示进度:

MCP 模式(关闭调试):

🤖 Yolo mode (MCP): Deploying send-email edge function

⏳ Sending deployment prompt via Lovable MCP...
✅ Deployment confirmed by Lovable (3.1s)
⏳ Running verification tests...
✅ All tests passed

浏览器模式(关闭调试):

🤖 Yolo mode: Deploying send-email edge function

⏳ Step 1/8: Navigating to Lovable project...
⏳ Step 2/8: Waiting for GitHub sync...
✅ Step 3/8: Sync verified - Lovable has latest code
✅ Step 4/8: Located chat interface
✅ Step 5/8: Submitted prompt
⏳ Step 6/8: Waiting for Lovable response...
✅ Step 7/8: Deployment confirmed
⏳ Step 8/8: Running verification tests...
✅ Step 8/8: All tests passed

调试模式(开启调试): 包含详细日志,其中包含耗时、选择器和完整响应。

部署摘要

自动化完成后:

## Deployment Summary

**Operation:** Edge Function Deployment
**Function:** send-email
**Status:** ✅ Success
**Duration:** 45 seconds

**Automation Steps:**
1. ✅ Navigated to Lovable
2. ✅ Submitted deployment prompt
3. ✅ Received deployment confirmation

**Verification Tests:** (if testing enabled)
1. ✅ Basic verification: Deployment logs show no errors
2. ✅ Console check: No errors at production URL
3. ✅ Functional test: Function endpoint responds (200 OK)

**Production Status:**
- Function is live and responding
- No errors detected
- Ready for use

💡 Yolo mode is enabled. I'll continue automating deployments.
   Run `/yolo off` to disable.

错误处理

所有自动化失败都会优雅地回退到手动提示:

常见错误

MCP 未连接(auto 模式——接下来会尝试使用浏览器):

⚠️ Lovable MCP not connected - trying browser automation...
[continues with browser automation]

MCP 未连接(仅 MCP 模式):

❌ Lovable MCP not available

Deployment Method is set to "mcp" but Lovable MCP tools are not connected.

To connect: /lovable:connect-mcp
To use browser automation instead: /lovable:yolo on --browser

Fallback - run this prompt manually in Lovable:
📋 "Deploy the send-email edge function"

浏览器自动化不可用:

❌ Browser automation unavailable

Yolo mode requires the Claude in Chrome extension.

Install: https://chrome.google.com/webstore/detail/claude/...

Tip: Use Lovable MCP instead (no extension needed):
  /lovable:connect-mcp

Fallback - run this prompt manually in Lovable:
📋 "Deploy the send-email edge function"

需要登录:

🔐 Please log in to Lovable

The browser opened to your Lovable project, but you're not logged in.
Please log in and I'll retry automatically.

Or run this prompt manually:
📋 "Deploy the send-email edge function"

未找到 UI 元素:

❌ Could not locate Lovable chat interface

The Lovable UI may have changed since this plugin was created.

Fallback - run this prompt manually in Lovable:
📋 "Deploy the send-email edge function"

💡 Please report this issue at:
   https://github.com/10K-Digital/lovable-agent-skills/issues

超时:

⏱️ Lovable hasn't responded after 3 minutes

The operation may still be processing.
Please check Lovable manually to verify status.

Prompt that was submitted:
📋 "Deploy the send-email edge function"

部署失败:

❌ Deployment failed in Lovable

Error from Lovable:
[captured error message]

Suggested fixes:
- Check function code for syntax errors
- Verify required secrets are set in Cloud → Secrets
- Review function logs in Lovable

Would you like me to:
1. Review the function code for issues
2. Check if secrets are documented in CLAUDE.md
3. Show you how to access logs in Lovable
优雅降级

自动化失败时:

  1. 捕获错误详情
  2. 显示便于用户理解的错误消息
  3. 提供手动提示作为回退方案
  4. 提供故障排查建议
  5. 如果错误持续发生,提供停用 yolo 模式的选项

绝不静默失败——始终告知用户并提供手动操作选项。

与其他命令集成

/deploy-edge

启用 yolo 模式时,/deploy-edge 会自动触发浏览器自动化:

[... existing deploy-edge logic ...]

## Deployment Execution

1. Check yolo mode status from CLAUDE.md

2. If `yolo_mode: on`:
   - Activate yolo skill
   - Execute browser automation workflow
   - Run tests based on `yolo_testing` setting
   - Report results

3. If `yolo_mode: off`:
   - Show manual prompt (current behavior)
   - Suggest enabling yolo mode
/apply-migration

迁移工作流遵循与 deploy-edge 相同的模式。

/yolo

/yolo 命令用于控制此技能:

  • /yolo on——通过设置 yolo_mode: on 启用技能
  • /yolo off——停用技能
  • 接受以下标志:--testing、--no-testing、--debug

Beta 状态与限制

Beta 警告

Yolo 模式仍处于 beta 阶段——用户应了解以下情况:

✅ 运行良好的功能:

  • 通过 MCP(首选)或浏览器自动提交提示
  • 基本部署验证
  • 出错时回退到手动操作

⚠️ 已知限制(MCP 模式):

  • 需要 Lovable Pro 套餐
  • 需要初始 OAuth 设置(/lovable:connect-mcp)
  • 调用 send_message 时会消耗 Lovable 积分

⚠️ 已知限制(浏览器模式):

  • 需要 Claude in Chrome 扩展
  • Lovable UI 更改可能导致自动化失效
  • 用户必须已登录 Lovable

⚠️ 共同限制:

  • 测试会使每次部署增加 1–3 分钟
  • 仅适用于边缘函数和迁移(不适用于表、RLS 等)
何时推荐使用 Yolo Mode

✅ 适合:

  • 频繁部署(节省时间)
  • 熟悉浏览器自动化的用户
  • 开发工作流(快速迭代)

❌ 不适合:

  • 一次性部署(手动操作更快)
  • 需要额外审核的生产部署
  • 没有 Chrome 扩展的用户
  • 无法访问浏览器的环境
后续增强

尚未实现,但可以添加:

  1. 批量操作

    • 一次部署多个边缘函数
    • 依次应用多个迁移
  2. 回滚支持

    • 检测部署失败
    • 提供通过 Lovable 回滚的选项
  3. 监控模式

    • 定期检查日志
    • 发现新错误时发出警报
  4. 自定义测试脚本

    • 用户定义的测试负载
    • 存储在 CLAUDE.md 中
  5. 更广泛的操作支持

    • 创建表
    • RLS 策略
    • 存储桶

参考文件

此技能使用以下参考文档:

  1. references/mcp-workflows.md(新增——优先使用)

    • Lovable MCP send_message 工作流
    • 提取项目 ID
    • MCP 错误处理与回退方案
  2. references/automation-workflows.md

    • 浏览器自动化分步说明
    • Lovable UI 导航
    • 元素选择器和等待条件
  3. references/detection-logic.md

    • 何时触发自动化
    • 文件变更检测
    • 与命令集成
  4. references/post-push-automation.md

    • git push 后自动部署
    • 平稳的回退处理
    • 用户通知模板
  5. references/testing-procedures.md

    • 级别 1:基本验证
    • 级别 2:检查控制台
    • 级别 3:功能测试

快速参考

检查 Yolo Mode 是否已启用
1. Read deploy.yolo_mode in .lovable-agent/config.json first
2. Only if absent, fall back to CLAUDE.md Yolo Mode Configuration
3. Apply the authorization rules above; missing/unknown means disabled
检查是否已启用自动部署
1. Read CLAUDE.md
2. Check both "Status: on" AND "Auto-Deploy: on"
3. Both must be enabled for auto-deploy to trigger
执行自动化
1. Confirm yolo_mode is on
2. Read Deployment Method from CLAUDE.md (auto / mcp / browser)
3. If auto or mcp:
   - Check if Lovable MCP tools are available
   - If yes → Load mcp-workflows.md and execute MCP workflow
   - If no and auto → fall through to browser
4. If auto or browser:
   - Load automation-workflows.md
   - Execute navigation → submit → monitor workflow
5. Run tests if yolo_testing is on
6. Report results
Git Push 后自动部署
1. Git push succeeds
2. Check for backend file changes (supabase/functions/, supabase/migrations/)
3. If changes found AND auto_deploy enabled:
   - Trigger automation automatically
   - Show: "🤖 Auto-deploy: Backend changes detected..."
4. If auto_deploy disabled:
   - Show notification only
   - Suggest running /deploy-edge or /apply-migration
处理错误
1. Try automation
2. If fails, capture error
3. Show error + manual fallback prompt
4. Never block user - always provide manual option
5. Suggest troubleshooting based on error type

此技能可实现免手动操作的 Lovable 部署,同时通过手动回退方案和全面测试确保安全。

评论

支持 Markdown