Coding
在代码项目里读取、修改、验证并准备交付，适合代码审查和实现任务。
Coding 能力面向真实代码项目。它和普通对话最大的区别是：Raydo 不只回复建议，而是围绕代码项目的读取、差异、验证和交付边界来工作。
功能状态：预览
代码项目路径已经可用，但具体可写能力、CLI 适配器、本地 Agent 来源和验证链仍在持续完善。关键仓库请先在可回滚分支或测试项目中验证。
入口
通常从代码项目上下文进入，或在已经绑定代码项目的 Chat 中直接提出实现、诊断或评审请求。
适合的任务
- 阅读代码并解释某个模块；
- 修改一个明确的文件或功能；
- 生成 reviewable diff；
- 跑 typecheck、test、build 等验证；
- 准备代码交付说明。
基本流程
确保当前 Chat 绑定的是正确的代码项目，而不是默认项目。
写清楚目标文件、目标行为、限制条件和验证方式。
让 Raydo 先检查必要文件，再生成可审阅差异。
在允许写入后应用修改，并运行 typecheck、test 或 build。
检查差异、验证结果和交付说明，再决定是否继续。
使用建议
- 明确给文件路径时，不要同时要求“先通读整个项目”；
- 先让 Raydo做最小可验证修改，再逐步扩展；
- 把成功标准写成可检查项，例如“测试通过”“build 通过”“只改这两个文件”；
- 重要仓库先在受控分支或副本上做。
成功标志
- 读取范围和改动范围符合预期；
- 差异可审阅，不是黑盒修改；
- 验证结果明确，知道是
typecheck、test还是build通过； - 结果仍然绑定在当前代码项目上下文中。
更好的使用方法
- 先写“改什么”，再写“为什么改”，最后写“怎么验收”；
- 能指定文件就指定文件，能指定命令就指定命令，不要让任务边界漂移；
- 先做最小差异，再决定是否扩展到更多目录；
- 对风险高的仓库，明确写出“不允许修改的目录”和“必须保留的行为”；
- 诊断类请求和实现类请求分开写，避免一轮里又查原因又大改代码。
常见报错会出现在哪
| 位置 | 你会看到什么 | 代表什么 |
|---|---|---|
| 代码项目入口 | 项目错位、路径无效、未绑定 workspace | 当前 Chat 没有落在正确代码项目里 |
| 命令执行阶段 | command policy required / denied、approval denied | 当前动作缺少允许的执行边界或确认 |
| 工作区校验阶段 | outside workspace、workspace mismatch | 目标文件或命令超出了已绑定项目范围 |
| 运行 / 验证阶段 | command failed、command timeout、manifest missing | 命令本身失败，或当前项目缺少必要运行前提 |
常见报错与含义
| 常见提示或错误方向 | 用户应如何理解 | 建议先做什么 |
|---|---|---|
| run workspace binding required | 当前代码任务要求先绑定项目工作区 | 先确认当前 Chat 已绑定正确项目 |
| run workspace binding mismatch / project mismatch | 你要操作的项目和当前绑定项目不是同一个 | 停止继续修改，切换到正确项目后重试 |
| outside workspace | 目标文件、路径或输出位置超出了允许范围 | 改用项目内相对路径，不要跨项目写入 |
| command policy required / denied | 当前动作需要允许的执行策略，或被策略拦住 | 先检查当前命令是否属于允许范围 |
| command failed | 命令已经执行，但结果失败 | 先看具体失败命令和输出，不要立刻扩大修改范围 |
| command timeout | 命令跑太久，当前轮次没等到结果 | 改成更小的验证命令，或拆步骤执行 |
| cargo / python / go manifest missing | 当前项目缺少该语言运行所需清单文件 | 先确认项目技术栈，再跑对应语言命令 |
建议用户怎么排查
先确认当前 Chat 绑定的是正确项目，而不是相似目录或默认项目。
如果报 workspace 或 path 错误，先缩回到项目内相对路径。
如果报 policy 或 approval 错误，先确认当前动作是不是被允许执行。
如果命令失败，先看失败的是 typecheck、test 还是 build，不要一次改太多文件。
把“诊断问题”和“实施修复”拆成两轮，会比混在一起更稳。
截图占位
后续建议补 3 张图：代码项目绑定状态、差异预览界面、验证结果区域。
录屏占位
后续建议补 1 段短录屏：从绑定代码项目，到提出修改请求，再到查看 diff 和验证结果。