SuperAPI AI 工具集

squad

办公与效率

查看项目

更新于 10-16 02:02

技能介绍

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 应用中进行。关于具体收费、价格、平台支持范围等信息,资料中暂未提供。