> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senseaudio.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见工作流

> 面向真实开发场景的 Step-by-Step 任务模板，帮你把 Agent 用熟

以下工作流的思路适用于任何 Agent 工具（Claude Code / Cursor / Cline 等），均已在 **S2**（`senseaudio-s2`）上验证，请按您使用的工具对应调整具体操作。

***

## 工作流 1：快速理解陌生代码库

**适用场景**：刚加入新项目 / 接手遗留系统 / 评审第三方仓库。

<Steps>
  <Step title="让 Agent 画一张架构图（文字版）">
    ```
    请阅读当前仓库，产出一份 200 字以内的总览：核心模块、关键入口文件、主要依赖、
    可能的技术债。
    ```
  </Step>

  <Step title="锁定核心路径">
    ```
    基于上一步的总览，请列出「新功能开发时最常被改动的 5 个文件」，并解释原因。
    ```
  </Step>

  <Step title="沉淀到项目记忆">
    让 Agent 把上两步结论写入 `CLAUDE.md` / `AGENTS.md` / `SENSEAUDIO.md`，后续所有会话自动继承。
  </Step>

  <Step title="（可选）语音播报">
    调用 [`senseaudio-tts-1.5-260319`](/guides/tts/overview) 把总览朗读成音频，通勤路上也能复习。
  </Step>
</Steps>

***

## 工作流 2：Bug 定位与修复

<Steps>
  <Step title="给出 GCCV 开场白">
    明确报错信息（Goal：恢复 `/checkout` 接口可用）、相关文件（Context：`error.log` + `checkout/handler.py`）、禁改范围（Constraint：不改 DB schema）、验收标准（Validation：回归测试全过）。
  </Step>

  <Step title="让 Agent 先复现，再定位">
    ```
    先在本地复现该报错；复现成功后停下，告诉我最可能的根因，再让我决定是否修复。
    ```

    这一步强制 Agent 把**复现 → 假设 → 修复**三步拆开，避免盲目修改。
  </Step>

  <Step title="修复并跑测试">
    让 Agent 给出最小 diff，运行单测与回归用例，打印通过情况。
  </Step>

  <Step title="写回 CHANGELOG">
    完成后，让 Agent 把根因、修复要点、影响范围补充到 CHANGELOG。
  </Step>
</Steps>

***

## 工作流 3：从需求口述到代码落地（语音驱动开发）

这是 SenseAudio Token Plan 的独特玩法，其他同类 Coding Plan 不提供。

<Steps>
  <Step title="口述需求">
    打开支持 ASR 的前端（或你自己的小脚本），调用 [`senseaudio-asr-1.5-260319`](/guides/asr/overview) 把口述转写为文字。
  </Step>

  <Step title="LLM 整理为 GCCV">
    把转写结果扔给 S2：

    ```
    以下是一段口述需求，请整理成 Goal / Context / Constraint / Validation 四段式，
    如有不清楚的假设请先标出不要替我决定。
    ```
  </Step>

  <Step title="确认后交给 Agent 执行">
    把整理后的开场白粘贴进任意 Agent 工具，进入常规编码流程。
  </Step>
</Steps>

***

## 工作流 4：生成可对外展示的交付物

适用场景：PR 描述、周报、客户演示、内部分享。

<Steps>
  <Step title="代码讲解文稿">
    让 S2 基于 diff 产出 3 段讲解稿（技术视角 / 产品视角 / 风险视角）。
  </Step>

  <Step title="配图">
    把关键架构变化写成 prompt，调用 [`senseaudio-image-2.0-260319`](/guides/image/overview) 出一张示意图。
  </Step>

  <Step title="视频演示">
    用 [`doubao-seedance-2-0-260128`](/guides/video/overview) 基于一张截图 + 一段文案生成 15 秒演示片段。
  </Step>

  <Step title="配音">
    把讲解稿用 [`senseaudio-tts-1.5-260319`](/guides/tts/overview) 合成旁白音频。
  </Step>
</Steps>

<Tip>
  以上四步全部走 Token Plan 额度，无需额外账户，也无需跨平台接入。
</Tip>

***

## 工作流 5：长任务的断点续传

当任务跨越多个 Agent 会话时，推荐：

<Steps>
  <Step title="结构化 TODO 文件">
    让 Agent 维护 `PROGRESS.md`，按 `✅ / ⏳ / ⬜` 打点，每轮开始前先读它。
  </Step>

  <Step title="结束前写 handoff 备忘">
    ```
    在你停下前，请在 PROGRESS.md 追加一段 20 字以内的 handoff：
    下一轮应从哪一步开始、上下文要点、潜在坑。
    ```
  </Step>

  <Step title="新会话只读 handoff">
    新开会话时不必从头交代，直接 "阅读 PROGRESS.md 末段 handoff，继续推进"。
  </Step>
</Steps>

## 相关资源

<CardGroup cols={2}>
  <Card title="Agent 工作原理" icon="microchip" href="/guides/token-plan/how-agent-works" />

  <Card title="S系列 使用技巧" icon="lightbulb" href="/guides/token-plan/best-practices" />
</CardGroup>