动手前准备什么
用练习仓库或你熟悉的小项目。先确认 git status 干净，或你知道怎么回退。
在项目目录启动 grok。若还在登录或 PATH 上打转，先回安装章或排错章。
想好一条禁区：不提交、不推送、不改密钥文件。
- 选定练习仓库并进入该目录。
- 确认能回退。
- 写下这轮不准做的事。
先用计划模式把门闩插上
TUI 里可以用 /plan 进入计划模式。公开说明是：在你批准之前，文件编辑被挡住，只允许改计划文件本身。
这道门闩和权限模式（询问、自动、始终批准）是分开的。不要以为开了自动批准就能在计划模式里偷改代码。
Shift+Tab 也可能在模式间循环，以你本机快捷键为准。重新查看计划用客户端提供的查看命令。
第一份计划要短：改哪些文件、怎么验证、什么不做。计划比口号有用。
- 用 /plan 写清范围。
- 批准前不要期待工作区已改。
- 验证步骤写成你本机真能跑的命令。
第一句提示怎么写
好提示点名目录、验收命令和禁区。坏提示是“顺便把仓库整理一下”。
公开文档给过只读开头，例如解释这个仓库、或点名一个源文件讲一遍。先只读，再批准写入。
需要引用文件时，按客户端支持的方式点名路径，而不是粘贴整份仓库。
- 写清目录和验收命令。
- 写清不要动的路径。
- 先解释，再改。
TUI 里还要会哪几个命令
除了 /plan，你很快会用到 /model 换模型、以及技能相关命令。/skillify 属于后面技能章，第一天可以先不碰。
会话管理、上下文占用和帮助命令以本机 /help 为准。不要背下整张命令表再开始做事。
- /plan 写计划。
- /model 只在你明确要换模型时用。
- /help 查本机真实命令。
怎么看 diff 和回退
批准计划后，仍然逐文件看。Agent 自信不等于测试过。
用你平时的 git diff。不要只读 TUI 摘要。
不满意就回退工作区，不要让 Agent 在脏树上叠下一次“再试一次”。
- 先看计划，再看 diff。
- 跑你指定的验收命令。
- 失败就回退，再收窄提示。
同一件事能不能无头做
可以。把同一句提示交给 grok -p。第一周更建议在 TUI 里看计划。
脚本里加上工作目录和失败退出。streaming-json 留给以后解析。
- 无头适合已经稳定的只读任务。
- 不要第一天就把写权限丢进 CI。
失败时怎么收
模型跑偏通常是范围太大，不是你没写“请仔细”。收窄文件列表。
计划写了不存在的测试命令，会带飞一整轮。先在本机跑一遍验收命令。
登录中途掉了，去排错章，不要换仓库碰运气。
- 收窄路径。
- 先跑验收命令。
- 不要在脏树上连试三次。
第一个任务最常见的错
跳过计划模式、直接让它“修完所有警告”。
把生产密钥或 .env 当作示例文件交给 Agent。
- 第一轮就要求提交。
- 计划里没有验收命令。
- 在主仓库练习强制推送。
这一轮怎样算完成
完成意味着你看过计划、看过 diff、跑过验收，并知道怎么回退。
- 用计划模式开过一轮。
- 工作区改动可解释。
- 验收命令跑过。
- 没有提交密钥。
- 准备写下一条 AGENTS.md 禁区。
下一步：把习惯写进配置
配置章会读 config.toml、跑 grok inspect，并写短说明书。
若计划门闩行为和文档不一致，以本机和官方说明为准。