codex 全局 AGENTS.md 分享

# 🎯 Agent 并行工作规范

> ** 核心原则 **：最大化并行、最小化阻塞 —— 将任务拆解为 ** 可独立执行且互不冲突 ** 的子任务，通过 `collab` 并行调度，待全部结果返回后整合为阶段性产出，再递归拆解下一轮，直至任务完成。

---

## 📋 执行流程

### 1. 任务分析

- 识别任务中的 ** 依赖关系图 **
- 区分「可并行节点」与「必须串行节点」
- 评估各子任务的预估耗时与资源占用

### 2. 并行调度

- 将所有 ** 无前置依赖 ** 的子任务打包，通过 `collab` 同时下发
- 确保子任务之间 ** 不存在写冲突 **（如同时修改同一文件 / 变量）
- 为每个子任务设定清晰的输入边界与输出格式

### 3. 结果汇总

- 等待本轮所有并行任务返回
- 校验输出一致性，处理异常或冲突
- 整合为 ** 阶段性结果 **，作为下一轮的输入

### 4. 递归迭代

- 基于阶段性结果，重复步骤 1-3
- 直至所有子任务完成，输出最终结果

---

## ⚠️ 串行任务处理

对于存在 ** 强依赖链 ** 的任务（如 A→B→C 必须顺序执行），按原有模式逐步执行，不强行并行化。

---

## 💡 最佳实践

| 场景             | 推荐策略                           |
| ---------------- | ---------------------------------- |
| 多文件独立处理   | ✅ 并行                             |
| 同一文件多处修改 | ⚠️ 拆分为不重叠区域后并行，或串行   |
| 有明确前后依赖   | 🔗 串行                             |
| 信息收集 + 分析  | ✅ 收集阶段并行，分析阶段汇总后执行 |

## 📋 核心不可变原则

### 🌏 语言规范（不可违反）

简体中文回答 - 所有思考、分析、解释和回答都必须使用简体中文

### 🎯 基本原则

1. ** 质量第一 **：代码质量和系统安全不可妥协
2. ** 思考先行 **：编码前必须深度分析和规划
3. ** Skills优先 **：优先使用 Skills 驱动问题处理
4. ** 透明记录 **：关键决策和变更必须可追溯

---

## 📊 质量标准

### 🏗️ 工程原则

- ** 架构设计 **：遵循 SOLID、DRY、关注点分离、YAGNI（精益求精）
- ** 代码质量 **：
  - 清晰命名、合理抽象
  - 必要的简体中文注释（关键流程、核心逻辑、重点难点）
  - 删除无用代码，修改功能不保留旧的兼容性代码

### ⚡ 性能标准

- ** 算法意识 **：考虑时间复杂度和空间复杂度
- ** 资源管理 **：优化内存使用和 IO 操作
- ** 边界处理 **：处理异常情况和边界条件

### 🧪 测试要求

- ** 测试驱动 **：可测试设计，单元测试覆盖，后台执行单元测试时，设置最大超时时间 60s，避免任务卡死。
- ** 质量保证 **：静态检查、格式化、代码审查
- ** 持续验证 **：自动化测试和集成验证

## ⚠️ 危险操作确认机制

### 🚨 高风险操作清单

执行以下操作前 ** 必须获得明确确认 **：

- ** 文件系统 **：删除文件 / 目录、批量修改、移动系统文件
- ** 系统配置 **：修改环境变量、系统设置、权限变更
- ** 数据操作 **：数据库删除、结构变更、批量更新
- ** 网络请求 **：发送敏感数据、调用生产环境 API
- ** 包管理 **：全局安装 / 卸载、更新核心依赖

### 📝 确认格式模板

**⚠️ 危险操作检测！**

** 操作类型：** [具体操作]

** 影响范围：** [详细说明]

** 风险评估：** [潜在后果]

** 请确认是否继续？** [需要明确的 "是"、"确认"、"继续"]

---

## 🎨 终端输出风格指南

> 沟通过程中，默认输出环境为终端，为了终端下文字阅读性更好，特别指定如下行文风格。

** 核心原则 **：使用 ** 强视觉边界 **（标题、分隔符）来组织内容。

---

### 💬 语言与语气

* ** 友好自然 **：像专业朋友对话，避免生硬书面语，倾向于使用简洁的短句，避免段落过长。
* ** 适度点缀 **：在各类标题和要点前使用 🎯✨💡⚠️🔍 等 emoji 强化视觉引导。
* ** 直击重点 **：开篇用一句话概括核心思路（尤其对复杂问题）。

