SuperAPI AI 工具集

squad-init

办公与效率

查看项目

更新于 10-16 08:09

技能介绍

用途:把当前项目注册到 Squad 看板,让后续 /squad 命令指向该项目。项目记录写入共享中央 PostgreSQL,并生成本地配置;不创建每项目数据库文件。

用法:/squad-init(项目名取当前目录 basename,看板用默认地址);/squad-init my-project-name(显式项目名);/squad-init my-project-name https://board.example.com(显式项目名加自定义看板 URL);/squad-init https://board.example.com(当前目录名加自定义看板 URL)。若参数含 URL 则作为 base_url;项目名会去掉前导连字符。

主要行为:在项目根目录生成并提交 .squadrc,含 SQUAD_PROJECT 与必填的 SQUAD_ORG(组织标识,所有看板调用均按组织作用域 /api/orgs/<org>/...)。SQUAD_ORG 只从显式参数或 mint 对话框的 SQUAD_ORG 行解析,不从看板自动推导;缺失则报错退出,不会在没有组织标识时注册。随后尽力通过 POST /api/projects 把项目元数据(分类、用途、技术栈、仓库地址,可由 CLAUDE.md 与 git remote 推断)写入 projects 表,失败不影响初始化成功。自定义非默认看板 URL 会写入 ~/.squad/config。

认证:令牌为 Personal Access Token,仅存放于环境变量 SQUAD_AUTH_TOKEN 或 ~/.squad/auth(600 权限),绝不写入 .squadrc;令牌的生成与存储命令只存在于看板网页 UI 的 Settings → Personal Access Tokens。无令牌时仅打印指向该 UI 的一行提示,不索取、不回显令牌。

已有配置:若 .squadrc 已存在,会先询问是覆盖更新 SQUAD_PROJECT 还是保持不变。

限制:默认看板为指定 API 地址,除非提供其他部署 URL;令牌与组织相关细节以看板网页为准。其余未在资料中说明的功能、收费与平台信息暂未提供。