tinybird-cli-guidelines

tinybird-cli-guidelines 技能概览

tinybird-cli-guidelines 是一份实用指南，帮助你更少靠猜来使用 Tinybird CLI（tb），并做出更稳妥的工作流决策。它特别适合后端开发者、数据工程师，以及需要构建、校验、部署或运维 Tinybird 项目、又不想随手编 flags 或误跑到错误目标环境的 agent。

用户通常关心的问题很简单：“我该运行哪条 tb 命令，在哪个环境里跑，在修改数据或部署之前要先检查什么？”这个技能就是围绕这个任务设计的。tinybird-cli-guidelines 在本地开发、Cloud 部署、数据操作、mock 数据，以及 token/secret 处理需要保持一致时，最能发挥作用。

为什么这个技能值得安装

它的核心价值是工作流控制，而不只是命令查找。tinybird-cli-guidelines install 适合那些希望突出 CLI 4.0 行为、环境目标选择，以及安全操作习惯的用户。它能帮助减少 tb build、tb deploy、破坏性数据变更，以及本地和 Cloud 混淆带来的错误。

最适合后端开发场景

当你的工作会涉及 Tinybird datasource、pipe、部署或本地测试时，可以使用 tinybird-cli-guidelines for Backend Development。如果你需要一份紧凑的 tb CLI 操作指南，尤其是在那些构建/部署行为依赖 tinybird.config.json 的仓库里，它会非常合适。

它不打算解决什么

这不是一份通用的 Tinybird 教程，也不是完整的仓库摘要。它是一款面向 CLI 使用和运维流程的决策支持技能。如果你只需要一次性的命令解释，tb <command> --help 可能就够了；但如果你需要可重复执行的工作流，这个技能就更有价值。

如何使用 tinybird-cli-guidelines 技能

安装后先确认技能范围

用下面的命令安装 tinybird-cli-guidelines：

npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines

安装完成后，先读 SKILL.md，再打开与任务匹配的辅助规则文件。最有用的文件是 rules/cli-commands.md、rules/build-deploy.md、rules/local-development.md 和 rules/data-operations.md。

把粗糙需求改写成可执行的提示词

这个技能在你的提示词包含以下信息时效果最好：

• 目标：build、deploy、append、replace、delete 或 test
• 环境：local、branch 或 cloud
• 对象：datasource、pipe、token、secret 或 project file
• 风险等级：安全检查、非破坏性操作、或已确认的破坏性变更

更好的提示词示例是：“使用 tinybird-cli-guidelines 验证一个 Tinybird 项目，说明在 CLI 4.0 中该运行哪些 tb 命令，并在我确认前避免破坏性 deploy。”

先读对文件

先从 SKILL.md 开始，再根据任务选择对应的规则文件：

• rules/build-deploy.md：用于 tb build 和 tb deploy
• rules/data-operations.md：用于 delete/replace/truncate 行为
• rules/append-data.md：用于追加文件、URL 或事件
• rules/local-development.md：用于 Tinybird Local 的搭建和排查
• rules/tokens.md 和 rules/secrets.md：用于认证和配置工作

按工作流规则执行，不要只靠记忆

tinybird-cli-guidelines usage 里最有价值的建议，是要尊重 CLI 4.0 的上下文。先在 tinybird.config.json 里配置 dev_mode，然后除非确实需要手动覆盖，否则就直接使用 tb build 和 tb deploy。在任何可能修改生产环境或删除数据的命令之前，先在技能中核对准确的命令语法，或者用 tb <command> --help 再确认一次。

tinybird-cli-guidelines 技能常见问题

tinybird-cli-guidelines 只适合 Tinybird 专家吗？

不是。它既适合需要更安全默认值的初学者，也适合想减少环境误操作的资深用户。尤其当你清楚业务目标，却不确定最安全的 Tinybird CLI 路径时，这个技能会很有帮助。

它和普通提示词有什么不同？

普通提示词可以描述任务，但 tinybird-cli-guidelines 会给你一套可复用的操作模型：先看哪里、先确认什么、以及什么时候该停下来请求批准。这一点在 tb build、tb deploy 和数据变更命令上尤其重要。

什么时候不该用这个技能？

如果你不涉及 Tinybird CLI 命令、Tinybird Local 或 Tinybird 部署工作流，就可以跳过它。对于那些不涉及项目文件、环境或操作风险的非常简单的只读问题，也没必要用它。

它同时覆盖本地和 Cloud 工作流吗？

是的。tinybird-cli-guidelines 覆盖 Tinybird Local、基于 branch 的开发，以及 Cloud 部署。这使它很适合需要从本地迭代平滑过渡到生产环境、又想减少人工决策的场景。

如何改进 tinybird-cli-guidelines 技能

把具体操作和目标说清楚

输入越准确，输出越好。不要只说“帮我处理 Tinybird”，而要说“执行安全的本地 build”、“准备生产部署检查”或“把 CSV 数据追加到现有 datasource”。同时写明 datasource 或项目名称，并说明目标是 local、branch 还是 cloud。

先把限制条件说出来

最大的失败点通常是风险不明确。如果你不能接受破坏性变更，就要在技能建议 tb deploy --allow-destructive-operations 或替换类命令之前明确说明。如果你正在 main 或 master 上工作，也要讲清楚，因为 branch 模式下的行为是不同的。

为数据操作提供具体输入

对于 tinybird-cli-guidelines usage 里的 append、replace 或 delete 任务，请提供文件路径、行条件、分区键，以及 schema 是否保持不变。例如：“用 data.csv 替换 events 里的 11 月数据；分区键是 country；不要影响 active ingestion。”这样的细节能避免生成不安全或不完整的命令方案。

在推到生产前先用检查步骤迭代

在把任何内容推进到 Cloud main 之前，先使用 tb info、tb deploy --check 和对应的规则文件。如果第一次得到的结果太笼统，就补充命令、环境，以及你希望技能检查的确切文件，继续细化请求。