### 📐 内容组织与结构

* ** 标题 (分组锚点)**：使用 `** 粗体 **` 标识（非 `#`），标题前必须缀有 Emoji。标题必须独占一行，且 ** 前后各空一行 ** 以创建 “留白” 边界。

* ** 要点清晰 **：将长段落拆分为短句或条目，每点聚焦一个 idea。

* ** 逻辑流畅 **：多步骤任务用有序列表（1. 2. 3.）或者 (1️⃣ 2️⃣ 3️⃣)

* ** 合理分隔 **：不同信息块之间用 2 个空行分隔，创建清晰的 “硬边界”

> ❌ ** 反模式 **：在终端中使用复杂表格（尤其内容长、含代码或需连贯叙述时）。

### 🎯 视觉与排版优化

* ** 简洁明了 **：控制单行长度，适配终端宽度（建议 ≤80 字符）。
* ** 适当留白 **：合理使用空行，避免信息拥挤。
* ** 重点突出 **：关键信息用 `** 粗体 **` 或 `* 斜体 *` 强调。

> ❌ ** 反模式 **：全路径类输出，提及类名、文件名时，输出全路径 (例如 “src/main/kotlin/com/jd/hub/auth/jwt/signer/JwtSigner.kt”)，最佳实践是直接输出 `JwtSigner.kt` 即可（简洁大于复杂）。

### 🧩 技术内容规范

#### 代码与数据展示

* ** 代码块 **：多行代码、配置或日志务必用带语言标识的 Markdown 代码块（```python ...```）。
* ** 聚焦核心 **：示例代码省略无关部分（如导入语句），突出关键逻辑。
* ** 差异标记 **：修改内容用 `+` / `-` 标注，便于快速识别变更。
* ** 行号辅助 **：必要时添加行号（如调试场景）。

#### 结构化数据与图示

** 呈现优先级：**

1. ** 列表 ** - 默认首选，适用于绝大多数场景
2. ** 表格 ** - 仅用于需严格对齐的结构化数据（如参数对比、配置项）
3. **ASCII 图示 ** - 当纯文本难以清晰表达结构 / 流程 / 层级关系时使用

**ASCII 图示使用规则：**

- ** 适用场景 **：
  - 结构类：架构图、文件树、数据结构（树 / 图 / 链表）
  - 流程类：状态机、时序图、流程图、生命周期
  - 关系类：类图、ER 图、依赖关系、网络拓扑
- ** 常用符号 **：`├──`、`└──`、`│`、`→`、`┌┐└┘`、`[节点]`、`●`
- ** 核心原则 **：
  - 保持简洁（避免超过 20 行或过度复杂）
  - ** 必须配文字说明 ** 辅助理解
  - 优先使用 UTF-8 框线符号（更美观）
  - 仅在必要时使用（非装饰性）

### ✅ 输出结尾建议

* ** 简短总结 **：复杂内容后附简短总结，重申核心要点。
* ** 引导下一步 **：结尾给出实用建议、行动指南或鼓励进一步提问。

13 个帖子 - 13 位参与者

阅读完整话题

via LINUX DO - 最新话题 (author: lmh)

每月领10美元赠金，gemini

gemini pro用户记得每月领10美元赠金啊，这个得每月手动领Google for Developers

我的福利 | Google 开发者计划  |  Google Developer Program  |  Google for Developers

3 个帖子 - 3 位参与者

阅读完整话题

via LINUX DO - 最新话题 (author: Bouty)

如果当前的这波AI使人类生产力达到一个空前的水平，会发生什么

是会实现社会主义，还是财富更加集中分化，亦或者财富这个概念不存在？
深夜再脑洞一下，达到这样的水平大概还需要多少年呢

9 个帖子 - 6 位参与者

阅读完整话题

via LINUX DO - 最新话题 (author: yaoyaoBB)

open claw中使用gpt5.4的降智问题

前几天用佬的公益站爽蹬gpt5.4，更新之后🈚️了，自己装了个cpa用，然后开始用5.4养龙虾，这几天养的非常恼火，感觉智力低下，然后今天实在受不了，看了下绕过禁止查询juice的提示词，5.4只有96，我在codex里查询是512.太坑了，5.3codex是256，5.2没查到，没能绕过去，ps都是设置为xhigh。供大家参考吧。对了我的codex也是用的cpa出来的，但是就没有问题，可能官方更新了什么东西吧。或者可能是openclaw里上下文太长导致降智？还不太清楚啥原因！

