CodeGuide

CodeGuide 是什么？

CodeGuide 是面向 AI 编程工具的规格化上下文生成器。它帮助将想法或现有 GitHub 代码库转化为结构化项目文档——如 PRD、技术规格和线框图——供 AI 模型在实现软件时参考。

核心目的是通过创建项目知识库，减少 AI 辅助开发中的“黑箱”问题，提供更清晰的规划和文档上下文，无论是从描述开始还是扩展遗留仓库。

主要功能

• 规格驱动文档生成（纯英文输入）：用纯英文描述项目，即可生成文档套件，包括 PRD、技术栈指导和线框图。
• 现有 GitHub 代码库文档化：输入现有 GitHub 项目，映射代码库，让 AI 工具更清楚仓库内容。
• AI 文档工作流（澄清问题 → 计划 → 文档）：提供项目简述并回答开放问题（如通知行为、入职流程、功能约束），塑造最终文档。
• Software v2 自主编码代理：使用能分析代码库、规划文档并“自主”执行编码任务的代理，支持长时间会话。
• 多 CLI 工具/模型路由统一界面：单一界面操作多个 AI 模型协同工作；模型路由器为工作流不同部分选择模型。
• 浏览器生成 Chrome 扩展：直接在浏览器中生成 PRD、技术规格和文档。
• 屏幕 UI 编辑器：屏幕上编辑，协调多个代理并行处理 UI 修复或功能添加。
• 入门套件减少设置工作：开源样板针对 AI 编程模型，包括常见基础设施，如认证、数据库配置和 Stripe 支付配置（按模板描述）。

如何使用 CodeGuide

1. 从想法或仓库开始：用纯英文描述要构建的内容，或指向现有 GitHub 项目。
2. 回答提示的项目问题：利用澄清问题指定产品行为和约束。
3. 生成文档套件：产出实现所需的输出，如 PRD、技术规格、线框图及相关规划工件。
4. 使用 Software v2 执行：进入编码实现时，运行自主代理分析代码库并遵循规划文档。
5. 可选使用 Chrome 扩展：在浏览器工作流中生成 PRD/技术规格/文档。

使用场景

• 将 App 想法转为实现就绪规格：开发者描述 App 概念（如移动 App 与网站），回答产品行为问题，即得 PRD、技术规格和线框图。
• 为 AI 开发文档化遗留 GitHub 仓库：处理难解旧代码时，输入仓库获取映射后的 AI 可消费上下文，用于后续编码任务。
• 在使用 AI 编程助手前规划产品需求：用生成规格作为结构化输入，让 AI 工具基于明确需求实现功能，而非临时提示。
• 使用代理运行自主编码：用 Software v2 协调代码库分析、规划和编码执行，支持长时间会话统一界面。
• 迭代改进或扩展 UI：用屏幕编辑器修正 UI 问题或添加功能，同时多个代理并行工作。

常见问题

CodeGuide 能否从描述、仓库或两者生成文档？

CodeGuide 支持两者：它能从纯英文想法生成文档，也能通过映射仓库为现有 GitHub 代码库生成文档，提供 AI 上下文。

CodeGuide 能生成哪些类型的文档？

网站描述 PRD、技术规格和线框为关键输出，同时提供与项目简报绑定的更广泛“文档套件”。

什么是 Software v2？

Software v2 被描述为自主编码代理，能分析代码库、规划文档并执行代码，具有统一界面和多模型同步。

该产品如何帮助缓解 AI 幻觉？

网站将该方法框定为创建项目知识库和结构化规格/上下文，供 AI 模型引用，旨在减少因缺失或不清晰上下文导致的“猜测”。

是否有工具可在主应用外使用 CodeGuide？

有。网站提到 Chrome 扩展，可直接从浏览器生成 PRD、技术规格和文档。

替代方案

• 手动编写 PRD/技术规格 + AI 编码助手：自行（或用通用 AI 聊天）编写文档，再提供给编码工具；区别在于依赖用户编写的规格，而非仓库映射和结构化生成流程。
• 通用 AI 编码副驾驶：专注代码生成和重构的工具，可能无法提供此处描述的端到端文档套件（PRD/技术规格/线框）或仓库映射。
• 文档优先的代码库分析工具：以源代码生成文档为中心的方法（无规格/PRD 流程）有助于理解，但可能无法生成与产品需求绑定的相同规划产物。
• 启动模板/样板 + 独立规划：使用样板可减少设置时间，但仍需其他流程为 AI 编码工作流生成 PRD/技术规格和线框。