HagiCode 使用 Tips

这篇 FAQ 会读取文档站在发布构建时同步下来的 Index tips 快照，并按主题整理成便于浏览的建议清单。

数据更新时间: 2026-06-0153 条 tips数据语言: zh-CN查看 Index 原始 JSON

项目管理

8 条

1. 先创建项目，再开启会话，方便 HagiCode 统一管理文件、上下文和历史记录。

   project-first

2. 一个项目只放相关代码和资料，避免会话读取到无关上下文。

   project-boundary

3. 项目名称尽量使用业务或仓库名，后续查找会更直观。

   project-name-clear

4. 在项目里记录当前目标，后续会话能更快接上。

   project-goal-note

5. 把启动方式、账号信息和常用命令放进项目说明，减少重复解释。

   project-docs

6. 上传资料前先删掉无关文件，能让 HagiCode 更专注当前任务。

   project-context-clean

7. 开新会话前先选对项目，避免把任务放进错误上下文。

   project-before-session

8. 回看项目历史时，优先找最近一次完成的会话结论。

   project-history

提案与范围

8 条

1. 涉及较大改动时，先让 HagiCode 写提案，再决定是否实现。

   proposal-large-change

2. 提案要写清楚范围，避免会话执行时越改越大。

   proposal-scope

3. 不确定方案时，可以让 HagiCode 在提案里列出多个选择。

   proposal-options

4. 提案中的风险说明能帮助你判断是否值得继续推进。

   proposal-risk

5. 把提案拆成任务后，执行进度会更清楚。

   proposal-tasks

6. 实现前先审一遍提案，可以提前发现遗漏或方向错误。

   proposal-review

7. 给提案起一个短而明确的名字，后续查找更方便。

   proposal-change-name

8. 提案完成后记录结果，方便之后复盘为什么这样改。

   proposal-finish

会话协作

9 条

1. 每个会话只处理一个明确目标，结果更容易判断好坏。

   session-single-goal

2. 开始会话时直接说明目标、限制和期望输出。

   session-start-clear

3. 继续旧任务时，先告诉 HagiCode 最近发生了什么变化。

   session-context

4. 长会话中可以要求 HagiCode 阶段性总结当前进展。

   session-checkpoint

5. 暂停前记录下一步，恢复会话时能少花很多时间。

   session-stop-point

6. 会话结束后先看结果摘要，再决定是否继续追问。

   session-review-result

7. 发现方向不对时尽早纠正，不要等会话完成后再整体推翻。

   session-correction

8. 如果你知道相关文件，直接告诉 HagiCode 文件路径。

   session-files

9. 遇到失败时，把完整错误信息发给 HagiCode，比只说失败更有效。

   session-errors

多会话协同

5 条

1. 多会话并行前，先把目标拆成互不冲突的几部分。

   multi-session-plan

2. 并行会话使用清晰名称，比如“提案设计”“前端实现”“问题排查”。

   multi-session-naming

3. 多会话并行时尽量避免同时改同一批文件。

   multi-session-isolation

4. 多会话完成后，先统一看结果，再决定采用哪一部分。

   multi-session-merge

5. 重要任务可以让一个会话实现，另一个会话专门审查。

   multi-session-review

Agent 分工

6 条

1. 给 agent 指定清晰角色，比如实现、审查、测试或文档整理。

   agent-role

2. 多个 agent 协作时，提前划分职责边界。

   agent-boundary

3. agent 交接时保留关键结论、未完成项和注意事项。

   agent-handoff

4. 审查型 agent 更适合找问题，不适合同时承担大范围重写。

   agent-review

5. 调研型 agent 可以先收集背景，再交给实现型 agent 落地。

   agent-research

6. 让 agent 输出短摘要，可以帮助你快速判断下一步。

   agent-summary

Claude 使用

3 条

1. Claude 适合分析长材料、比较方案和梳理复杂背景。

   claude-analysis

2. 做复杂设计前，可以先让 Claude 帮你检查思路是否完整。

   claude-design

3. 阅读大量文档时，Claude 可以帮助提炼重点和约束。

   claude-docs

Codex 使用

3 条

1. Codex 适合直接进入仓库，修改代码并运行命令验证。

   codex-implementation

2. 不知道改哪里时，可以先让 Codex 搜索项目结构。

   codex-navigation

3. Codex 改完后，重点看它改了哪些文件和为什么这样改。

   codex-review-diff

code-server

4 条

1. 需要手动查看代码时，可以用 code-server 打开项目。

   code-server-open

2. 小范围手动调整时，code-server 比本地切换环境更方便。

   code-server-edit

3. 在 code-server 里运行命令前，先确认当前目录是目标项目。

   code-server-terminal

4. 做界面调整时，可以用 code-server 预览实际效果。

   code-server-preview

OmniRoute

4 条

1. OmniRoute 可以统一连接不同模型，让你更方便切换能力。

   omniroute-provider

2. 简单任务可以选更快的模型，复杂任务再切到更强的模型。

   omniroute-model-choice

3. 模型不可用时，OmniRoute 的备用路由可以减少中断。

   omniroute-fallback

4. 使用 OmniRoute 时，可以按任务重要程度平衡速度、质量和成本。

   omniroute-cost

HagiPower

3 条

1. Hagipower 会追踪你在各会话中的能量和活动，让你看到使用量随时间累积的情况。

   hagipower-overview

2. 查看每日 Hagipower 成就，帮助你保持编码目标和连续天数。

   hagipower-daily-achievement

3. 合理分配 Hagipower 消耗，把快速任务和专注深度工作搭配使用，保持能量稳定。

   hagipower-energy-balance