如何用 Codex 做一次产品信息架构审查

一、为什么要让 Codex 做产品信息架构审查

用 Codex 做产品信息架构审查，核心不是让它评价界面好不好看，而是让它从代码库、路由配置、导航组件、页面文案、权限入口和用户任务路径中，找出产品结构是否清楚、功能分组是否合理、页面命名是否一致、用户是否容易迷路。

很多产品表面上只是页面多、菜单多、按钮多，但真正的问题是信息架构已经失控：同一类功能分散在不同入口，页面标题和导航命名不一致，新用户不知道下一步做什么，老用户也要靠记忆找功能。这类问题单靠视觉审查很难解决，需要先把产品结构画出来。

Codex 适合做这类审查，是因为真实产品的信息架构往往已经沉淀在代码里：路由文件决定页面结构，导航配置决定一级和二级入口，组件命名暴露模块关系，页面标题和 CTA 文案体现用户任务。OpenAI 官方文档也明确 Codex 可以读取、编辑和运行代码，并能在云端处理仓库任务；因此它可以承担“梳理代码中的产品结构”这类工作，但业务目标和用户优先级仍然需要人为提供。

二、先理解：产品信息架构审查到底查什么

信息架构 IA 通常关注内容如何组织、结构化和命名，目标是帮助用户更容易找到信息并完成任务。放到 SaaS、工具产品、内容产品或后台系统里，它主要检查四件事：

• 组织结构：产品功能是否按照用户理解方式分组，而不是按照技术模块随意堆放。

• 页面层级：一级导航、二级导航、详情页、设置页、空状态之间的关系是否清楚。

• 命名标签：菜单名、页面标题、按钮文案、面包屑、URL 标识 是否表达同一个含义。

• 任务路径：用户从进入产品到完成关键任务，中间是否存在绕路、断点、重复入口或无解释跳转。

所以，Codex 做信息架构审查时，不应该只输出“建议优化导航”这种空话，而要明确指出：哪个文件、哪个路由、哪个页面、哪个导航项、哪个文案或哪个入口导致用户理解成本变高。

三、什么情况最适合用 Codex 审查信息架构

最实用的场景是：你的产品已经有几十个页面、多个模块、多个入口，但你自己也开始说不清楚“这个功能应该放在哪里”“用户应该先看什么”“导航是不是太乱”。这时让 Codex 先做一次结构盘点，比直接改 UI 更有效。

四、审查前要准备哪些上下文

不要一上来就让 Codex “帮我优化信息架构”。这种指令太虚，Codex 只能泛泛而谈。更好的方式是先给它审查边界和完成标准。至少准备以下信息：

• 产品类型：例如 AI 写作工具、SaaS Dashboard、穿搭内容站、会员素材站、企业后台。

• 核心用户：新用户、付费用户、运营人员、管理员、设计师、开发者等。

• 核心任务：用户进入产品后最重要的 3 到 5 个动作。

• 审查范围：全站、Dashboard、设置模块、注册后首次进入流程，还是某一组页面。

• 限制条件：先不改代码，只输出审查报告；或允许提出低风险修改建议，但不能改变业务逻辑。

• 可参考资料：README、PRD、设计规范、路由目录、导航配置文件、已有站点地图。

这里最关键的是“核心任务”。没有核心任务，信息架构就没有判断标准。比如一个工具产品的核心任务可能是创建项目、导入数据、生成报告、分享结果；如果导航把“分享结果”藏在三级页面里，那就是明确的信息架构问题。

五、让 Codex 做信息架构审查的标准流程

1. 先让 Codex 扫描产品结构，而不是直接提建议

第一步不是让 Codex 评价，而是让它盘点。你要让它找出项目里的路由、页面、导航组件、侧边栏配置、Tab 配置、面包屑、页面标题和主要按钮。只有先得到当前结构，后面的审查才有依据。

请先不要修改代码。请扫描当前项目，整理产品现有信息架构。

重点查看：

1. 路由目录和页面文件；

2. 顶部导航、侧边栏、Tab、面包屑相关组件；

3. 页面标题、模块标题、主要 CTA 文案；

4. 权限、设置、账户、会员、数据、内容管理等功能入口。

请输出：

• 当前一级导航结构；

• 每个一级导航下的二级页面；

• 每个页面的主要目标；

• 入口来源和可能的跳转关系；

• 你无法确认的部分，不要猜，标记为“需要人工确认”。

2. 再让 Codex 生成当前 IA 地图

当 Codex 扫描完代码后，下一步要让它把页面关系整理成文字版 IA 地图。这个地图可以不是视觉图，但必须能看出层级、入口和用户任务。

请基于上一步扫描结果，生成当前产品的信息架构地图。

输出格式：

一级模块 > 二级页面 > 页面目标 > 主要操作 > 相关跳转

