# codex-workflows

**Repository Path**: sometao/codex-workflows

## Basic Information

- **Project Name**: codex-workflows
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-17
- **Last Updated**: 2026-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# ChatGPT Workflows

**面向 ChatGPT 网页版，以及 ChatGPT 桌面端中 Codex 工作场景的使用技巧、工作流、故障排查和本地工具。**

把自然语言目标、执行证据和接续断点连接起来；同时收录 ChatGPT 网页增强与本地工具。

**简体中文** | [English](README.en.md)

[![Repository quality](https://github.com/RongNianXin/ChatGPT-Workflows/actions/workflows/repository-quality.yml/badge.svg)](https://github.com/RongNianXin/ChatGPT-Workflows/actions/workflows/repository-quality.yml)
[![Last commit](https://img.shields.io/github/last-commit/RongNianXin/ChatGPT-Workflows?label=last%20commit)](https://github.com/RongNianXin/ChatGPT-Workflows/commits/main)
![License: MIT](https://img.shields.io/badge/license-MIT-2F855A.svg)
![Platform: Windows](https://img.shields.io/badge/platform-Windows-0078D4.svg?logo=windows11&logoColor=white)

<br />

<img src="assets/repository-cover.png" alt="ChatGPT Workflows 仓库封面" width="100%" />

</div>

<p align="center">
  <strong><a href="SHOWCASE.md">查看真实运行效果 / View real-world previews</a></strong>
</p>

<p align="center">
  <a href="#先选入口">先选入口</a> ·
  <a href="#总指挥工作流的特色">工作流特色</a> ·
  <a href="#快速开始">快速开始</a> ·
  <a href="#仓库里有什么">仓库内容</a> ·
  <a href="#chatgpt-与-codex-的命名边界">名称边界</a> ·
  <a href="#总指挥工作流怎么读">工作流说明</a> ·
  <a href="#隐私与公开边界">公开边界</a>
</p>

> [!NOTE]
> 这是社区实验项目，与 OpenAI 不存在官方隶属或背书关系。

> [!TIP]
> **维护状态：持续维护。** 新的工作流、故障记录和本地工具会在完成验证后纳入仓库；实际变化以 [CHANGELOG](CHANGELOG.md) 和提交历史为准。

## 本次更新：评估算法、界面与恢复能力持续演进

- **会话交接评估工具持续升级：**从任务查询与保存，扩展到 Windows 工作台、历史结果与报告、交接评分、分级提醒和旧数据兼容；算法与页面视觉样式均经历了调整。
- **恢复与故障解除能力增加：**新增归档路径修复工具，并把跨窗口交接、自动化结果关联、会话过长和客户端异常沉淀为可检索的排查资料。
- **工作流交付方式更完整：**补充离线 Markdown 阅读、脱敏真实运行展示图、中文规范源和英文入口，让规则、工具和展示材料可以分别维护。
- **证据边界继续收紧：**交接核对区分 Git 基线、未提交增量、依赖与构建、运行身份及输入验收；规则同时明确哪些内容只是研发记录，哪些已实际验证。

以上是对历史提交、变更日志和当前文件的简略归纳；具体状态、未验证限制和后续候选计划见 [变更日志](CHANGELOG.md)。

## 此前改进：精简有依据，交付可复现

先核实当前成果，再决定怎么精简、怎么验证、怎么交给别人。这次重点完善了四项能力：

| 改进 | 对使用者意味着什么 |
| --- | --- |
| [代码精简：场景 2B（旧 2G）](总指挥工作流/第二代总指挥的工作模式/01-操作者操作手册.md#场景-2b保持功能不变精简现有代码) | 先证明代码可以安全删除或合并，再比较实际收益与不退化条件。不能只减少行数，也不能用总评分提高掩盖关键样本变差；没有足够收益可以不改。 |
| [PR 表达与交付](总指挥工作流/第二代总指挥的工作模式/docs/PR_SUBMISSION_AND_REVIEW_STANDARD.md) | 说明为什么改、具体改了哪里，以及用什么输入、步骤和预期结果验证。基础测试命令仍有价值，但不能代替本次改动的验证证据。 |
| [跨机器复现与性能定位](总指挥工作流/第二代总指挥的工作模式/docs/PIPELINE_DIAGNOSIS_AND_ALGORITHM_TUNING_STANDARD.md#跨机器效果与速度差异对照) | 核对实际代码、配置、模型、输入和资源获取方式；区分效果差异与耗时差异。合并后继续核验实际交付结果，不能只说“我这里能运行”。 |
| [自然语言入口](总指挥工作流/第二代总指挥的工作模式/01-操作者操作手册.md#统一入口描述目标由-ai-核对场景) | 登记规则目录后，可以直接说明目的，不必记编号或固定句式。AI 按目标、现状和权限选择流程；发布意图会加载交付标准，无需 PR 时不强制创建。 |

场景 2 是普通目标入口；2B 负责行为不变的代码精简，场景五负责执行与独立审查协作。旧编号链接仍保留为兼容定位，不产生新的授权。以上规则不保证任意机器同速或所有 AI 都正确执行，实际效果仍需验证，团队规则与授权边界继续优先。参见 [更新记录](CHANGELOG.md)。

## 总指挥工作流的特色

围绕“提出目标 → 实现与验证 → 保存断点 → 接续交付”组织协作。你说明目标和必要决定，AI 自动读取事实、准备参数和核对结果；操作可以简短，验证标准仍然明确。

| 你能直接使用的能力 | 工作流如何落实 |
| --- | --- |
| 少做重复操作 | [单一操作入口](总指挥工作流/第二代总指挥的工作模式/01-操作者操作手册.md)，参数由 AI 读取或预填；必要人工步骤附预期结果与异常反馈方式。 |
| 看得懂、查得到的结果 | [按实际链路排查](SHOWCASE.md)，区分观察、推断和未验证项；生成结果、自动测试与专业验收分别说明。 |
| 换任务后有明确接续点 | [统一四段交接汇报](总指挥工作流/第二代总指挥的工作模式/总指挥轻量交接启动配置.md#7-统一接管汇报模板)：身份、交接结论、断点、下一步与授权；单写者核对通过后才切换。 |
| 规则能更新，也能精简 | [按需核验与退役](总指挥工作流/第二代总指挥的工作模式/06-复盘与优化规则.md#按需时效核验与退役)，由使用、升级信号和相关维护触发；有证据才更新或淘汰，不创建周期扫描。 |

具体型号、价格和档位不会成为永久前提。[模型策略](总指挥工作流/第二代总指挥的工作模式/05-模型选择与资源策略.md)默认沿用已选且适用的配置，仅在有实际收益时评估调整。以上是可审阅的工作流规则，不是效果或跨模型一致性保证；未被使用或触发核验的说明仍可能过时。

## 先选入口

| 你现在想做什么 | 从这里开始 |
| --- | --- |
| 增强 ChatGPT 网页版的使用体验 | [ChatGPT-Web](ChatGPT-Web/README.md) |
| 第一次使用总指挥工作流 | [01-操作者操作手册.md](总指挥工作流/第二代总指挥的工作模式/01-操作者操作手册.md) |
| 先了解整体设计和规则关系 | [00-第二代工作流总览.md](总指挥工作流/第二代总指挥的工作模式/00-第二代工作流总览.md) |
| 排查 Codex 或 CC Switch 故障 | [故障排查与解决经验](故障排查与解决经验/) |
| 找一段可以直接使用或修改的提示词 | [其他 Codex 技巧性提示词](其他%20Codex%20技巧性提示词/) |
| 使用本地辅助工具 | [实用小工具](实用小工具/) |
| 保存常用任务，一键查询 Codex 会话状态（Windows dev.9） | [Codex 会话交接评估](实用小工具/Codex会话交接评估/README.md) |
| 查看真实运行效果 | [效果预览](SHOWCASE.md) |

目前的公开内容可以归为五类：ChatGPT 网页增强、Codex 总指挥工作流、可复用提示词、故障排查与恢复、本地辅助工具。所有内容应当可以下载、审查和复用，不包含本机身份、真实任务 ID、凭据或私人提示词。

## 快速开始

### 使用 ChatGPT 网页脚本

1. 打开 [ChatGPT-Web](ChatGPT-Web/README.md)，根据说明安装篡改猴（Tampermonkey）。
2. 按浏览器要求开启“允许运行用户脚本”。
3. 选择需要的脚本安装，刷新 ChatGPT 网页后验证效果。

### 使用 Codex 总指挥工作流

1. 点击 GitHub 页面右上方的 `Code → Download ZIP`，下载并解压本仓库。
2. 打开 [01-操作者操作手册.md](总指挥工作流/第二代总指挥的工作模式/01-操作者操作手册.md)；日常使用主要看这一份。
   建议用仓库自带的 Markdown 阅读器打开：左侧栏目录可以展开“场景一”到“场景六”，点击子场景即可快速定位，不需要在长页面中滚动查找。
3. 在真正要处理的项目中新建 Codex 任务，把下面这段话中的路径换成你解压后的规则目录，然后发送：

   ```text
   请把 <第二代总指挥规则目录> 作为本项目的总指挥工作流规则目录。先阅读 01-操作者操作手册.md，再根据我的目标按需读取其他规则并开始工作。
   ```

> [!IMPORTANT]
> 请在真正要处理的项目中打开 Codex，再登记这套规则目录。只有维护工作流本身时，才把本仓库作为目标项目。

### 面向英语用户的轻量入口

详细规则仍以中文文档为唯一规范源；面向英语用户的稳定导读、术语和最小使用路径见 [English entry](总指挥工作流/第二代总指挥的工作模式/docs/ENGLISH_ENTRY.md)。它不是完整英文镜像，规则发生变化时应回到中文源文件核对。

## 仓库里有什么

| 目录 | 内容 |
| --- | --- |
| [ChatGPT-Web](ChatGPT-Web/README.md) | 适用于 ChatGPT 网页版的可审阅用户脚本、安装说明和浏览器权限提示。 |
| [第二代总指挥的工作模式](总指挥工作流/第二代总指挥的工作模式/) | 单窗口主执行总指挥、Goal、例外专项任务、状态交接、授权门禁、模型策略和复盘规则。 |
| [故障排查与解决经验](故障排查与解决经验/) | 已复现并完成脱敏的 Codex / CC Switch 故障现象、原因、恢复步骤和辅助脚本。 |
| [其他 Codex 技巧性提示词](其他%20Codex%20技巧性提示词/) | 第一性原理、复杂任务、图片编辑、自动化测试和文字版流程图等可复用提示词。 |
| [实用小工具](实用小工具/) | Codex 会话交接评估等只读或可回滚的本地辅助工具。 |
| [效果预览](SHOWCASE.md) | 经隐私核验的真实运行截图，帮助访客直观看懂工具和工作流的效果。 |

根目录文件的职责：

- `AGENTS.md`：约束 AI 的访问、修改、验证和远端写入行为。
- `.gitignore`：阻止私人资料、生成报告、缓存和本地过程文件进入 Git。
- `CHANGELOG.md`：记录公开版本的重要变化。
- `LICENSE`：MIT 许可证。

`全局提示词（严禁AI自动修改）`、`其他资料`和文件名含“自用”的 DOCX 只保存在本地，不会同步到公开仓库。

## ChatGPT 与 Codex 的命名边界

仓库使用 **ChatGPT Workflows** 作为对外总标题，方便读者从 ChatGPT 的使用场景进入；**Codex** 仍用于准确指代编程、本地项目协作、CLI、会话格式以及只适用于 Codex 的工作流和工具。

因此，不会为了统一品牌而批量改写目录名、脚本名、命令或技术文档中的 `Codex`。标题中的 ChatGPT 也不表示每个模块都能在普通网页聊天中运行；具体适用对象、前置条件和限制仍以各模块 README 为准。

## README 双语约定

公开子目录只要提供 `README.md`，就同时提供 `README.en.md`，并在顶部互相链接。中文页是内容源；英文页保存中文源内容的 SHA-256 同步标记。仓库质量脚本会递归检查文件是否成对、切换链接是否存在、中文更新后英文页是否已经重新确认。

这个门禁能防止漏建英文页和旧译文悄悄滞后，但不能自动证明翻译语义正确。每次提交前仍须对照检查目标、步骤、命令、权限、安全边界和限制；存在歧义时保留原术语并标为待确认。

## 总指挥工作流怎么读

日常使用只需要先看 [01-操作者操作手册.md](总指挥工作流/第二代总指挥的工作模式/01-操作者操作手册.md)：

1. 按手册登记本地规则目录。
2. 直接用自然语言说明目标，或按场景复制标准提示词；AI 核实可读取的信息，只询问必要缺口。
3. 其余 `00`、`02`～`11` 交给 AI 按规则注册表核对和读取。

[00-第二代工作流总览.md](总指挥工作流/第二代总指挥的工作模式/00-第二代工作流总览.md) 是架构地图和规则注册表；需要理解整体设计、阅读顺序或排查规则冲突时再查看。正常交接可使用 [总指挥轻量交接启动配置.md](总指挥工作流/第二代总指挥的工作模式/总指挥轻量交接启动配置.md)。

“第二代”是当前公开规则系列的版本名称，不要求读者先了解某套“第一代”。新用户直接使用当前规则；[08-旧版兼容与迁移规范.md](总指挥工作流/第二代总指挥的工作模式/08-旧版兼容与迁移规范.md) 仅供已经运行其他旧版或自建总指挥流程的项目迁移时使用，日常无需读取。

## 可选的本地操作者协作画像

协作画像让 AI 记住经过验证的技术偏好、理解程度、有效协作方式和常见操作疏忽，从而少做重复解释，并在容易出错的步骤提前提醒。它不是身份档案，也不能替代项目事实、测试或授权。

它默认关闭。第一次建立总指挥时，AI 会在完成主回复后介绍一次；只有明确同意才会启用，拒绝或不回答都不会收集，也不会在同一项目后续交接中反复询问。启用后，只在重大 Goal/里程碑形成稳定截点、总指挥准备交接、同类协作问题再次出现，或你主动要求时做一次本地检查；没有合格新证据就不写，过期、重复和被新证据推翻的内容优先清理，不使用定时任务或后台监控。

可直接用自然语言控制：

- 开启：`开启本地操作者协作画像`
- 暂停或恢复：`暂停本地操作者协作画像` / `继续本地操作者协作画像`
- 关闭：`关闭本地操作者协作画像`
- 关闭并删除本地数据：`关闭并删除本地操作者协作画像`
- 只看安全状态：`查看本地操作者协作画像状态`

隐私边界有可核对的证据：真实画像只放在 `.gitignore` 精确排除的本地文件中，启用和每次写入前后都会核验忽略规则实际命中且文件未被 Git 跟踪；不记录身份、联系方式、真实项目、本地路径、聊天原文、敏感属性或人格评价；索引和交接只传状态与通用指针，不传正文或内容哈希；最多保留 20 条活动记录并设置过期复核；任何派生公开副本都要先展示最终脱敏载荷，再由操作者在下一条独立消息第二次精确确认。`.gitignore` 不是加密或操作系统权限，因此高度敏感资料仍不应放入画像。完整规则见 [11-操作者协作画像规范.md](总指挥工作流/第二代总指挥的工作模式/11-操作者协作画像规范.md)。删除公开的 11 号规范不是关闭开关，也不会删除本地数据。

## 隐私与公开边界

- `.gitignore` 负责阻止 Git 跟踪本地私人文件；它不是访问权限系统。
- `AGENTS.md` 进一步要求 AI 未经明确授权不得读取、修改或上传私人目录和自用文件。
- 仓库所有者明确授权的公开署名或品牌素材可以用于 README 等公开展示；该授权不覆盖本地路径、任务记录、凭据或第三方个人信息。
- 高度敏感资料仍建议放在仓库和 Codex 工作区之外。
- 提交前应核对 `git status`、`git diff --cached`，并执行敏感信息扫描。

## 适用范围

- ChatGPT 网页版的用户脚本与使用说明。
- Codex 桌面端和本地项目的工作流、交接、验证与故障恢复。
- 当前工具和实测环境以 Windows 为主，详细规则文档目前以中文为主。
- 故障记录中的软件版本和第三方工具行为具有时间性，使用前应重新核对当前版本。

## 许可证

本项目采用 [MIT License](LICENSE)。

## 社区交流

本项目认可 [LINUX DO](https://linux.do/) 社区，支持真诚、友善的知识分享与交流。