SuperAPI AI 工具集

squad-explore

编程与开发

查看项目

更新于 10-16 03:39

技能介绍

一、用途 /squad-explore [topic] 用于“有模糊想法但不知如何实现”的场景。它先探索代码库、报告可行方向,再把分阶段任务写入 squad 看板。该技能明确不写代码。

二、主要能力

  1. 主题校验与澄清:若缺少涉及代码区域、原因或范围无界,会进行一轮最多 2 个问题的澄清。
  2. 深度探索:以 Explore 子代理按项目结构、主题相关代码、痛点与缺口、技术约束四部分调查,每条结论尽量给出文件路径与行号。
  3. 架构规划:以 Plan 子代理产出 2–3 个真正不同的方向(含方案、优缺点、复杂度、涉及文件、风险),给出推荐方向,并拆解 3–7 个按序任务,最后一个任务固定为 E2E 测试。
  4. 生成报告并让用户选择方向,随后创建 epic 锚点卡和实现任务,通过 parent 关系挂到 epic,并回填任务索引。

三、必要用法 先读取 ../squad/shared.md 与 ../squad/principles.md。解析观察门控:python3 ../squad/scripts/observe.py gate >/dev/null 2>&1; OBSERVE_OK=$?,并生成 correlation_id:CID=$(python3 -c 'import uuid;print(uuid.uuid4())')。创建与关联任务使用:api POST /task --json "..."、api POST /task/$CHILD_ID/relationships --json "$(jq -n --arg to "$REPORT_ID" '{to:$to, type:"parent"}')"、api PATCH /task/$REPORT_ID --json "{"description": "..."}"。完成后可运行 /squad-refine <ID> 或 /squad-run <ID>。

四、适用场景与限制 适用于实现路径不明的功能规划、重构方向评估。限制:不实现代码、不臆断模式,无证据须标注“未找到”;用户取消时仅保存报告锚点、不创建任务;每个任务应可独立完成,涉及超过 3 个不相关文件需拆分;报告无论是否继续创建任务都必须持久保存。关于收费、平台等信息暂未提供。