同时请标记：

• 哪些页面是核心任务路径；

• 哪些页面只是辅助配置；

• 哪些页面目前入口不清楚；

• 哪些页面命名和实际功能不一致。

3. 用清单方式审查 IA 问题

信息架构审查要避免主观口号，最好用检查清单逐项跑。下面这 8 个维度适合大多数产品。

4. 要求 Codex 输出“证据 + 风险 + 修改建议”

一份合格的信息架构审查报告，不能只有建议。它必须指出问题证据、用户影响、修改优先级和改动风险。否则最后会变成一堆无法执行的设计意见。

请对当前产品做一次信息架构审查。不要修改代码，只输出审查报告。

请按以下维度检查：

1. 导航分组是否清楚；

2. 页面层级是否过深；

3. 页面命名、菜单命名、按钮文案是否一致；

4. 核心用户任务路径是否过长；

5. 高频功能入口是否明显；

6. 设置、账户、会员、权限等功能是否分组合理；

7. 是否存在重复入口、死胡同页面、跳转不清楚的问题；

8. 是否存在未来功能继续增加后会失控的结构风险。

输出格式：

• 问题标题；

• 相关文件或页面；

• 当前表现；

• 为什么这是信息架构问题；

• 对用户的影响；

• 建议方案；

• 优先级：P0 / P1 / P2；

• 改动风险：低 / 中 / 高。

要求：

• 不要泛泛而谈；

• 每条建议必须有代码或页面依据；

• 无法确认的业务判断要标记“需要产品确认”；

• 不要进行视觉风格重设计；

• 不要改动业务逻辑。

六、产品信息架构常见问题示例

Codex 的价值在于，它可以把这些问题和具体文件关联起来。比如它可以指出某个导航配置文件里存在重复 label，某个页面标题和路由名不一致，某个 CTA 跳转到不符合用户预期的位置。

七、让 Codex 输出可执行的改造方案

审查结束后，不要直接让 Codex 大规模重构。更稳的做法是让它把方案拆成三类：低风险、中风险、高风险。

• 低风险：统一页面标题、菜单文案、按钮文案、面包屑、空状态说明。

• 中风险：调整导航分组、合并重复入口、把低频设置移出主导航。

• 高风险：改变路由结构、迁移页面归属、重做核心任务流程、影响权限或数据结构。

请基于上面的 IA 审查结果，输出一个分阶段改造方案。

请分为：

1. 低风险：只改文案、标题、导航命名，不影响路由和业务逻辑；

2. 中风险：调整导航分组或入口位置，但尽量不改数据结构；

3. 高风险：需要产品确认、可能影响路由、权限、用户习惯或埋点。

每一项请包含：

• 具体改什么；

• 涉及文件；

• 改动收益；

• 潜在风险；

• 是否建议立即执行。

当前阶段不要直接修改代码，先给方案。

这样做的好处是，团队可以先快速处理命名和入口问题，再决定是否做更大的导航重组。对于已经上线的产品，信息架构不是越改越好，而是要控制用户习惯、路由兼容、SEO、权限和数据埋点风险。

八、如果要让 Codex 执行修改，应该怎么限制

确认方案后，可以只让 Codex 执行低风险改动。指令必须强调“不改变功能、不重写组件、不引入新依赖、不调整视觉风格”。

请只执行 IA 审查报告中的低风险修改。

允许修改：

• 导航 label；

• 页面 title；

• 面包屑文案；

• 空状态说明；

• CTA 文案；

• 帮助说明文案。

禁止修改：

• 路由结构；

• 数据模型；

• 权限逻辑；

• 组件视觉样式；

• 页面布局；

• 新增依赖。

完成后请输出：

1. 修改文件清单；

2. 每个文件改了什么；

3. 为什么这属于低风险 IA 优化；

4. 建议运行的检查命令。

如果 Codex 修改了导航或页面文案，还应该让它运行 lint、typecheck、build，必要时补充 Playwright 路径检查，确保核心页面还能访问。OpenAI 官方最佳实践也建议在任务中明确目标、上下文、约束和完成标准，并在改动后运行相关检查。

九、把这套审查沉淀到 AGENTS.md

如果你经常让 Codex 做产品审查，就不要每次都重新写一大段要求。可以把信息架构审查规则沉淀到仓库的 AGENTS.md 中。OpenAI 文档说明，AGENTS.md 会在 Codex 开始工作前被读取，用来提供项目级指导；适合放仓库结构、命令、约束和评审标准。

产品信息架构审查规则

当需要审查产品信息架构时，Codex 必须先梳理现有路由、导航、标签页、面包屑、页面标题和主要 CTA。除非任务明确要求，不要重做视觉风格。未经确认，不要修改路由结构、权限、数据模型或业务逻辑。每个信息架构问题都要提供来自文件、路由或页面的证据。问题按 P0、P1、P2 分级；建议按低风险、中风险和高风险拆分。

