Quick Start

快速开始

安装完成后，在 AI Agent 中用自然语言启动：

用 workflow-start 开始

workflow-start 会读取当前 change 目录的内容，判断你所在阶段并路由到下一项工作。它不依赖文件时间戳；会比较 proposal 的范围与 execution contract 的 intent lock，以识别陈旧或漂移的工件。

新建变更

1. 在项目中创建或选择一个变更目录，例如 changes/add-dark-mode/。
2. 告诉 Agent：用 workflow-start 开始。
3. 按引导澄清意图与约束；选择 full、hotfix 或 tweak 路径。
4. 对 full 路径，完成 proposal、specs、design 和 tasks，再生成并批准执行契约。
5. 选择、确认执行模式后才开始构建。

恢复已有工作

继续上次的工作流

也可以使用 CLI 查看恢复信息：

ssf resume changes/add-dark-mode
ssf checkpoint list changes/add-dark-mode

resume 与 switch 都是只读的：它们不会改动工作目录、TUI 会话或隐藏状态。

验证一个 change

ssf validate changes/add-dark-mode
ssf state show changes/add-dark-mode

完整、可参考的变更在仓库的 docs/examples 中。