开发工具CLI构建工具MCP 服务【免费下载链接】bitAI-powered development workspaces with reusable components, architectural clarity and zero overhead.项目地址https://gitcode.com/gh_mirrors/bi/bit点击查看免费下载本指南围绕 Bit 开源仓库中的 contrib/claude-skill-bit-cli 目录展开讲解其核心文档 SKILL.md 的设计思路、命令全景与使用方式。你将理解为什么 AI Agent 不应凭记忆猜测 Bit 命令、这套「渐进式披露」的层级化参考如何以最小 Token 成本提供最准确的命令语法并掌握安装、更新、自动再生成技能文件以及切换到 Bit MCP Server 的完整方案。一、为什么需要这份技能AI 不该凭记忆猜 Bit 命令Bit 是一个基于组件的开发平台其 CLI 拥有 90 个公开命令、数十个带子命令的命令族如lane、deps、envs、scope、ci以及大量 flags。对于接入 Claude Code 等 AI 编码助手的开发者来说最大的风险不是找不到命令而是让模型从训练记忆里猜一个命令——猜出来的语法可能是旧版、错位甚至根本不存在的最终导致误操作或反复失败。SKILL.md 的 front-matter 对此做了强制约束name: bit-cli description: MUST consult before running ANY bit command. Do NOT guess bit commands from memory. This skill tells you the right command, correct syntax, subcommands, and flags.即在运行任何bit命令之前必须先查阅本技能不得凭记忆猜测命令。这份 description 会被 Claude Code 在相关场景下自动加载从而把先查参考、再执行变成 Agent 的默认行为而非依赖用户的提醒。二、渐进式披露设计三层结构控制 Token 开销整个技能按渐进式披露progressive disclosure设计来自 README.md 的说明分为三个层级层级文件Token 量加载时机内容L1技能元数据front-matter约 100始终加载技能名称与触发约束L2SKILL.md约 800询问 bit 命令时全命令分类索引 一句话描述 子命令列表L3CLI_REFERENCE.md约 2000按需加载每个命令的用法、子命令、参数与 flags兜底bit command --help按需参考文件未覆盖时运行时原生帮助这种设计没有使用任何 bash 脚本、不触发权限弹窗SKILL.md末尾明确指示 Agent 的读取策略IMPORTANT: When you need flags, arguments, or subcommand details, READ the file CLI_REFERENCE.md in this same directory using the Read tool. Only fall back to bit command --help if the reference file doesnt cover what you need.也就是说先看索引SKILL.md需要细节时用 Read 工具读同目录下的 CLI_REFERENCE.md只有参考文件没覆盖的内容才回退到bit --help。三层各司其职避免了把全量参考一次性塞进上下文的高昂开销。三、SKILL.md 命令索引全景按类别继承全部命令SKILL.md是bit --help风格的无色命令索引其注释标明This content is auto-generated by: bit cli generate --skill commands。它开篇给出统一用法usage: bit [--version] [--help] command [args]以下按原文的分类完整罗列每个命令及其一句话描述括号内为子命令方便读者直接作为速查表使用。3.1 系统与工具System Utilityhelp- 显示可用命令与用法信息version- 显示已安装的 Bit 版本config- 管理 Bit 配置项子命令set, del, get, listglobals- 显示 Bit 使用的全局目录与路径system sub-command- 访问系统级操作与调试工具子命令log, tail-logdoctor [diagnosis-name]- 诊断并排查工作区问题clear-cache- 清除缓存数据以解决数据过期问题3.2 工作区命令Workspace commandsdetails- 显示上一条命令如 tag、snap提供的扩展详情3.3 信息与分析Information Analysisshow component-name- 显示组件元数据、依赖与配置cat component-id- 打印指定版本组件的源码文件或配置graph [id]- 将组件依赖关系可视化为图图片pattern pattern- 测试并校验组件 pattern 语法list [remote-scope]- 显示工作区或远程 scope 中的组件search query...- 在本地工作区与远程 bit cloud 中按关键字搜索组件schema pattern- 显示组件 API schema 与类型定义子命令diffdiff [component-pattern] [version] [to-version]- 对比组件在版本间或与当前工作区之间的变更status- 显示工作区组件状态与问题3.4 组件配置Component Configurationenvs- 显示组件及其分配的环境子命令list, get, set, unset, replace, updatescope sub-command- 管理组件 scope 名称与归属子命令set, trust, rename, rename-owner, forkeject-conf pattern- 为组件生成 component.json 配置文件local-only sub-command- 管理仅存在于工作区的组件子命令set, unset, listaspect sub-command- 管理组件 aspect 及其配置子命令list, list-core, get, set, unset, update3.5 协作与远程Collaboration Remoteremote- 为自托管环境管理远程 scope子命令add, del, listripple sub-command- 管理 bit.cloud 上的 Ripple CI 任务子命令list, log, errors, retry, stop, simulatedeprecate component-pattern- 标记组件已弃用以提示不要继续使用undeprecate component-pattern- 移除组件的弃用状态import [component-patterns...]- 将远程 scope 中的组件导入工作区delete component-pattern- 对远程 scope 中的组件执行软删除recover component-pattern- 恢复被软删除的组件export [component-patterns...]- 将组件上传到远程 scopelane [sub-command]- 管理 lane 以支持并行开发子命令list, show, create, remove, change-scope, alias, rename, remove-readme, import, remove-comp, fetch, eject, current, history, history-diff, checkout, revert, updates, merge-moveci sub-command- 面向自动化工作流的持续集成命令子命令verify, pr, merge, syncfork pattern [target-component-name]- 复制现有组件以创建新组件internalize [component-pattern]- 将组件标记为 internal使其在 UI 中默认隐藏3.6 运行与服务Run Servestart [component-pattern]- 启动 Bit 开发服务器run [app-name]- 本地启动应用组件app [sub-command]- 管理应用组件子命令list, run3.7 高级/调试Advanced/Debugcapsule- 管理隔离的组件环境子命令list, create, delete, prunemcp-server [sub-command]- 为 AI 助手启动 Model Context Protocol 服务器子命令start, setup, rules3.8 开发组件Develop componentsscript [script-name]- 运行由环境定义的脚本3.9 认证与云端Authentication Cloudlogin- 认证 Bit Cloud 以发布组件与协作logout- 登出 Bit Cloud 并清除认证令牌whoami- 显示当前已认证的 Bit Cloud 用户npmrc [sub-command]- 用 Bit Cloud registry 与认证配置生成 .npmrc子命令generate3.10 工作区工具Workspace Toolsws-config sub-command- 生成 IDE 配置文件子命令write, clean, listgit sub-command- Bit 仓库的 Git 工具子命令set-merge-driverrefactor sub-command- 自动重构组件源码子命令dependency-name3.11 组件开发Component Developmentadd [path...]- 将现有目录内容跟踪为工作区新组件create template-name component-names...- 从模板脚手架生成新组件源码、配置与环境templates- 列出可用于创建组件与工作区的模板watch- 监听文件变化并编译组件build [component-pattern]- 在隔离环境中运行构建流水线任务compile [component-names...]- 转译组件源文件move current-component-dir new-component-dir- 将组件移动到不同目录remove component-pattern- 从工作区取消跟踪组件rename current-name new-name- 修改组件名称3.12 工作区与项目搭建Workspace Project Setupnew template-name workspace-name- 从模板创建新的 Bit 工作区init [path]- 在现有项目中初始化 Bit 工作区3.13 测试与质量Testing Qualityartifacts component-pattern- 查看并下载构建产物test [pattern-or-test-file...]- 运行组件测试check-types [component-pattern]- 校验 TypeScript 类型正确性lint [component-pattern]- 分析组件代码问题与风格违规validate [component-pattern]- 依次执行类型检查、lint 与测试format [component-pattern]- 自动格式化组件源码3.14 依赖与包Dependencies Packagesinstall [packages...]- 安装工作区依赖uninstall [packages...]- 从工作区移除依赖update [package-patterns...]- 将工作区依赖更新到较新版本link [component-names...]- 在组件与 node_modules 之间建立链接eject component-pattern- 将组件移出工作区并作为 npm 包安装deps sub-command- 管理组件依赖子命令get, remove, unset, debug, set, reset, eject, blame, usage, diagnose, circular, writewhy dependency-name- 查找使用指定依赖的组件set-peer component-id range- 配置组件始终以 peer dependency 方式安装unset-peer component-id- 移除组件的 always-peer 配置dependents component-name- 显示依赖指定组件的组件3.15 版本控制Version Controlcheckout to [component-pattern]- 切换组件版本或移除本地变更revert component-pattern to- 用指定版本替换组件文件但保留当前版本tag [component-patterns...]- 以语义化版本标签创建不可变组件快照snap [component-pattern]- 为开发版本创建不可变组件快照reset [component-pattern]- 将本地 tag 与 snap 回退到先前版本merge [component-pattern]- 当本地与远程版本不同时合并分叉的组件历史stash sub-command- 临时保存与恢复组件变更子命令save, load, listlog id- 显示组件版本历史log-file filepath- EXPERIMENTAL显示特定文件的变更历史blame filepath- EXPERIMENTAL按行显示作者与修改历史四、第二层参考 CLI_REFERENCE.md子命令、参数与 flags 的权威来源当索引层不足以支撑执行时Agent 应读取 CLI_REFERENCE.md。这份文件为每个命令生成## bit command章节包含用法行usage、一句话描述与扩展描述、以及Flags 列表有子命令的命令族如bit lane ...、bit deps ...会为每个子命令递归生成独立小节。以几个高频命令为例4.1bit tag—— 语义化版本发布## bit tag [component-patterns...] creates tagged versions using semantic versioning (semver) for component releases. tags are immutable and exportable. by default tags all new and modified components. supports version specification per pattern using (e.g. foo1.0.0, barminor). use for official releases. for development versions, use bit snap instead.按 pattern 指定版本bit tag foo1.0.0 barminor版本递进 flags--patch、--minor、--major、--increment level、--prerelease-id id、--pre-release [identifier]、--auto-tag-increment level构建与流水线--build、--skip-tests、--skip-tasks string、--disable-tag-pipeline、--ignore-build-errors、--rebuild-deps-graph其他--message message、--unmodified、--editor [editor]、--versions-file path、--soft、--fail-fast、--loose、--ignore-issues issues等4.2bit checkout to—— 版本切换的核心语义checkout的to参数接受五类取值参考文档给出了精确语义head切到最后一次 snap/tag最常见用法具体版本号切到精确版本如bit checkout 1.0.5 component-namehead~x从 head 回退 x 代如head~2latest切到最新的 semver tagreset移除本地修改并恢复原始文件同时恢复被删除的组件目录在 lane 上checkout head只影响 lane 组件要更新 main 组件需运行bit lane merge main。合并相关 flags 包括--interactive-merge、--auto-merge-resolve merge-strategy、--force-ours、--force-theirs、--manual等。4.3bit deps—— 依赖治理全家桶deps族覆盖依赖的读、写、查、诊bit deps get component-name显示直接与间接依赖--scope、--treebit deps set / remove / unset pattern package...配置或移除依赖--dev、--peer、--optionalbit deps debug component-name显示直接依赖及其版本是如何确定的bit deps blame component-name dependency-name定位哪个 snap/tag 改变了依赖版本bit deps usage dependency-name查找使用该依赖的组件--depth numberbit deps diagnose分析工作区依赖的版本扩散、peer 排列组合与冗余扫描node_modules/.pnpm--package string可下钻bit deps circular查找组件图中的循环依赖bit deps write将工作区所有组件依赖写入 package.json 或 workspace.jsonc--target4.4bit ci—— 面向 Git 工作流的 CI 命令ci族专门为 CI/CD 流水线设计bit ci verify每次提交时运行 lint、build 与 status 检查任一环节失败即返回非零退出码适合作为 pre-push 钩子或 CI 早期任务bit ci prPR 打开/更新时把 feature lane 导出到 Bit Cloud支持--lane、--build、--skip-tasks tasks、--skip-cleanup等 flags可在提交信息中加[skip-tasks: ...]令牌跳过指定任务bit ci mergePR 合入 main 后打 tag 并导出新语义化版本默认 bump patch可通过 flags--patch、--minor、--major、--increment level、--prerelease-id id等控制版本递进bit ci sync [lane]无状态协调器将 Bit lane 与 git 分支、PR 双向收敛映射关系在workspace.jsonc的teambit.git/ci: { sync: { ... } }下配置4.5 调试三件套system、doctor、capsulebit system log打印debug.log到屏幕bit system tail-log类似tail -f实时跟踪bit doctor [diagnosis-name]运行全面健康检查--list列出全部诊断项--save [filePath]生成诊断报告--archive [filePath]打包工作区归档可--include-node-modulesbit capsule list / create / delete / prune管理隔离构建环境prune默认清理 30 天--older-than days未使用的 aspect-version 与 scope capsule--dry-run可先预览4.6 认证与远端配置bit login打开浏览器认证 bit.cloud 并自动更新.npmrc--cloud-domain domain、--machine-name name支持自建域与机器认证bit logout清除令牌但保留.npmrc配置bit npmrc generate用 scope、registry 与 token 信息更新.npmrc--dry-run、--forcebit remote add url支持file与http协议例如http://localhost:3000、file:///tmp/local-scope仅自托管场景需要bit.cloud 会自动配置4.7 pattern 语法几乎所有命令共用的过滤语言参考文档反复强调 pattern 的用法这也是 Bit CLI 命令的通用语言简单组件 IDui/button通配多组件org.scope/utils/**或**/utils/**多 pattern 逗号分隔、!排除ui/**, !ui/button务必用引号包裹避免 shell 展开$前缀按状态/属性过滤$deprecated、$modified、$env:teambit.react/react支持的状态有new, modified, deprecated, deleted, internal, snappedOnMain, softTagged, codeModified, localOnlyAND组合$modified AND teambit.workspace/** AND $env:teambit.react/reactbit pattern pattern命令本身即可用于在执行前校验 pattern 是否有效。五、安装、更新与再生成5.1 快速安装Quick InstallREADME.md 提供了标准安装方式把两个文件放进 Claude Code 的 skills 目录mkdir -p ~/.claude/skills/bit-cli curl -fsL SKILL.md 原始地址 -o ~/.claude/skills/bit-cli/SKILL.md curl -fsL CLI_REFERENCE.md 原始地址 -o ~/.claude/skills/bit-cli/CLI_REFERENCE.md也可以使用一行式安装先建目录、进入目录、再用curl -fsLO下载同名文件。安装后目录结构为~/.claude/skills/bit-cli/ ├── SKILL.md # L2 命令索引约 800 token └── CLI_REFERENCE.md # L3 完整参考约 2000 token5.2 保持更新Bit CLI 会随版本迭代新增命令与 flags技能文件需要同步刷新cd ~/.claude/skills/bit-cli # 重新拉取 SKILL.md 与 CLI_REFERENCE.md 即可覆盖更新5.3 再生成针对 Bit 开发者两个文件并非手写维护而是由 Bit CLI 自身的generate命令自动产出。在仓库源码 scopes/harmony/cli/cli.cmd.ts 中CliGenerateCmd定义了--skill type选项type取commands生成 SKILL.md 正文或reference生成 CLI_REFERENCE.md# 生成命令列表SKILL.md 正文 bit cli generate --skill commands # 生成命令参考CLI_REFERENCE.md bit cli generate --skill reference从源码实现看真正干活的类在 scopes/harmony/cli/generate-doc-md.tsgenerateSkillCommands()按group字段把公开命令分组groupCommandsByGroup()对每条命令做名称右对齐padEnd(30)、拼装一句话描述并提取非私有子命令追加Subcommands:行最后套上带name: bit-cli的 YAML front-matter。这与 SKILL.md 中!-- This content is auto-generated by: bit cli generate --skill commands --的注释完全对应。generateSkillReference()递归遍历命令树collectSkillCommandSections对每个命令/子命令生成## bit cmd标题、usage 行自动补全arg/[arg...]参数、描述与 Flags 列表生成 flags 时会过滤掉描述以DEPRECATED或UNSUPPORTED开头的选项确保参考文件只暴露当前有效的接口。这意味着只要 Bit CLI 的命令定义Command 对象的name、description、extendedDescription、options、arguments、commands、private、group字段更新技能文件就能以同一套模板重新生成人工维护成本趋近于零。六、Token 开销量化README 给出了技能各场景的 Token 用量对照这也是渐进式披露的核心价值场景Token 用量技能元数据始终加载约 100命令查询命中索引约 800需要参考细节约 800 约 2000边缘情况回退bit --help对比一次性加载全量参考三层设计把绝大多数查询场景的开销限制在 1000 Token 以内且完全无需 bash 脚本或权限弹窗对长会话的上下文预算非常友好。七、更强的替代方案Bit MCP Server如果需求超越查命令语法需要实时命令发现、跨工具调用与规则注入技能包还给出了更完整的升级路径——Bit MCP Server。在bit mcp-server命令族源码位于 scopes/mcp/cli-mcp-server中bit mcp-server setup claude-codebit mcp-server setup [editor]为 VS Code、Cursor、Windsurf、Roo Code、Cline、Claude Code 等编辑器创建/更新 MCP 集成配置bit mcp-server rules [editor]写入/打印 AI 助手的指导规则文件对 Claude Code 生成.claude/bit.md避免覆盖已有CLAUDE.md--print可仅查看内容bit mcp-server start以 stdio 启动 MCP 服务器支持--include-additional commands扩展可用命令集MCP 服务器提供标准化的工具接口让 AI Agent 可以动态发现并执行 Bit 命令、访问组件信息并支持自定义指令约束 Agent 行为。它的能力更全面但资源占用也更高——这与技能包轻量、零权限、低 Token的定位形成互补读者可根据自身工作流在两者间选择。八、使用建议与注意事项遵循参考优先级AI Agent 应严格按「SKILL.md 索引 → CLI_REFERENCE.md 细节 →bit command --help兜底」的顺序取信息避免在参考已覆盖的情况下绕道运行时帮助。pattern 务必加引号涉及*、!、$的 pattern如ui/**, !ui/button在 shell 中会被展开建议统一用单引号包裹并用bit pattern pattern先行校验。区分易混淆命令remove仅从本地工作区取消跟踪远程删除用deletereset回退未导出的本地 tag/snap已导出版本不可回退eject把组件变成 npm 包eject-conf则是为组件生成 component.json。版本对应技能文件由当前版本的 Bit CLI 自动生成若本地 Bit 版本与技能文件来源版本差异较大建议执行 5.2 节的更新流程保持同步。本仓库中的对应物读者可在 contrib/claude-skill-bit-cli/SKILL.md、contrib/claude-skill-bit-cli/CLI_REFERENCE.md 查看技能全文在 scopes/harmony/cli/generate-doc-md.ts 与 scopes/harmony/cli/cli.cmd.ts 查看生成逻辑在 scopes/mcp/cli-mcp-server 查看 MCP 服务器实现形成「文档 → 生成器 → 运行时」的完整闭环。九、小结claude-skill-bit-cli是 Bit 官方为 AI 编码助手打造的命令防呆层它以渐进式披露把完整的 Bit CLI 命令空间压缩进约 2800 Token 的可检索参考用「先查再执行」的强约束替代模型记忆并且全部内容由bit cli generate --skill从命令定义自动生成、随版本同步更新。对于任何希望在 Claude Code 等 Agent 环境中安全、准确地驱动 Bit 工作流的团队这套技能包或能力更强的 MCP Server都是值得优先接入的基建。赞分享开发工具CLI构建工具MCP 服务【免费下载链接】bitAI-powered development workspaces with reusable components, architectural clarity and zero overhead.项目地址https://gitcode.com/gh_mirrors/bi/bit点击查看免费下载相关推荐Bit CLI命令大全从init到export的完整命令参考Bit CLI命令大全从init到export的完整命令参考 Bit是一个用于开发可组合软件的构建系统它通过CLI命令提供强大的组件管理和协作功能。本文将详开发工具CLI构建工具MCP 服务Claude Code CLI 完全指南claude-howto 命令行参考手册Claude Code CLI 完全指南claude howto 命令行参考手册 Claude Code 的命令行接口CLI是与 Claude Code教程文档Ralph for Claude Code CLI命令参考完整参数列表与用法Ralph for Claude Code CLI命令参考完整参数列表与用法 Ralph for Claude Code是一个专为Claude Code设计的人工智能AI 应用自主智能体CLI开发工具上一篇零代码玩转多模态AIMiniCPM-o-2.6模型多模态推理实践指南下一篇CPython 编译器设计解析从源码到字节码的完整流水线创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Bit CLI 技能包（Claude Code Skill）深度指南：让 AI Agent 精确执行 Bit 命令的渐进式命令参考
开发工具CLI构建工具MCP 服务【免费下载链接】bitAI-powered development workspaces with reusable components, architectural clarity and zero overhead.项目地址https://gitcode.com/gh_mirrors/bi/bit点击查看免费下载本指南围绕 Bit 开源仓库中的 contrib/claude-skill-bit-cli 目录展开讲解其核心文档 SKILL.md 的设计思路、命令全景与使用方式。你将理解为什么 AI Agent 不应凭记忆猜测 Bit 命令、这套「渐进式披露」的层级化参考如何以最小 Token 成本提供最准确的命令语法并掌握安装、更新、自动再生成技能文件以及切换到 Bit MCP Server 的完整方案。一、为什么需要这份技能AI 不该凭记忆猜 Bit 命令Bit 是一个基于组件的开发平台其 CLI 拥有 90 个公开命令、数十个带子命令的命令族如lane、deps、envs、scope、ci以及大量 flags。对于接入 Claude Code 等 AI 编码助手的开发者来说最大的风险不是找不到命令而是让模型从训练记忆里猜一个命令——猜出来的语法可能是旧版、错位甚至根本不存在的最终导致误操作或反复失败。SKILL.md 的 front-matter 对此做了强制约束name: bit-cli description: MUST consult before running ANY bit command. Do NOT guess bit commands from memory. This skill tells you the right command, correct syntax, subcommands, and flags.即在运行任何bit命令之前必须先查阅本技能不得凭记忆猜测命令。这份 description 会被 Claude Code 在相关场景下自动加载从而把先查参考、再执行变成 Agent 的默认行为而非依赖用户的提醒。二、渐进式披露设计三层结构控制 Token 开销整个技能按渐进式披露progressive disclosure设计来自 README.md 的说明分为三个层级层级文件Token 量加载时机内容L1技能元数据front-matter约 100始终加载技能名称与触发约束L2SKILL.md约 800询问 bit 命令时全命令分类索引 一句话描述 子命令列表L3CLI_REFERENCE.md约 2000按需加载每个命令的用法、子命令、参数与 flags兜底bit command --help按需参考文件未覆盖时运行时原生帮助这种设计没有使用任何 bash 脚本、不触发权限弹窗SKILL.md末尾明确指示 Agent 的读取策略IMPORTANT: When you need flags, arguments, or subcommand details, READ the file CLI_REFERENCE.md in this same directory using the Read tool. Only fall back to bit command --help if the reference file doesnt cover what you need.也就是说先看索引SKILL.md需要细节时用 Read 工具读同目录下的 CLI_REFERENCE.md只有参考文件没覆盖的内容才回退到bit --help。三层各司其职避免了把全量参考一次性塞进上下文的高昂开销。三、SKILL.md 命令索引全景按类别继承全部命令SKILL.md是bit --help风格的无色命令索引其注释标明This content is auto-generated by: bit cli generate --skill commands。它开篇给出统一用法usage: bit [--version] [--help] command [args]以下按原文的分类完整罗列每个命令及其一句话描述括号内为子命令方便读者直接作为速查表使用。3.1 系统与工具System Utilityhelp- 显示可用命令与用法信息version- 显示已安装的 Bit 版本config- 管理 Bit 配置项子命令set, del, get, listglobals- 显示 Bit 使用的全局目录与路径system sub-command- 访问系统级操作与调试工具子命令log, tail-logdoctor [diagnosis-name]- 诊断并排查工作区问题clear-cache- 清除缓存数据以解决数据过期问题3.2 工作区命令Workspace commandsdetails- 显示上一条命令如 tag、snap提供的扩展详情3.3 信息与分析Information Analysisshow component-name- 显示组件元数据、依赖与配置cat component-id- 打印指定版本组件的源码文件或配置graph [id]- 将组件依赖关系可视化为图图片pattern pattern- 测试并校验组件 pattern 语法list [remote-scope]- 显示工作区或远程 scope 中的组件search query...- 在本地工作区与远程 bit cloud 中按关键字搜索组件schema pattern- 显示组件 API schema 与类型定义子命令diffdiff [component-pattern] [version] [to-version]- 对比组件在版本间或与当前工作区之间的变更status- 显示工作区组件状态与问题3.4 组件配置Component Configurationenvs- 显示组件及其分配的环境子命令list, get, set, unset, replace, updatescope sub-command- 管理组件 scope 名称与归属子命令set, trust, rename, rename-owner, forkeject-conf pattern- 为组件生成 component.json 配置文件local-only sub-command- 管理仅存在于工作区的组件子命令set, unset, listaspect sub-command- 管理组件 aspect 及其配置子命令list, list-core, get, set, unset, update3.5 协作与远程Collaboration Remoteremote- 为自托管环境管理远程 scope子命令add, del, listripple sub-command- 管理 bit.cloud 上的 Ripple CI 任务子命令list, log, errors, retry, stop, simulatedeprecate component-pattern- 标记组件已弃用以提示不要继续使用undeprecate component-pattern- 移除组件的弃用状态import [component-patterns...]- 将远程 scope 中的组件导入工作区delete component-pattern- 对远程 scope 中的组件执行软删除recover component-pattern- 恢复被软删除的组件export [component-patterns...]- 将组件上传到远程 scopelane [sub-command]- 管理 lane 以支持并行开发子命令list, show, create, remove, change-scope, alias, rename, remove-readme, import, remove-comp, fetch, eject, current, history, history-diff, checkout, revert, updates, merge-moveci sub-command- 面向自动化工作流的持续集成命令子命令verify, pr, merge, syncfork pattern [target-component-name]- 复制现有组件以创建新组件internalize [component-pattern]- 将组件标记为 internal使其在 UI 中默认隐藏3.6 运行与服务Run Servestart [component-pattern]- 启动 Bit 开发服务器run [app-name]- 本地启动应用组件app [sub-command]- 管理应用组件子命令list, run3.7 高级/调试Advanced/Debugcapsule- 管理隔离的组件环境子命令list, create, delete, prunemcp-server [sub-command]- 为 AI 助手启动 Model Context Protocol 服务器子命令start, setup, rules3.8 开发组件Develop componentsscript [script-name]- 运行由环境定义的脚本3.9 认证与云端Authentication Cloudlogin- 认证 Bit Cloud 以发布组件与协作logout- 登出 Bit Cloud 并清除认证令牌whoami- 显示当前已认证的 Bit Cloud 用户npmrc [sub-command]- 用 Bit Cloud registry 与认证配置生成 .npmrc子命令generate3.10 工作区工具Workspace Toolsws-config sub-command- 生成 IDE 配置文件子命令write, clean, listgit sub-command- Bit 仓库的 Git 工具子命令set-merge-driverrefactor sub-command- 自动重构组件源码子命令dependency-name3.11 组件开发Component Developmentadd [path...]- 将现有目录内容跟踪为工作区新组件create template-name component-names...- 从模板脚手架生成新组件源码、配置与环境templates- 列出可用于创建组件与工作区的模板watch- 监听文件变化并编译组件build [component-pattern]- 在隔离环境中运行构建流水线任务compile [component-names...]- 转译组件源文件move current-component-dir new-component-dir- 将组件移动到不同目录remove component-pattern- 从工作区取消跟踪组件rename current-name new-name- 修改组件名称3.12 工作区与项目搭建Workspace Project Setupnew template-name workspace-name- 从模板创建新的 Bit 工作区init [path]- 在现有项目中初始化 Bit 工作区3.13 测试与质量Testing Qualityartifacts component-pattern- 查看并下载构建产物test [pattern-or-test-file...]- 运行组件测试check-types [component-pattern]- 校验 TypeScript 类型正确性lint [component-pattern]- 分析组件代码问题与风格违规validate [component-pattern]- 依次执行类型检查、lint 与测试format [component-pattern]- 自动格式化组件源码3.14 依赖与包Dependencies Packagesinstall [packages...]- 安装工作区依赖uninstall [packages...]- 从工作区移除依赖update [package-patterns...]- 将工作区依赖更新到较新版本link [component-names...]- 在组件与 node_modules 之间建立链接eject component-pattern- 将组件移出工作区并作为 npm 包安装deps sub-command- 管理组件依赖子命令get, remove, unset, debug, set, reset, eject, blame, usage, diagnose, circular, writewhy dependency-name- 查找使用指定依赖的组件set-peer component-id range- 配置组件始终以 peer dependency 方式安装unset-peer component-id- 移除组件的 always-peer 配置dependents component-name- 显示依赖指定组件的组件3.15 版本控制Version Controlcheckout to [component-pattern]- 切换组件版本或移除本地变更revert component-pattern to- 用指定版本替换组件文件但保留当前版本tag [component-patterns...]- 以语义化版本标签创建不可变组件快照snap [component-pattern]- 为开发版本创建不可变组件快照reset [component-pattern]- 将本地 tag 与 snap 回退到先前版本merge [component-pattern]- 当本地与远程版本不同时合并分叉的组件历史stash sub-command- 临时保存与恢复组件变更子命令save, load, listlog id- 显示组件版本历史log-file filepath- EXPERIMENTAL显示特定文件的变更历史blame filepath- EXPERIMENTAL按行显示作者与修改历史四、第二层参考 CLI_REFERENCE.md子命令、参数与 flags 的权威来源当索引层不足以支撑执行时Agent 应读取 CLI_REFERENCE.md。这份文件为每个命令生成## bit command章节包含用法行usage、一句话描述与扩展描述、以及Flags 列表有子命令的命令族如bit lane ...、bit deps ...会为每个子命令递归生成独立小节。以几个高频命令为例4.1bit tag—— 语义化版本发布## bit tag [component-patterns...] creates tagged versions using semantic versioning (semver) for component releases. tags are immutable and exportable. by default tags all new and modified components. supports version specification per pattern using (e.g. foo1.0.0, barminor). use for official releases. for development versions, use bit snap instead.按 pattern 指定版本bit tag foo1.0.0 barminor版本递进 flags--patch、--minor、--major、--increment level、--prerelease-id id、--pre-release [identifier]、--auto-tag-increment level构建与流水线--build、--skip-tests、--skip-tasks string、--disable-tag-pipeline、--ignore-build-errors、--rebuild-deps-graph其他--message message、--unmodified、--editor [editor]、--versions-file path、--soft、--fail-fast、--loose、--ignore-issues issues等4.2bit checkout to—— 版本切换的核心语义checkout的to参数接受五类取值参考文档给出了精确语义head切到最后一次 snap/tag最常见用法具体版本号切到精确版本如bit checkout 1.0.5 component-namehead~x从 head 回退 x 代如head~2latest切到最新的 semver tagreset移除本地修改并恢复原始文件同时恢复被删除的组件目录在 lane 上checkout head只影响 lane 组件要更新 main 组件需运行bit lane merge main。合并相关 flags 包括--interactive-merge、--auto-merge-resolve merge-strategy、--force-ours、--force-theirs、--manual等。4.3bit deps—— 依赖治理全家桶deps族覆盖依赖的读、写、查、诊bit deps get component-name显示直接与间接依赖--scope、--treebit deps set / remove / unset pattern package...配置或移除依赖--dev、--peer、--optionalbit deps debug component-name显示直接依赖及其版本是如何确定的bit deps blame component-name dependency-name定位哪个 snap/tag 改变了依赖版本bit deps usage dependency-name查找使用该依赖的组件--depth numberbit deps diagnose分析工作区依赖的版本扩散、peer 排列组合与冗余扫描node_modules/.pnpm--package string可下钻bit deps circular查找组件图中的循环依赖bit deps write将工作区所有组件依赖写入 package.json 或 workspace.jsonc--target4.4bit ci—— 面向 Git 工作流的 CI 命令ci族专门为 CI/CD 流水线设计bit ci verify每次提交时运行 lint、build 与 status 检查任一环节失败即返回非零退出码适合作为 pre-push 钩子或 CI 早期任务bit ci prPR 打开/更新时把 feature lane 导出到 Bit Cloud支持--lane、--build、--skip-tasks tasks、--skip-cleanup等 flags可在提交信息中加[skip-tasks: ...]令牌跳过指定任务bit ci mergePR 合入 main 后打 tag 并导出新语义化版本默认 bump patch可通过 flags--patch、--minor、--major、--increment level、--prerelease-id id等控制版本递进bit ci sync [lane]无状态协调器将 Bit lane 与 git 分支、PR 双向收敛映射关系在workspace.jsonc的teambit.git/ci: { sync: { ... } }下配置4.5 调试三件套system、doctor、capsulebit system log打印debug.log到屏幕bit system tail-log类似tail -f实时跟踪bit doctor [diagnosis-name]运行全面健康检查--list列出全部诊断项--save [filePath]生成诊断报告--archive [filePath]打包工作区归档可--include-node-modulesbit capsule list / create / delete / prune管理隔离构建环境prune默认清理 30 天--older-than days未使用的 aspect-version 与 scope capsule--dry-run可先预览4.6 认证与远端配置bit login打开浏览器认证 bit.cloud 并自动更新.npmrc--cloud-domain domain、--machine-name name支持自建域与机器认证bit logout清除令牌但保留.npmrc配置bit npmrc generate用 scope、registry 与 token 信息更新.npmrc--dry-run、--forcebit remote add url支持file与http协议例如http://localhost:3000、file:///tmp/local-scope仅自托管场景需要bit.cloud 会自动配置4.7 pattern 语法几乎所有命令共用的过滤语言参考文档反复强调 pattern 的用法这也是 Bit CLI 命令的通用语言简单组件 IDui/button通配多组件org.scope/utils/**或**/utils/**多 pattern 逗号分隔、!排除ui/**, !ui/button务必用引号包裹避免 shell 展开$前缀按状态/属性过滤$deprecated、$modified、$env:teambit.react/react支持的状态有new, modified, deprecated, deleted, internal, snappedOnMain, softTagged, codeModified, localOnlyAND组合$modified AND teambit.workspace/** AND $env:teambit.react/reactbit pattern pattern命令本身即可用于在执行前校验 pattern 是否有效。五、安装、更新与再生成5.1 快速安装Quick InstallREADME.md 提供了标准安装方式把两个文件放进 Claude Code 的 skills 目录mkdir -p ~/.claude/skills/bit-cli curl -fsL SKILL.md 原始地址 -o ~/.claude/skills/bit-cli/SKILL.md curl -fsL CLI_REFERENCE.md 原始地址 -o ~/.claude/skills/bit-cli/CLI_REFERENCE.md也可以使用一行式安装先建目录、进入目录、再用curl -fsLO下载同名文件。安装后目录结构为~/.claude/skills/bit-cli/ ├── SKILL.md # L2 命令索引约 800 token └── CLI_REFERENCE.md # L3 完整参考约 2000 token5.2 保持更新Bit CLI 会随版本迭代新增命令与 flags技能文件需要同步刷新cd ~/.claude/skills/bit-cli # 重新拉取 SKILL.md 与 CLI_REFERENCE.md 即可覆盖更新5.3 再生成针对 Bit 开发者两个文件并非手写维护而是由 Bit CLI 自身的generate命令自动产出。在仓库源码 scopes/harmony/cli/cli.cmd.ts 中CliGenerateCmd定义了--skill type选项type取commands生成 SKILL.md 正文或reference生成 CLI_REFERENCE.md# 生成命令列表SKILL.md 正文 bit cli generate --skill commands # 生成命令参考CLI_REFERENCE.md bit cli generate --skill reference从源码实现看真正干活的类在 scopes/harmony/cli/generate-doc-md.tsgenerateSkillCommands()按group字段把公开命令分组groupCommandsByGroup()对每条命令做名称右对齐padEnd(30)、拼装一句话描述并提取非私有子命令追加Subcommands:行最后套上带name: bit-cli的 YAML front-matter。这与 SKILL.md 中!-- This content is auto-generated by: bit cli generate --skill commands --的注释完全对应。generateSkillReference()递归遍历命令树collectSkillCommandSections对每个命令/子命令生成## bit cmd标题、usage 行自动补全arg/[arg...]参数、描述与 Flags 列表生成 flags 时会过滤掉描述以DEPRECATED或UNSUPPORTED开头的选项确保参考文件只暴露当前有效的接口。这意味着只要 Bit CLI 的命令定义Command 对象的name、description、extendedDescription、options、arguments、commands、private、group字段更新技能文件就能以同一套模板重新生成人工维护成本趋近于零。六、Token 开销量化README 给出了技能各场景的 Token 用量对照这也是渐进式披露的核心价值场景Token 用量技能元数据始终加载约 100命令查询命中索引约 800需要参考细节约 800 约 2000边缘情况回退bit --help对比一次性加载全量参考三层设计把绝大多数查询场景的开销限制在 1000 Token 以内且完全无需 bash 脚本或权限弹窗对长会话的上下文预算非常友好。七、更强的替代方案Bit MCP Server如果需求超越查命令语法需要实时命令发现、跨工具调用与规则注入技能包还给出了更完整的升级路径——Bit MCP Server。在bit mcp-server命令族源码位于 scopes/mcp/cli-mcp-server中bit mcp-server setup claude-codebit mcp-server setup [editor]为 VS Code、Cursor、Windsurf、Roo Code、Cline、Claude Code 等编辑器创建/更新 MCP 集成配置bit mcp-server rules [editor]写入/打印 AI 助手的指导规则文件对 Claude Code 生成.claude/bit.md避免覆盖已有CLAUDE.md--print可仅查看内容bit mcp-server start以 stdio 启动 MCP 服务器支持--include-additional commands扩展可用命令集MCP 服务器提供标准化的工具接口让 AI Agent 可以动态发现并执行 Bit 命令、访问组件信息并支持自定义指令约束 Agent 行为。它的能力更全面但资源占用也更高——这与技能包轻量、零权限、低 Token的定位形成互补读者可根据自身工作流在两者间选择。八、使用建议与注意事项遵循参考优先级AI Agent 应严格按「SKILL.md 索引 → CLI_REFERENCE.md 细节 →bit command --help兜底」的顺序取信息避免在参考已覆盖的情况下绕道运行时帮助。pattern 务必加引号涉及*、!、$的 pattern如ui/**, !ui/button在 shell 中会被展开建议统一用单引号包裹并用bit pattern pattern先行校验。区分易混淆命令remove仅从本地工作区取消跟踪远程删除用deletereset回退未导出的本地 tag/snap已导出版本不可回退eject把组件变成 npm 包eject-conf则是为组件生成 component.json。版本对应技能文件由当前版本的 Bit CLI 自动生成若本地 Bit 版本与技能文件来源版本差异较大建议执行 5.2 节的更新流程保持同步。本仓库中的对应物读者可在 contrib/claude-skill-bit-cli/SKILL.md、contrib/claude-skill-bit-cli/CLI_REFERENCE.md 查看技能全文在 scopes/harmony/cli/generate-doc-md.ts 与 scopes/harmony/cli/cli.cmd.ts 查看生成逻辑在 scopes/mcp/cli-mcp-server 查看 MCP 服务器实现形成「文档 → 生成器 → 运行时」的完整闭环。九、小结claude-skill-bit-cli是 Bit 官方为 AI 编码助手打造的命令防呆层它以渐进式披露把完整的 Bit CLI 命令空间压缩进约 2800 Token 的可检索参考用「先查再执行」的强约束替代模型记忆并且全部内容由bit cli generate --skill从命令定义自动生成、随版本同步更新。对于任何希望在 Claude Code 等 Agent 环境中安全、准确地驱动 Bit 工作流的团队这套技能包或能力更强的 MCP Server都是值得优先接入的基建。赞分享开发工具CLI构建工具MCP 服务【免费下载链接】bitAI-powered development workspaces with reusable components, architectural clarity and zero overhead.项目地址https://gitcode.com/gh_mirrors/bi/bit点击查看免费下载相关推荐Bit CLI命令大全从init到export的完整命令参考Bit CLI命令大全从init到export的完整命令参考 Bit是一个用于开发可组合软件的构建系统它通过CLI命令提供强大的组件管理和协作功能。本文将详开发工具CLI构建工具MCP 服务Claude Code CLI 完全指南claude-howto 命令行参考手册Claude Code CLI 完全指南claude howto 命令行参考手册 Claude Code 的命令行接口CLI是与 Claude Code教程文档Ralph for Claude Code CLI命令参考完整参数列表与用法Ralph for Claude Code CLI命令参考完整参数列表与用法 Ralph for Claude Code是一个专为Claude Code设计的人工智能AI 应用自主智能体CLI开发工具上一篇零代码玩转多模态AIMiniCPM-o-2.6模型多模态推理实践指南下一篇CPython 编译器设计解析从源码到字节码的完整流水线创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考