跳转到内容

规划并实现一个修改

先描述希望得到的结果。在 Spark 理解任务之前,不需要先选择执行机制。

Terminal window
cd <工作区>
spark

然后用自然语言描述目标:

修复登录失败,但不要改变公开 API。运行相关测试,并在宣布完成前展示验证证据。
名称 含义
工作区(Workspace) Spark 正在处理的仓库或目录
会话(Session) 持续的对话及其上下文
任务(Task) 目标中一个可以独立验证的部分
运行(Run) 一次执行尝试
产物(Artifact) Preview、Issue 或 Pull Request 等持久结果

这五个名称足以完成主路径。需要时再到 CLI 参考中查看运维细节。

当修改需要调查或包含多个有效步骤时,使用 /plan

/plan 修复登录失败。先检查当前实现,创建可验证任务,但暂时不要实现。

Spark 会调查工作区并创建或完善持久任务。检查建议的范围、成功条件、依赖和 验证命令,然后直接用自然语言调整:

这次不修改数据库迁移。把浏览器回归测试加入成功条件。

计划确认后:

/implement 执行刚刚确认的计划;如果缺少必须由我决定的信息,就停下来询问。

Spark 会处理所有已就绪任务,直到计划完成、验证失败或需要你的输入。遇到无法安全 代替你做出的实质决策时,可以在当前会话回答,或者打开 /inbox

当前会话会显示实现摘要和验证结果。需要更完整的视图时,启动 Cockpit:

Terminal window
spark cockpit

打开同一个工作区和会话,然后检查:

  • Summary:当前结果和剩余工作,
  • Tasks:计划进度和阻塞,
  • Changes:运行时提供的结构化变更,
  • Artifacts:本次运行实际生成的 Preview、Issue 或 Pull Request。

Changes 或 Artifacts 为空,表示运行时没有发布对应结果;Cockpit 不会从聊天文本中 猜测它们。

  • 只需要一个前台结果时使用 spark run
  • 希望 shell 立即返回时使用 spark bg
  • 需要持久目标、重复工作、证据门控复现或已保存工作流时使用自动推进