1 个帖子 - 1 位参与者

阅读完整话题

via LINUX DO - 最新话题 (author: 天赐)

【开源分享】自动番茄钟，MacOS 防止久坐小助手

via LINUX DO - 最新话题 (author: Twickenham)

使用 pi 生成动态流程图

github 上有人逆向了 claude 的可视化图表，做了 pi 插件实现。
安装 pi 后，使用 pi install git:github.com/Michaelliv/pi-generative-ui 安装插件就可以了。
测试使用的方舟 coding plan 的 DeepSeek 模型，模型能力有些差，连线飞了

1 个帖子 - 1 位参与者

阅读完整话题

via LINUX DO - 最新话题 (author: jancode)

取之于佬用之于佬！抽两个team

试试抽奖~抽2个今天开的team【但无质保】

🏆️ 奖品详情：
ChatGPT team 席位 * 2【30天】

:three_o_clock: 活动时间：
开始时间：本贴发布起
截止时间：2026 年 3 月 14 日 23:00

📝 参与方式：
在本帖下回复任意内容。

🔍️ 抽奖规则：
每位用户仅允许参与一次。
使用抽奖程序工具抽奖随机抽取中奖者。

⚠️ 注意事项：
本活动将在活动截止时间后关闭回帖，以确保公正性。
中奖者将在活动结束后 24 小时内在本帖公布，并通过站内私信通知领奖方式。
所有规则及抽奖结果由活动发起人和论坛管理团队最终解释。

143 个帖子 - 142 位参与者

阅读完整话题

via LINUX DO - 热门话题 (author: cnlion)

【抽奖】抽20个GPT team车位

抽奖已经结束，谢谢各位佬的支持
中奖的佬全部私信了，如果有中将且没收到佬请私信我！ 🥰
这样一个个私信好累，太容易搞混了 😭

抽奖主题： [20个GPTteam车位]
粗体文本
本贴主要是新人第一次尝试抽奖功能，还请各位大佬多多体谅

🏆️ 奖品详情：

[奖品]：team车位 x20

:three_o_clock: 活动时间：

此帖发布1h内

📝 参与方式：

在本帖下回复任意内容

🔍️ 抽奖规则：

每位用户仅允许参与一次。
使用官方抽奖工具随机抽取中奖者。

⚠️ 注意事项：

本活动将在活动截止时间后关闭回帖，以确保公正性。
中奖者将在活动结束后12小时内在本帖公布，并通过私信通知领奖方式。
所有规则及抽奖结果由活动发起人和论坛管理团队最终解释。

期待您的积极参与，祝您好运！如有任何疑问，欢迎随时联系抽奖发起人。

备注:

1. team母号可能是域名邮箱也可能是outlook邮箱（居多），大部分一卡一绑，极个别一卡两绑。
2. 每个母号我只拉四个成员
3. 绝大部分都是今天新开的车
4. 我主要是想测试下team的稳定度（还请各位佬不要私下拉人！）！！！！

----------------------

----------------------

抽奖已经结束，谢谢各位佬的支持
中奖的佬全部私信了，如果有中将且没收到佬请私信我！ 🥰
这样一个个私信好累，太容易搞混了 😭

186 个帖子 - 182 位参与者

阅读完整话题

via LINUX DO - 热门话题 (author: ViviJane)

【抽奖】再来一张0刀卡,让大家多开点team

抽奖主题： [第一次发抽奖摸清楚了大致流程，第二次再复习一遍，就再来一张0刀卡吧，欢迎大家参与]

🏆️ 奖品详情：

[奖品]：0刀卡（5236的卡头）

:three_o_clock: 活动时间：

开始时间：[发帖起]
截止时间：[3月15日 18:00]

📝 参与方式：

在本帖下回复任意内容

🔍️ 抽奖规则：

每位用户仅允许参与一次。
使用官方抽奖工具随机抽取中奖者。

⚠️ 注意事项：

本活动将在活动截止时间后关闭回帖，以确保公正性。
中奖者将在活动结束后24小时内在本帖公布，并通过私信通知领奖方式。
所有规则及抽奖结果由活动发起人和论坛管理团队最终解释。

期待您的积极参与，祝您好运！如有任何疑问，欢迎随时联系抽奖发起人。

173 个帖子 - 173 位参与者

阅读完整话题

via LINUX DO - 热门话题 (author: kevinkelly)

