Codex 新手工作台

适用场景 首次接触一个项目，或让 Codex 在修改前理解全貌。

请先不要修改任何文件。读取当前项目结构，告诉我：
1. 这个项目是做什么的；
2. 核心目录和关键文件；
3. 运行、测试、构建命令；
4. 你建议我从哪里开始。

验收方式：Codex 能准确描述项目结构、技术栈、入口文件和构建命令。

适用场景 整理 Markdown、会议记录、视频素材、运营文档等。

请整理这个文件夹里的资料，生成一份结构化 Markdown。要求：
1. 不遗漏任何独特知识点；
2. 重复内容合并；
3. 冲突信息标出来；
4. 保留来源文件名；
5. 输出一份正式稿和一份整理报告。

验收方式：原始文件未被改动，输出文件结构清晰、内容完整、无遗漏。

适用场景 安装开发工具、配置环境、验证版本。

请检查当前电脑是否已具备完成这个项目所需环境。先列出现状和缺失项，再给安装计划。涉及系统级修改、管理员权限、删除文件、修改 shell 配置前必须问我。安装完成后验证版本和最小运行示例。

请检查我是否已安装 Cursor；若未安装，请帮我安装。安装后，把 Codex 桌面端右上角"打开编辑器"的目标设置为 Cursor，并验证是否生效。

验收方式：安装后运行 `xxx --version` 或最小示例，确认可用。

适用场景 让 Codex 修改代码、更新文档、实现新功能。

请实现这个需求：<需求>。
要求：
1. 先阅读相关文件、调用方和测试；
2. 给出简短方案；
3. 只改必要文件；
4. 改完运行相关测试或最小验证；
5. 最后说明改了什么、验证了什么、还有什么没验证。

关键原则

• 先让它列出会影响的文件，再执行
• 要求只改必要文件，不要"顺便优化"
• 改完必须跑测试或最小验证
• 让它说明"还有什么没验证"

验收方式：代码通过测试，或最小验证通过；改动范围与预期一致。

适用场景 对话变长、Codex 开始遗忘前面的约定、任务阶段切换。

请先把当前任务的关键决策、文件路径、未完成事项、验证结果整理成一段 compact summary，然后再压缩上下文。

适用场景 控制额度消耗、在速度和智能之间做选择。

省额度核心方法

• 先让它读目录并给计划，再改
• 先让它列出影响文件，再执行
• 先让它跑最小验证，再做大范围任务
• 图片、视频、大文件处理前先抽样

查看额度：左下角设置里找"剩余额度"，或在对话框输入斜杠命令找"状态"。

适用场景 让 Codex 长期记住你的偏好和项目规则。

三种记忆方式对比

项目级 AGENTS.md 生成方法

请阅读当前项目结构和 README，生成一份项目级 AGENTS.md。内容包括项目目标、目录说明、运行命令、测试命令、代码风格、禁止修改的路径、交付前验证要求。先给草稿，等我确认后再写入文件。

最佳实践

• 明确、稳定、重要的规则，优先写进 AGENTS.md
• 不要只靠自动记忆，它可能记不全
• 共享知识库（纯文本文件夹）比锁在某个线程里更稳

适用场景 从零做网站、重构项目、整理几十份资料、做 PPT、写自动化工作流。

刚才的视觉方向太商务了，请改成更像独立创作者主页，减少营销感。

等当前页面做好后，请启动本地预览，截图检查移动端和桌面端，再修明显布局问题。

适用场景 预览网页、测试按钮、操作外部网站、部署上线。

网页预览 SOP

请启动本地开发服务器，在 Codex 侧边栏打开预览。检查桌面端和手机端布局，发现问题直接修。

一键部署

请使用 Netlify 插件把当前个人主页部署上线。先检查项目构建方式，说明会创建什么站点和预览链接，部署后验证链接能访问。

适用场景 沉淀重复工作流、连接外部工具、定时任务、长期目标追踪。

Skill 创建流程

请把以上流程整理成一个可复用 Skill。要求包括触发场景、输入要求、执行步骤、质量标准、输出格式、失败处理和示例提示词。

MCP 安装流程

