Hagicode 产品概述
如果只用一句话介绍 Hagicode：它是一款围绕真实研发流程设计的 AI 编程助手，帮助你理解代码、规划变更、执行任务，并把过程沉淀成团队知识。
本页不再罗列所有模块细节，而是用三个关键词来理解它：智能、便捷、有趣。
Hagicode 是什么？
Section titled “Hagicode 是什么？”Hagicode 不只是“帮你写几行代码”的工具，而是更贴近完整开发过程的工作台：
- 理解代码库：先分析项目结构、关键模块和风险点，再决定是否修改。
- 管理变更过程：把模糊想法整理成可执行的提案、任务和验收标准。
- 支持长期协作：让设计决策、实施记录和历史方案可追溯、可复用。
- 兼容多种 AI 工具：可以按团队习惯接入 Codex、Claude、OpenCode、CodeBuddy 等当前支持的能力。
智能：先理解，再行动
Section titled “智能：先理解，再行动”Hagicode 的“智能”，重点不在炫技，而在于让 AI 更懂项目、也更懂边界。
从想法到代码，先对齐目标、范围和验证方式，再进入实施。
当前系统里，提案会话会把规划生成过程拆成明确阶段，帮助你看清 AI 正在做什么。
1. 提案驱动，而不是直接乱改
Section titled “1. 提案驱动，而不是直接乱改”当需求比较复杂时，Hagicode 会先把想法整理成提案，再进入实施阶段。你能先看到：
- 目标是什么
- 范围在哪里
- 任务如何拆分
- 完成后怎么验证
这让 AI 不是“直接开工”，而是先和你对齐思路，特别适合复杂功能、重构、多人协作场景。
2. 只读 / 编辑双模式
Section titled “2. 只读 / 编辑双模式”很多时候，你只是想先理解代码，而不是立刻修改。Hagicode 将这两类工作拆开：
- 只读模式：适合理解陌生项目、排查问题、梳理架构
- 编辑模式：适合真正落地功能、修复缺陷、执行重构
这样你可以先安全探索，再决定是否交给 AI 动手。
3. 不只生成代码，也理解上下文
Section titled “3. 不只生成代码，也理解上下文”Hagicode 更强调“项目级理解”而不是“片段级补全”：
- 结合仓库结构、约定和已有实现来分析问题
- 支持多轮对话、任务跟踪和工具调用
- 让 AI 更像能持续协作的搭档，而不是一次性的代码生成器
4. 适合沉淀团队知识
Section titled “4. 适合沉淀团队知识”提案、归档和文档化流程能把“为什么这样做”保留下来，减少知识只存在于聊天记录或个人脑海里的情况。
便捷：把常用动作串成顺手流程
Section titled “便捷：把常用动作串成顺手流程”Hagicode 的“便捷”，不是把按钮堆得更多，而是减少上下文切换，让常见动作自然连起来。
先安全理解，再选择是否进入编辑实施，让常见工作流更顺手。
当前系统已经能把会话推进、项目状态和仓库概况放在同一块看板里，减少来回切换。
1. 从理解到修改，可以在同一条链路里完成
Section titled “1. 从理解到修改，可以在同一条链路里完成”一个典型流程通常是：
- 导入项目或创建新项目
- 用只读会话理解代码和需求
- 用提案会话拆解任务
- 切到编辑模式执行改动
- 用 AI 生成更规范的提交信息
相比在多个工具之间来回切换，这种方式更适合连续推进真实开发任务。
2. Monospec 帮你管理多仓库
Section titled “2. Monospec 帮你管理多仓库”如果你的工作不止一个仓库，Monospec 可以把多仓库协作收拢到同一视角下：
- 统一查看和推进多个仓库的工作
- 保持跨仓库的规范一致性
- 让 AI 在更完整的上下文里分析问题
这对多模块项目、微服务架构和长期维护型仓库尤其有帮助。
3. AI Compose Commit 帮你整理提交
Section titled “3. AI Compose Commit 帮你整理提交”改完代码后，最容易被忽略的往往是提交质量。Hagicode 可以基于改动内容生成更清晰的提交信息：
- 更贴近 Conventional Commits 规范
- 更容易让团队成员读懂改了什么
- 更适合后续审查、回滚和版本整理
4. 安装和接入路径也尽量清晰
Section titled “4. 安装和接入路径也尽量清晰”无论你更偏向桌面应用、Docker Compose，还是已有特定 AI CLI 习惯，文档都尽量把接入路径拆清楚，帮助你少走弯路。
有趣：让协作反馈更有存在感
Section titled “有趣：让协作反馈更有存在感”Hagicode 的“有趣”不是单独做一个花哨皮肤，而是把反馈、角色感和推进感放进日常协作里。
把复杂推进过程变成更容易感知、回看和协作的“副本式”体验。
当前系统里已经有 Adventure Squad 的副本编组与角色分配界面，更能说明“有趣”并不是停留在概念层。
1. Hero Dungeon 不是装饰，而是工作流表达
Section titled “1. Hero Dungeon 不是装饰，而是工作流表达”Hero Dungeon 会把提案、AutoTask、Prompt 工作台等内容组织成更有辨识度的“副本流程”：
- 当前在推进哪一项任务，一眼就能看见
- 不同阶段由谁负责，表达得更清楚
- 执行结果和进度反馈更容易回看
2. 成就、战报、日报让过程更可感知
Section titled “2. 成就、战报、日报让过程更可感知”除了完成任务本身，Hagicode 也重视过程反馈：
- 阶段性结果有更清楚的展示方式
- 日常推进更容易形成节奏感
- 长期使用时更容易看到积累和成长
3. “有趣”服务于协作，而不是喧宾夺主
Section titled “3. “有趣”服务于协作，而不是喧宾夺主”这些设计的目标不是分散注意力，而是帮助团队更自然地理解当前状态、角色分工和推进成果，让协作过程更有参与感。
谁适合使用 Hagicode？
Section titled “谁适合使用 Hagicode？”| 角色 | 你能获得什么 |
|---|---|
| 新人工程师 | 更快理解陌生代码库，降低上手焦虑 |
| 开发者 | 在分析、编码、提交之间减少切换成本 |
| 技术负责人 | 用提案和归档管理复杂变更，提升可追溯性 |
| 多仓库团队 | 在统一视角下推进多个仓库的协作 |
继续了解重点能力
Section titled “继续了解重点能力”如果你想进一步了解某个能力模块，建议按“快速上手 → 对应功能指南”的顺序继续阅读，这样会比一次性阅读全部细节更轻松。