用途：本技能教你如何驱动 stackbone CLI，包括操作顺序、各命令遵循的约定以及常见循环，但不包含标志表，所有标志、输出格式与退出码都在文档里（每命令一页）。文档通过 stackbone-docs MCP 服务器提供（https://docs.stackbone.ai/mcp，公开，工具 search_docs、get_doc、list_docs），stackbone docs 会打印连接信息。若无 MCP 工具，可抓取 https://docs.stackbone.ai/llms.txt 作为索引，或 https://docs.stackbone.ai/llms-full.txt 获取全部页面。
调用方式：二进制名为 stackbone，可用 pnpm dlx @stackbone/cli <command> 免安装运行，或 pnpm add -g @stackbone/cli 全局安装。作为调用方时每条命令都加 --json（stdout 输出一行 schema_version 为 1 的 JSON，stderr 输出 error 对象）；破坏性动词（retry、cancel、remove、rollback、approve、reject）必须加 --yes，否则退出码 5；--json、--yes 和 CI=1 会关闭提示，需要交互的命令会直接报错，所以必填值都要用标志传入。退出码：0 成功，1 通用错误，2 未认证（需 stackbone login），3 无项目或 dev 未运行，4 未找到，5 无权限。
会话开始：先运行 stackbone whoami --json（退出 2 则登录，设备流，无头环境加 --no-browser）和 stackbone metadata --json（退出 3 则 init 或 link）。
主要流程：新建工作区用 login → init <dir> → cd → dev；扩展用 add agent/workflow/workflow-agent；开发循环用 dev（启动 Postgres、Redis、MinIO 并热重载，首次需配置模型提供方），再用 workflows list/start、runs get、logs tail 观察；Schema 变更用 db migrate create 等；交付用 package 或 build 后 link 注册；CI 环境需携带 ~/.stackbone/credentials.json（chmod 600），并全程加 --json、--yes。
限制：绝不要提交 .stackbone/ 目录；密钥永不打印，没有 reveal 命令；分页列表用 --limit 与 --cursor；db query 仅支持只读 SELECT；RAG schema 由平台提供，不可手动迁移；publish、openrouter、connectors 等命令已废弃。文档与二进制不一致时以二进制为准。