1. 给官方链接
2. 让 Codex 阅读 README
3. 让它说明权限和风险
4. 安装
5. 重启或授权
6. 在设置里确认 MCP 服务器状态
7. 做一个最小调用测试

自动化创建要点

• 什么时候运行
• 在哪个项目或文件夹运行
• 使用什么输入源
• 产出什么格式
• 是否允许发布、发消息、改线上内容
• 失败时怎么报告

Goals 标准写法

把这个 Python 工具迁移到 Rust。完成标准：所有现有单元测试通过；CLI 参数兼容旧版本；README 更新迁移说明；性能基准不低于旧版本。每完成一个阶段报告一次，不要删除旧实现，直到我确认。

现象：Codex 给出的项目理解有误，或找不到入口文件、构建命令。

优先检查项

• 项目里是否有 README？是否包含运行/构建命令？
• package.json / pyproject.toml / Cargo.toml 等配置文件是否存在？
• Codex 是否真的读了全部关键文件？

标准处理步骤

请重新读取项目根目录下的 README 和所有配置文件（package.json / pyproject.toml 等），列出：1）项目类型和用途；2）安装依赖的命令；3）启动/构建/测试命令；4）入口文件位置。如果有任何信息缺失，明确告诉我。

现象：你只想改一个功能，Codex 却计划修改十几个文件，甚至重构整个项目。

标准处理步骤

请只修改实现这个需求所必需的文件。先列出你计划改动的文件清单和每个文件的改动原因，等我确认后再执行。不要重构无关代码。

• 明确要求"先列出影响文件，再执行"
• 指定"只改必要文件，不要顺便优化"
• 如果已跑偏，用 Fork 回到之前的好节点

现象：Codex 弹出一个权限申请，你不确定批准是否安全。

标准处理步骤

请解释这个权限申请的具体用途、会影响哪些文件/目录、如果不批准有什么替代方案、执行后如何回滚。

现象：Codex 尝试安装工具但报错，或装完后不可用。

优先检查项

• 网络是否正常？（部分地区需代理）
• 是否已有冲突版本？
• 是否需要管理员权限？
• 安装路径是否在环境变量中？

标准处理步骤

安装失败了。请分析报错信息，判断是网络、权限、版本冲突还是路径问题。给出明确的修复步骤，修复后再次验证安装是否成功。

现象：Codex 开始反复遗漏前面约定，或提示上下文接近上限。

标准处理步骤

请先把当前任务的关键决策、文件路径、未完成事项、验证结果整理成一段 compact summary，然后再压缩上下文。

现象：额度在短时间内大幅下降，或 Codex 反复做无用功。

标准处理步骤

• 先让它读目录并给计划，再改
• 先让它列出影响文件，再执行
• 先让它跑最小验证，再做大范围任务
• 图片、视频、大文件处理前先抽样
• 避免在同一个跑偏的线程里死磕，用 Fork 分支
• 不需要保留的中间过程，及时压缩上下文

现象：侧边栏预览空白、端口冲突、Browser 插件无法打开页面。

优先检查项

• 本地服务器是否真的启动了？
• 端口是否被占用？
• 文件路径是否正确？
• 浏览器插件是否已安装并启用？

网页预览不工作。请检查：1）本地服务器状态；2）端口占用情况；3）文件路径是否正确；4）Browser 插件状态。给出具体原因和修复步骤。

决策口诀：能 Browser 不 Chrome，能 Chrome 不 Computer Use。

核心区别：Skill = 怎么做（流程模板）；MCP = 连什么（外部接口）；自动化 = 什么时候做（定时触发）；Goals = 做到什么程度（完成标准）。

现象：担心自动化任务自动发布内容、发送消息、修改生产环境。

安全模板

请创建一个自动化任务：<频率和时间>，在 <项目/目录> 中执行 <任务>。输出 <格式> 到 <位置>。只生成草稿，不自动发布或发送。失败时在当前线程报告原因和下一步建议。

安全原则

• 自动化只"生成草稿"和"提醒确认"
• 不要一开始就自动发布、自动发送、自动改生产环境
• 明确失败时的报告方式和位置
• 定期检查自动化任务的执行记录

什么时候用 首次接触项目，或需要 Codex 在修改前理解全貌。