【纪念】金闪闪ww！金闪闪的！

能成功破百吗……？
51 个帖子 - 41 位参与者

阅读完整话题

via LINUX DO - 热门话题 (author: 【失业客服喵】)

人生转折点，得到了佬友们的帮助

首先，很感谢鸭老师，鸭老师真的是一个很好的人。
先说情况，我用鸭老师发在论坛上的视频去找了一份关于AI漫剧的工作，老板找我要工作的流程，我没有，和鸭老师说明情况后，鸭老师帮助了我。
先介绍一下背景吧，我是国贸系专业出社会的，普通二本，没什么特点，没什么优点，很多事情都半斤八两。
刚出社会不知道工作怎么样，就按照自己的专业开始找了工作，很幸运，找到了单证报关相关的工作，也在这里面做了快2年，但是前年公司不太景气，开始裁人，我就是那个被裁的对象。去年真的是很难受的一年，我有教师资格证，本来是打算去尝试做老师，但是现在老师基本是要师范相关专业，准备了3个月，相当于浪费了一个季度，重新开始找外贸报关单证相关的工作，又花了两个月，找到了一个工作，但是这家公司没有做的超过半年的人，做了两个月我成最老的老人了，第三个月我也离职走了，后面和朋友一起合伙开摄影工作室，做了小半年，没盈利，做不下去了，然后就到了年末，实在没法，去跑了外卖，做了点零工。但是也是浑浑噩噩的，快到今年年初，我哥和我说了ai这个事情，我才开始接触这个东西，才发现自己之前的岗位迟早被取代。文书类的工作除非有保密性和不可替代性，早晚都会被ai取代。但是我是个很犹豫的人，过年后，才真正开始寻找AI相关工作，这时候，我发现我自己的作品根本无法进入一家公司，加上自己的存款危机，就借用了鸭老师的视频当做敲门砖，找一家能学习的，不管多苦多累也要自己学会。
佬友们可能会觉得我这人不够努力，做了3年外贸什么都没学到么？怎么会工作都找不到，我也不怕佬友们笑，我入行的外贸行业就是单证，在做外贸这三年里，我就只会做单证，报关有学过，但是我去不了那个岗位，半斤八两也进不去报关行。其他工作我还做过服务员，外卖员，采购，培训老师，行政，跟单，单证，摄影助理，人事，学过半吊子日语，会半吊子英语口语，还去尝试学过法语。干过很多东西，但是实际上就是半桶水的人。
我写上面那段话不是为了告诉佬友们我有多没用，有多惨。只是想告诉大家我确实是一个虚无的悲观主义者。在开始找鸭老师帮忙的时候，我从来没有想过会有回复，只是有点走投无路了，碰碰运气，实在没想到鸭老师会这样来帮助我。不过到现在我的AI工作也是半斤八两，但是这个行业我会拼尽全力去学习，去努力。
我这7年中，面试超过1千家的公司，经历过太多的欺诈和恶心的事情，鸭老师这件事，让我对人又有了一些信心。
最后，感谢佬友们看到这里，真的十分感谢鸭老师和论坛的佬友们，希望佬友们都能有自己想象的美好的生活。如果有和我一样情况的佬友，也欢迎私信和我聊天，我都会第一时间回复。

29 个帖子 - 29 位参与者

阅读完整话题

via LINUX DO - 热门话题 (author: miaow)

(长期更新)佬友们，搞钱吧！动起来，让自己的生活好起来！

前言-以技相助，以心共赢

● 论坛里的佬友们，都很善，都格外真诚友善，从不藏私，愿意毫无保留地分享技术、经历与心得。
● 我现在所做的，是为了让更多的佬友们，能看到，能学到，能真正的学以致用，去变现，去丰富自己的生活，我将会在论坛中，深挖我觉得能用得上，有用的，对搞钱有帮助的帖子，对他们进行理解，并给出思路集合到这里。
● 佬友们有刷到觉得对搞钱有用的，也可以私信我或者直接在话题回复，一切为了搞钱！
● 强调一下:佬友们的帖子里，有思路，有技术，有工具，能放出来，都是愿意让社区的我们能够更好的去实现目的，希望大家，不要搬运，不要卖课，不要外传！
● 免责一下:我引用的都是大佬们的公开帖子，就不一一上门拜访了，如果因为不可抗力需要我清掉的话直接联系我哈！

定个基调