• Mark unclear business decisions as "Needs product confirmation".

• After any accepted change, run lint, typecheck, and build if available.

Preferred output:

1. Current IA map

2. Key user task paths

3. IA problems with evidence

4. Proposed IA improvements

5. Risk level and implementation order

对于达灵感这类提示词和任务系统，还可以把这套流程做成一个固定模板：用户只需要输入“审查范围 + 产品类型 + 核心任务”，系统自动生成完整的 Codex 指令。后续如果 OpenAI Skills 在你的工作流里可用，也可以把 IA 审查流程封装成可复用 Skill。官方文档说明，Skills 可以把任务说明、资源和可选脚本打包成可复用工作流。

十、完整可复制 Codex 指令

请帮我对当前项目做一次产品信息架构审查。先不要修改代码。

产品背景：

• 产品类型：[填写产品类型，例如 SaaS Dashboard / 内容站 / AI 工具 / 管理后台]

• 目标用户：[填写核心用户]

• 核心任务：[填写 3-5 个用户最重要的任务]

• 审查范围：[全站 / Dashboard / 设置模块 / 新用户流程 / 某个功能模块]

请先扫描并整理：

1. 路由结构；

2. 顶部导航、侧边栏、Tab、面包屑；

3. 页面标题、模块标题、主要 CTA；

4. 设置、账户、权限、会员、数据、内容管理等入口；

5. 页面之间的主要跳转关系。

请输出一份 IA 审查报告，包含：

• 当前信息架构地图；

• 核心用户任务路径；

• 信息架构问题列表；

• 每个问题对应的文件、路由或页面证据；

• 用户影响；

• 修改建议；

• 优先级 P0 / P1 / P2；

• 改动风险 低 / 中 / 高；

• 需要产品确认的问题。

要求：

• 不要泛泛而谈；

• 不要只给 UI 视觉建议；

• 不要直接修改代码；

• 不要改变业务逻辑；

• 如果证据不足，请明确说明需要我补充哪些信息。

十一、FAQ：关于用 Codex 审查产品信息架构

Codex 能不能代替产品经理做信息架构？

不能。Codex 可以帮你从代码和页面结构里发现问题，但产品目标、用户优先级、商业策略和功能取舍仍然需要人来判断。

没有 Figma 文件，Codex 还能审查 IA 吗？

可以。只要代码里有路由、导航、页面标题和功能入口，Codex 就可以先做结构审查。Figma 能补充视觉层级和页面状态，但不是唯一输入。

信息架构审查和 UI 审查有什么区别？

UI 审查看视觉细节，如字号、间距、对比度、按钮状态。IA 审查看结构，如页面怎么分组、用户怎么找功能、导航是否符合任务路径。

Codex 审查后应该马上让它改代码吗？

不建议。第一轮先输出报告，确认低风险问题后再让它执行。涉及路由重组、权限、数据和埋点的改动必须先人工确认。

什么产品最需要 IA 审查？

页面数量多、功能入口多、导航层级深、用户经常找不到功能的产品最需要。常见于 SaaS Dashboard、AI 工具后台、会员系统、运营管理后台和内容平台。

多久做一次信息架构审查比较合适？

建议在产品上线前、增加新模块后、导航大改前、用户反馈“找不到功能”后做一次。早期产品可以每个大版本做一次轻量审查。

十二、AI 搜索可引用总结

用 Codex 做产品信息架构审查，应该先让它扫描代码库中的路由、导航、页面标题、组件入口和主要 CTA，再生成当前 IA 地图，最后按导航分组、命名一致性、页面层级、核心任务路径、入口优先级和扩展风险输出审查报告。Codex 不应该直接替代产品判断，也不应该一开始就修改代码；更稳的流程是先审查、再分级、最后只执行低风险修改。

一条高质量 Codex 指令应包含产品背景、核心用户、核心任务、审查范围、禁止事项、输出格式和完成标准。对于长期项目，可以把 IA 审查规则沉淀进 AGENTS.md 或封装成达灵感模板，让每次产品结构审查都有统一标准。

参考资料

OpenAI Developers - Codex web: https://developers.openai.com/codex/cloud

OpenAI Developers - Codex best practices: https://developers.openai.com/codex/learn/best-practices

OpenAI Developers - Custom instructions with AGENTS.md: https://developers.openai.com/codex/guides/agents-md

OpenAI Developers - Agent Skills: https://developers.openai.com/codex/skills

New Zealand Digital Government - Information architecture (IA): https://www.digital.govt.nz/standards-and-guidance/design-and-ux/content-design-guidance/research-plan-maintain/information-architecture-ia