替换变量 无。直接复制使用。

输出预期 项目说明、核心目录、关键文件、运行命令、建议起点。

请先不要修改任何文件。读取当前项目结构，告诉我：
1. 这个项目是做什么的；
2. 核心目录和关键文件；
3. 运行、测试、构建命令；
4. 你建议我从哪里开始。

什么时候用 新项目开始、换电脑、环境缺失。

替换变量 把"完成这个项目所需环境"替换为具体工具名。

输出预期 现状清单、缺失项、安装计划、验证结果。

请检查当前电脑是否已具备完成这个项目所需环境。先列出现状和缺失项，再给安装计划。涉及系统级修改、管理员权限、删除文件、修改 shell 配置前必须问我。安装完成后验证版本和最小运行示例。

什么时候用 让 Codex 实现新功能、修复 bug、修改现有代码。

替换变量 把 <需求> 替换为你的具体需求。

输出预期 简短方案、修改文件列表、测试验证结果、未验证项说明。

请实现这个需求：<需求>。
要求：
1. 先阅读相关文件、调用方和测试；
2. 给出简短方案；
3. 只改必要文件；
4. 改完运行相关测试或最小验证；
5. 最后说明改了什么、验证了什么、还有什么没验证。

什么时候用 整理 Markdown、会议记录、学习笔记、调研资料。

替换变量 无。如需指定输出位置，补充说明。

输出预期 结构化 Markdown + 整理报告，原文件不动。

请整理这个文件夹里的资料，生成一份结构化 Markdown。要求：
1. 不遗漏任何独特知识点；
2. 重复内容合并；
3. 冲突信息标出来；
4. 保留来源文件名；
5. 输出一份正式稿和一份整理报告。

什么时候用 从零做一个网页、Landing Page、个人主页。

替换变量 把 <主题> 替换为具体网页主题。

输出预期 计划确认、代码、本地预览、移动端检查。

请从零做一个 <主题> 网页。先用计划模式问我必要问题，再生成实施计划。确认后再写代码。完成后启动本地预览，检查桌面端和移动端，修复明显布局问题。

什么时候用 把跑通的工作流沉淀为可复用 Skill。

替换变量 无。在跑通流程后直接使用。

输出预期 Skill 草稿（场景、输入、步骤、标准、格式、失败处理）。

请把我们刚才跑通的流程沉淀成一个 Skill。包括：适用场景、触发关键词、输入要求、执行步骤、质量标准、输出格式、失败处理和示例提示词。先给草稿，等我确认后再写入技能目录。

什么时候用 定时任务、日报/周报、例行检查。

替换变量 <频率> <项目> <任务> <格式> <位置>

输出预期 自动化配置，只生成草稿不自动发布。

请创建一个自动化任务：<频率和时间>，在 <项目/目录> 中执行 <任务>。输出 <格式> 到 <位置>。只生成草稿，不自动发布或发送。失败时在当前线程报告原因和下一步建议。

什么时候用 新项目初始化、规则沉淀。

替换变量 无。让 Codex 根据项目自动生成。

输出预期 AGENTS.md 草稿，包含项目说明、命令、风格、禁区、验证要求。

请阅读当前项目结构和 README，生成一份项目级 AGENTS.md。内容包括项目目标、目录说明、运行命令、测试命令、代码风格、禁止修改的路径、交付前验证要求。先给草稿，等我确认后再写入文件。

一个有效的任务描述应该包含四个部分：

核心原则：不要只看 Codex 说"完成了"，要看实际产物。

经验法则：如果任务超过 3 个步骤，或失败代价高，就用计划模式。

建议：从自动审查开始。熟悉 Codex 的行为模式后，再根据任务类型调整。

• 给上下文：让 Codex 先读项目、列计划、确认范围
• 给目标：描述清楚要做什么、不做什么
• 授权工具：理解权限申请，知道什么该批什么不该批
• 检查计划：复杂任务用计划模式，中途能干预
• 验收产物：看实际文件/预览/测试，不看"完成"说明
• 沉淀流程：把成功经验写成 AGENTS.md、Skill 或自动化

这就是从"问 AI"到"管 Agent"的关键转变。