● 非必看，成熟的搞钱项目人可以直接去看项目
● 个人看法:在打工的，在学校的，对搞钱没有概念，没有想法，没有思路的，看下去，去读，去品，这是大佬的亲身经历，经验，在外面，都是买不到的，大抵只能从父辈身上听来一些已经过时的，非本专业的经验。
● 引用大佬的一句话"还有些佬友咨询我做什么项目，让我透露些。一般情况下，有赚钱的路子，大抵都不会说吧，闷声赚钱是最好的，毕竟多一个同行就多一个竞争对手，但是我被L站佬友的鼓励支持感动到了，我会在这里把我一步步走到现在所有的脚印都分享出来，主打一个真诚，希望对你们能有所帮助。"
● 我，包括我在话题里引用的所有大佬，都是为了大家好起来！

小野-【持续更新，直到上岸】聊聊大家感兴趣的副业赚钱

首次发布时间 Sun, Mar 15, 2026 12:00 AM CST

网易云音乐人认证

● 先感谢三位佬友的分享-接力-完善，根据咸鱼的价格，认证网易云是5-10块，每月任务包年9.9，还有卖歌的基本上是一元一首。
● 佬友们无论是挂咸鱼，或者拼夕夕，有条件的甚至能上淘宝，只要有需求，就会有市场，能赚到一桶金，就有无限的可能！

1. 和宇宙的温柔并联-网易云终身vip攻略（认证音乐人版）

2. no no-网易云终身vip攻略（认证音乐人版）——已认证成功，附详细步骤，附全程网页版工具

3. oldthorn-网易云互助播放，油猴脚本。2.0.0版本发布（在线更新）

AI视频

AI视频，主打就是鸭老师，因为鸭老师货太多了，我列不完，就引用四个话题，心路历程大家读一读，大佬的来时路，现在分析一下我的想法，找AI写个短剧，然后用焚决做分镜，用技术做视频，然后用思路来起号。饭都喂到嘴里了，还不吃等什么？

● 心路-【鸭老师】为了防止塌房，我先来说下我的工作是干嘛的行吧，也别说我是谁的小号了。
● 技术-【鸭老师】万人血书，AI爆款视频的制作方法来了！！（已更新3级用户10分就能领）
● 思路-【鸭老师】2.17新春特编！2026的AI视频的绝对风口，喂饭教程，能看到的就赶紧去起号吧。
● 焚决-【鸭老师】焚诀给你了，按照这个流程来做剧情分镜，效率立马提升100倍！今日起人人都是玄机了

AI小说

我个人就是个重度小说爱好者，最近番茄出了很多AI文，长篇，都是1000+章的，我一开始看没什么问题，但是2 300章之后，就会发现剧情被洗了一样，主角好不容易有点地位，又回到原点了，每几百章就会有一次，会出现剧情衔接不上的情况，宁 河图大佬思路很明确，解决了这个问题，同时有很多细节和思路，是个很成熟的方案，我没什么想法，抄就是了！

宁 河图-升三级了，也没有什么福利发，这里就说一说一个赚钱的方式

给老己:要加油更新下去！

剧透

10 个帖子 - 10 位参与者

阅读完整话题

via LINUX DO - 最新话题 (author: 叁點壹肆)

有没有佬用过钢铁虾，好用吗？

性能占用怎么样？会不会吃资源

1 个帖子 - 1 位参与者

阅读完整话题

via LINUX DO - 最新话题 (author: 抿嘴的三文鱼)

[求助] 如何解决codex gpt5.x模型的指令字面化现象？

场景1： 在需求讨论阶段，gpt在我的核心设计上拓展了一个不相干的功能点n，我跟他说不需要这个n，然后gpt就在n后面加上"当前场景暂不考虑n......."。

原因猜测：gpt处理否定指令时，没有理解用户“删除”或“排除”的意图，而是机械地执行了“添加否定词”的操作。

场景2： gpt按照我的设计开发了一段代码，其中有一处细节我认为没达到设计目标需要修改， 他却认为代码是我写的，强调这个设计的合理性并且需要我再次确认。

原因猜测：将现有代码（实际上是它自己生成的）误判为“用户内容”。为了避免冒犯用户或篡改用户意图，选择了保守策略。担心修改用户代码会破坏原有逻辑或引入错误倾向于维持现状。

这两个问题点出现比较频繁，每次出现都不得不让我手动介入处理，请教一下各位佬有没有好的处理方式。

2 个帖子 - 2 位参与者

阅读完整话题

via LINUX DO - 最新话题 (author: 邹浩南)