Squad 是一个用于管理与 Squad 看板(board)上任务的技能,主要以斜杠命令的形式在会话中使用。它围绕一个 7 列流水线看板工作,支持任务的完整生命周期操作以及项目上下文的管理。
用途
该技能的核心用途有两方面:一是任务管理(在看板上增删改查、流转与统计任务);二是项目上下文对接(加载项目信息、维护项目简报与项目间关系),以便智能体在会话开始时快速获取项目配置、方向与近期决策。
主要能力
任务操作
- 查看看板:
/squad或/squad list,输出包含 ID、Status、Priority、Title 的 markdown 表格,并将子任务按其 epic 分组显示(含 children_progress,如 2/5 done)。 - 会话交接上下文:
/squad context,输出流水线状态(Implementing / Plan Review / Impl Review / Testing / Recently Done / Next Todo),建议在新会话开始时首先运行。 - 新增任务:
/squad add <title>,会询问优先级、级别(L1/L2/L3)、描述与标签,构建 JSON 后 POST 到 API,并返回新任务 ID。 - 移动任务:
/squad move <ID> <status>,遵循 Move Protocol(先检查当前状态与级别,再查阅矩阵,最后执行移动)。 - 编辑任务:
/squad edit <ID>,询问要修改的字段后通过 PATCH 更新。 - 完成任务:
/squad complete <ID> [note],可从任意非终态标记为完成,非交互、可逆、保留历史。 - 取消任务:
/squad cancel <ID> [reason],用于放弃工作(won't-do / superseded / deprioritized 的推荐方式),非交互、可逆、保留历史。 - 重开任务:
/squad reopen <ID>,将终态任务(cancelled 或 done)恢复为 todo,是取消/完成的逆向路径。 - 删除任务:
/squad remove <ID>,为硬删除(DELETE),不可逆,仅用于从未开始的错误或重复项。 - 统计:
/squad stats,显示各列数量与按执行者(actor)汇总的 token/事件统计。
附件
在新增任务或编辑任务时,可通过附件 API 上传本地图片文件(需提供文件路径)。若用户粘贴图片而无路径,需先保存为文件。
项目上下文
/squad project:获取当前项目上下文(用途、技术栈、简报、分类与状态、各状态任务数、关联项目链接)。/squad project all:按分类分组获取全部项目。/squad project brief:查看/更新项目简报(200–500 字符的压缩上下文摘要),也支持 AI 辅助更新(分析当前状态与近期完成项后起草简报并提交确认)。/squad project update <field> <value>:更新项目字段(支持 name、purpose、stack、brief、status、category、repo_url)。/squad project link:管理项目间关系(extends、serves、depends_on、shares_data)。
观察同意
/squad observe status|dry-run:只读地检查观察同意门控,显示当前开关状态、决策来源、policy_version 等;dry-run 会打印将要记录的抽象化 user_steering 载荷,但不写入任何内容。注意:授权/撤回操作不在该技能中进行,而在 Web 应用(Settings → Observation & Consent)中完成。
使用方式
该技能通过仓库根目录的 .squadrc 文件(包含 SQUAD_PROJECT,以及可选的 SQUAD_ORG)来指定看板项目,该文件需提交以便团队所有智能体指向同一看板项目。认证令牌不写入项目文件,而作为 Personal Access Token 解析,优先级为 SQUAD_AUTH_TOKEN 环境变量 > ~/.squad/auth 中的 SQUAD_AUTH_TOKEN=。使用前需先运行 /squad-init 注册项目。看板可通过 https://squad.steloit.com/?project=<PROJECT>(或配置的 SQUAD_BASE_URL)访问,具备 7 列流水线、拖拽(仅允许有效流转)、卡片生命周期弹窗、智能体日志查看器与 10 秒自动刷新等功能。
适用场景
适用于需要以看板方式跟踪任务、管理多项目上下文、在多个智能体会话间保持项目配置与方向一致的团队工作流。
限制
删除(remove)不可逆;重开非终态任务会返回 409;取消已完成任务会返回 409(需先重开);观察同意的授权/撤回需在 Web 应用中进行。关于具体收费、价格、平台支持范围等信息,资料中暂未提供。