CLI 参考

squads 命令行工具的完整参考。

npm install -g squads

squads add <sources...>

从多个来源同时安装小队到您的项目中——GitHub 仓库、本地目录或 squads.sh 注册表。小队将被下载、验证并放置在项目的 squads 目录中。

用法
squads add <sources...> [options]
选项
--skill <name>Specify which squad to install when repo has multiple squads
-a, --agent <name>Install a specific agent from the squad
-g, --globalInstall globally instead of in the current project
-y, --yesSkip confirmation prompts
--aios <mode>AIOS integration mode: new (create project) or existing (use current)
--aios-path <path>Path to the AIOS project (for existing mode)
示例

Install from GitHub

squads add owner/repo

Install from local directory

squads add ./my-squad

Install from registry

squads add design-system

Install multiple squads at once

squads add slug1 slug2 slug3

Install into a new AIOS project

squads add my-squad --aios new

Install into an existing AIOS project

squads add my-squad --aios existing

Install a specific agent

squads add my-squad --agent designer

squads find [query]

按关键词搜索市场中的小队。返回匹配小队的列表,包含安装量和评分。

用法
squads find [query] [options]
选项
-l, --limit <n>Maximum number of results (default: 20)
示例

Search by keyword

squads find "design system"

List all squads

squads find

squads list (ls)

列出当前项目中已安装的所有小队。显示名称、版本、智能体数量和安装路径。

用法
squads list [options]
选项
-g, --globalList globally installed squads
示例

List installed squads

squads list

List globally installed squads

squads list --global

squads check

验证所有已安装的小队。检查结构完整性、缺失文件和损坏的交叉引用。

用法
squads check
示例

Check installed squads

squads check

squads update [squad]

将一个或所有已安装的小队更新到最新版本。不指定小队名称时更新所有小队。

用法
squads update [squad] [options]
选项
-y, --yesSkip confirmation prompts
示例

Update all squads

squads update

Update a specific squad

squads update design-system-squad

squads remove (rm) <squad>

从项目中移除已安装的小队。清理小队目录和所有已同步的斜杠命令。

用法
squads remove <squad> [options]
选项
-y, --yesSkip confirmation prompts
示例

Remove a squad

squads remove old-squad

Remove without confirmation

squads remove old-squad -y

squads init [name]

初始化一个新的小队项目并生成脚手架。创建目录结构、squad.yaml 和基础的智能体/任务/工作流文件。

用法
squads init [name] [options]
选项
-y, --yesSkip confirmation prompts and use defaults
示例

Create a new squad

squads init my-squad

Create with defaults

squads init my-squad -y

squads validate [path]

对小队目录进行深度验证。检查 6 个加权类别(清单、结构、智能体、任务、工作流、交叉引用),生成 0 到 100 的评分。

用法
squads validate [path] [options]
选项
--json输出原始 JSON 报告
--fix验证前自动修复常见问题
示例

Validate current directory

squads validate

Validate a specific squad

squads validate ./squads/my-squad

JSON output

squads validate --json

Auto-fix then validate

squads validate --fix

squads fix [path]

自动修复小队中的常见验证问题。修复 frontmatter 格式、archetype、类型、语气和 greeting levels。使用 --dry-run 预览更改而不修改文件。

用法
squads fix [path] [options]
选项
--dry-run显示将修复的内容而不修改文件
示例

Auto-fix current squad

squads fix

Fix a specific squad

squads fix ./squads/my-squad

Preview fixes

squads fix --dry-run

squads publish [squad-name]

将小队发布到 squads.sh 市场。一次选择多个小队并选择目标仓库。

用法
squads publish [squad-name] [options]
选项
--dry-run仅验证不发布
--strict验证状态不是 SAFE 时失败
--price <cents>设定价格(美分,例如 2990 表示 $29.90,0 表示免费)
示例

从本地小队多选

squads publish

按名称发布小队

squads publish my-squad

从指定路径发布

squads publish ./squads/my-squad

Dry run 发布前验证

squads publish --dry-run

严格模式(要求 SAFE 状态)

squads publish my-squad --strict

定价发布($29.90)

squads publish --price 2990

免费发布

squads publish --price 0

squads login

使用 GitHub device flow 在 squads.sh 上进行身份验证。在发布小队之前必须执行此操作。

用法
squads login
示例

Authenticate via GitHub

squads login
CLI 参考 — SQUADS