{
  "schemaVersion": "1.0",
  "item": {
    "slug": "vibe-3k",
    "name": "Vibe Coding Best Practices v3.0",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/russellfei/vibe-3k",
    "canonicalUrl": "https://clawhub.ai/russellfei/vibe-3k",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/vibe-3k",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=vibe-3k",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "references/01-quickstart.md",
      "references/02-single-agent.md",
      "references/03-multi-agent.md",
      "references/04-emergency.md",
      "references/05-security-qa.md",
      "references/06-tools.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/vibe-3k"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/vibe-3k",
    "agentPageUrl": "https://openagent3.xyz/skills/vibe-3k/agent",
    "manifestUrl": "https://openagent3.xyz/skills/vibe-3k/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/vibe-3k/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Vibe Coding 最佳实践指南",
        "body": "vibe-3k = Vibe Coding Best Practices v3.0（3K 行级全流程指南）\n\n你是主厨，AI 是厨房团队。你设计菜单、品尝每道菜，但不亲自切每根胡萝卜。"
      },
      {
        "title": "10 条核心原则",
        "body": "先想后 prompt — 5 分钟思考省 5 小时迭代\nPlan ≠ Act — 分离规划和执行，用不同模型/session\nDesign Doc 是枢纽 — 压缩上下文，可审查，可交接\n小步提交 — 每个功能点一个 commit，Git 是安全网\n新功能新 session — 上下文溢出是第一杀手\n循环修复就回退 — 3 次修不好 = 方案有问题\n安全不能 vibe — Auth/支付/数据必须人工 review\nLOG.md 是续命药 — 记录进度，任何时候都能恢复\n多 Agent 分工明确 — PM 规划、Dev 执行、QA 审查\n验收有 checklist — 自动化检查 + 人工确认"
      },
      {
        "title": "参考文档（按需加载）",
        "body": "文件内容何时读取references/01-quickstart.md核心概念 + 项目启动 + 规则文件 + 4 套项目模板启动新项目时references/02-single-agent.mdPLAN/ACT 分离 + Design Doc + Prompt 技巧 + 上下文管理单人 AI 开发时references/03-multi-agent.md多 Agent 协作 + Git Worktree 并行 + Race Condition 防护 + 时间戳规范多 Agent 协作时references/04-emergency.md故障分级 + 恢复 SOP + 灾难恢复 + >24h 长任务管理出问题或长任务时references/05-security-qa.md安全红线 + 验收 Checklist + 自动化验收脚本安全审查/验收时references/06-tools.md工具推荐（Claude Code / Kimi / Antigravity / OpenClaw）工具选型时"
      },
      {
        "title": "启动前 5 分钟清单",
        "body": "在碰 AI 之前写下：\n\n解决什么问题？\n目标用户？\n核心功能（P0/P1/P2）\n技术栈约束\n什么叫「完成」？"
      },
      {
        "title": "PLAN/ACT 分离（最重要）",
        "body": "PLAN 阶段: 大上下文 thinking 模型（Gemini / OpenAI / Claude 最新旗舰）只分析、只规划 → 输出 Design Doc\nACT 阶段: 新 session + 快速模型（各厂商轻量级模型）→ 读 Design Doc → 逐步实现\n永远不要在同一个 session 里做 Plan 和 Act"
      },
      {
        "title": "故障快速参考",
        "body": "信号动作单个错误，信息清晰粘贴完整 stack trace → AI 修来回改同一文件 3+ 次🛑 停！git stash → 换模型/策略多处报错，越修越乱git reset --hard <stable> → 重新 PlanAI 重复/遗忘/答非所问关 session → LOG.md → 新 session 接力"
      },
      {
        "title": "安全红线",
        "body": "Auth、支付、数据库 Schema、用户数据、API Key — 绝不 vibe，必须人工逐行 review。"
      },
      {
        "title": "实际案例",
        "body": "使用中的真实案例记录在 memory/tasks/ 目录。每次完成 Vibe Coding 项目都会生成 task 记录，包含执行过程、踩坑和成果。"
      },
      {
        "title": "工具信息时效性",
        "body": "⚠️ 工具相关信息（Kimi Agent Swarm、Antigravity Kit 等）截至 2026-02，具体能力和 API 以官方文档为准。"
      }
    ],
    "body": "Vibe Coding 最佳实践指南\n\nvibe-3k = Vibe Coding Best Practices v3.0（3K 行级全流程指南）\n\n你是主厨，AI 是厨房团队。你设计菜单、品尝每道菜，但不亲自切每根胡萝卜。\n\n10 条核心原则\n先想后 prompt — 5 分钟思考省 5 小时迭代\nPlan ≠ Act — 分离规划和执行，用不同模型/session\nDesign Doc 是枢纽 — 压缩上下文，可审查，可交接\n小步提交 — 每个功能点一个 commit，Git 是安全网\n新功能新 session — 上下文溢出是第一杀手\n循环修复就回退 — 3 次修不好 = 方案有问题\n安全不能 vibe — Auth/支付/数据必须人工 review\nLOG.md 是续命药 — 记录进度，任何时候都能恢复\n多 Agent 分工明确 — PM 规划、Dev 执行、QA 审查\n验收有 checklist — 自动化检查 + 人工确认\n参考文档（按需加载）\n文件\t内容\t何时读取\nreferences/01-quickstart.md\t核心概念 + 项目启动 + 规则文件 + 4 套项目模板\t启动新项目时\nreferences/02-single-agent.md\tPLAN/ACT 分离 + Design Doc + Prompt 技巧 + 上下文管理\t单人 AI 开发时\nreferences/03-multi-agent.md\t多 Agent 协作 + Git Worktree 并行 + Race Condition 防护 + 时间戳规范\t多 Agent 协作时\nreferences/04-emergency.md\t故障分级 + 恢复 SOP + 灾难恢复 + >24h 长任务管理\t出问题或长任务时\nreferences/05-security-qa.md\t安全红线 + 验收 Checklist + 自动化验收脚本\t安全审查/验收时\nreferences/06-tools.md\t工具推荐（Claude Code / Kimi / Antigravity / OpenClaw）\t工具选型时\n快速启动\n启动前 5 分钟清单\n\n在碰 AI 之前写下：\n\n解决什么问题？\n目标用户？\n核心功能（P0/P1/P2）\n技术栈约束\n什么叫「完成」？\nPLAN/ACT 分离（最重要）\nPLAN 阶段: 大上下文 thinking 模型（Gemini / OpenAI / Claude 最新旗舰）只分析、只规划 → 输出 Design Doc\nACT 阶段: 新 session + 快速模型（各厂商轻量级模型）→ 读 Design Doc → 逐步实现\n永远不要在同一个 session 里做 Plan 和 Act\n故障快速参考\n信号\t动作\n单个错误，信息清晰\t粘贴完整 stack trace → AI 修\n来回改同一文件 3+ 次\t🛑 停！git stash → 换模型/策略\n多处报错，越修越乱\tgit reset --hard <stable> → 重新 Plan\nAI 重复/遗忘/答非所问\t关 session → LOG.md → 新 session 接力\n安全红线\n\nAuth、支付、数据库 Schema、用户数据、API Key — 绝不 vibe，必须人工逐行 review。\n\n实际案例\n\n使用中的真实案例记录在 memory/tasks/ 目录。每次完成 Vibe Coding 项目都会生成 task 记录，包含执行过程、踩坑和成果。\n\n工具信息时效性\n\n⚠️ 工具相关信息（Kimi Agent Swarm、Antigravity Kit 等）截至 2026-02，具体能力和 API 以官方文档为准。"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/russellfei/vibe-3k",
    "publisherUrl": "https://clawhub.ai/russellfei/vibe-3k",
    "owner": "russellfei",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/vibe-3k",
    "downloadUrl": "https://openagent3.xyz/downloads/vibe-3k",
    "agentUrl": "https://openagent3.xyz/skills/vibe-3k/agent",
    "manifestUrl": "https://openagent3.xyz/skills/vibe-3k/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/vibe-3k/agent.md"
  }
}