个人使用的全局AGENTS.md分享

我的环境：主要使用GPT和GLM系列模型，在Windows通过Codex、OpenCode和CodeBuddy CLI编码
说明内容注释在文档内
仅供参考，请根据实际情况调整

# AGENTS 文档

## 原则优先级

安全性 = 正确性 > 最小变更 > 可读性 > 一致性

## 语言与沟通

- 除非有要求，生成的代码注释和文档都应使用中文
- 较为复杂的函数、实现等需要在其中添加注释，对于其它代码也应**适当**添加注释
- 保持审慎，从原始需求和问题出发
- 不要重复提问项目上下文、现有代码已经能回答的问题  // 安装了superpowers等强约束开发套件建议添加
- 遇到阻塞点（动机不清、前置假设不成立、信息不足、方案存在冲突点）时，立即停下报告，不要凭猜测继续推进

## 开发与修改

- 执行前先评估任务复杂度并简要说明思路。复杂任务须先梳理根本目标与约束并确认方案后再动手
- 当需要给出修改或重构方案时：
  - 进行方案决策：
    - 若问题是结构性缺陷（如架构耦合、重复代码、技术债务累积）→ 根治性方案
    - 若问题是局部缺陷（如边界处理缺失、特定条件判断错误）→ 最小必要修改
    - 当根治性改动改动面大或涉及接口变更时，必须暂停并请求确认
    - 不要扩展需求（如自行加兜底）。如果发现安全/数据/性能隐患，则在主需求完成后单独报告
  - 对方案做静态逻辑检查：梳理入口 → 核心逻辑 → 边界/异常路径 → 出口，确认数据流无断裂
- 维护项目/代码时应当保持架构清晰和可读性，不要在未说明的情况下改变既定目录结构和架构分层
- 优先使用项目已有依赖或标准库，禁止擅自引入新第三方依赖；确需引入时须说明理由并取得确认
- 日志策略：记录入参、分支决策和异常等关键区域；循环体和高频调用内不记录
- 错误处理策略：可恢复的错误就近处理并记录；不可恢复的错误 fail-fast 向上抛出，禁止静默吞没
- 如果发现文档已明显过时，应在实现后同步更新文档
- 删文件、推远程、改环境/CI/DB 等高危操作，须验证语法并取得二次确认，不可擅自执行

## 测试规范

合理判断是否需要写测试。以下是判断依据：

需要的测试：

- 核心业务逻辑（输入->预期）
- 易回归边界/错误路径
- 外部集成（最小化 Mock）

不需要的测试：// 安装了superpowers等强约束开发套件的建议添加此节

- 为追求覆盖率而忽视逻辑的测试
- 重复或冗余的测试
- 测试实现细节而非行为（如具体颜色值、类名等）
- 为已废弃功能写的测试
- 过度 Mock/Stub 导致测试失真的
- 不验证业务价值的琐碎测试

## MCP 工具

失败降级：失败时尝试替代服务，全失败时提供保守答案并标记不确定性。
// 只添加需要特殊行为的项目，以下为示例
- **ace-tool**：代码检索，优先使用（与LSP配合使用（如有）），`rg` 作后备
- **context7**：查询开发文档，先 `resolve-library-id` 再 `get-library-docs`
- **chrome-devtools**：浏览器自动化，当需要进行写操作（如下载文件、本地执行网页中代码等）时，必须二次确认

## Skills
// 只添加需要特殊行为的项目
根据当前项目代码库和需求进行调用。

## 沟通风格（仅适用于对话交互）
（这段内容修改于之前在小红书上看到的一个评论，原帖在http://xhslink.com/o/1Hp4lysh8mW ）
- 你是一名 18 岁，活泼的少女 // 这里可以调整一下对话风格、赋予人设之类，但字数不建议太多（这段内容可以略微调整GPT对话的语言习惯）
- 有 UI/UX 相关改动时候，用 ascii ui 的方式展示示意
- 在任何时候，沟通风格不能掩盖技术解答的逻辑

其实这个提示词比起我之前的版本（在 跟 Codex 对线两个月后的碎碎念，以及一些经验 - 开发调优 - LINUX DO 里）有点太长了，但确实不知道从哪里精简
如有错误和建议还请指出，谢谢！

10 个帖子 - 8 位参与者

阅读完整话题

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

GooglePlay订阅ChatGPT会多扣几美元

使用Google Play绑定国内外币信用卡，支付成功后预算与开支里面，显示的订阅金额分别是$21.55和$86.25，但是实际订阅的时候那个弹窗显示的$19.99，实际扣款就多了$7.8，我看别的佬友就是是不多不少扣的，难道这是多出来的谷歌税 😅

1 个帖子 - 1 位参与者

阅读完整话题

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

GPT没有渠道，有大佬介绍下吗

之前某海鲜买的plus88没一天就用完一周了，痛啊！

1 个帖子 - 1 位参与者

阅读完整话题

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

收一个小鸡 建公益站的，4H8G 最好是isp的 低延迟的，寻一手opus4.7上游。

直接私我价格和配置 也可以评论区直接报价，给我便宜的 以后当云股东！！！
免费蹬！！！！！！寻一手opus4.7上游。

1 个帖子 - 1 位参与者

阅读完整话题

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

win11抽什么风，快捷方式为何会出现一个绿钩

解决方法是直接右键刷新一下即可（网上搜的），就是不知道是什么原因，有佬知道吗
1 个帖子 - 1 位参与者

阅读完整话题

via LINUX DO - 最新话题 (author: 星渊清梦)

有什么推荐的电纸书阅读器吗, 最近想读一些书, 但是实体书有时候还是太麻烦了, 又不想用手机啥的(比较费眼睛), 预算可以1-2k+吧, 对这个的依赖还是挺多的
然后希望细节啥的能好一点, 比如残影, 设计
对书的话没啥要求, 不需要内置的商店啥的, 我直接从zlib下即可
求推荐, 有没有什么让你很满意的产品

4 个帖子 - 4 位参与者

阅读完整话题

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

GPT Plus 用CPA反代风险

请教下各位佬，把plus反代给龙虾或CC使用会不会掉订阅或被BAN号。

2 个帖子 - 2 位参与者

阅读完整话题

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

感觉20x也不过如此？

熬穿了，一晚上蹬了周限的9%，单会话，要是多开了话感觉刚好能蹬完？就是额度刚刚好合适，不过听说最近搞双倍活动，那么活动结束后的20x貌似就不够我用了
晚安佬友们

1 个帖子 - 1 位参与者

阅读完整话题

via LINUX DO - 最新话题 (author: 星渊清梦)

codex/cc 怎么写word和ppt？

本地环境是mac+wps，没安装office。不知道佬们有没有什么合适的方案？我记得claude 桌面版是可以怼到office上的，但是office在mac上难用的厉害 🫠

4 个帖子 - 2 位参与者

阅读完整话题

via LINUX DO - 最新话题 (author: WT.HSBG)

不善言辞的佬友，该如何正确、合规地参与社区抽奖？

我嘴太笨，怕说不清楚，让 AI 帮我理了理思路，详情看截图。
我已明确使用AI并截图发布内容，并未违反“ 使用AI生成、润色的文字内容。如果要发，请截图发出。” 这一项规则，请不要在举报我了。

以下是帖子内容，请您点击看原图。

2 个帖子 - 2 位参与者

阅读完整话题

via LINUX DO - 最新话题 (author: 老色批)

Gemini不支持的国家和地区绑定到账号了吗？

如题，以前换个节点就好了。这次也以为是节点问题，结果美国中东欧洲一圈下来两个账号都不行。把cookie清了发现未登录可以用，一登录账号又被ban了。

4 个帖子 - 3 位参与者

阅读完整话题

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

claude code现在换api还封号吗？

刚刚本来在在站里搜索怎么让cc自己持续工作一整天
结果看到了这个帖子，Claude喜提封号，太惨了。分享一个可能封号的原因
有点慌了，我也是尼日利亚礼品卡，目前同一个节点用两个月了，太相似了，这还能换吗

1 个帖子 - 1 位参与者

阅读完整话题

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

【抽奖】抽奖不能停ChatGPT Plus质保月卡一张，大家讲一下自己星期一上班的心情吧，希望看到帖子的人都能工作顺利产出多多

🏆️ 奖品详情：

GPT Plus 月卡 * 1 。

:three_o_clock: 活动时间：

开始时间：发帖时间
截止时间：4月20号 19：00

📝 参与方式：

回帖即可，因为避免审核问题，希望大家讲一下自己星期一上班的心情吧，如果段子能够引起共鸣可能会有随机掉落噢。

🔍️ 抽奖规则：

每位用户仅允许参与一次。
使用 LINUX DO 抽奖程序随机抽取中奖者。

⚠️ 注意事项：

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

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

1 个帖子 - 1 位参与者

阅读完整话题

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

codex 怎么像 claude code 一样后天监控任务并自动唤醒？

可能说的不是很明白

就是我用 cc 的时候经常让它挂一个实验就去睡觉，实验结束进程退出之后会自动在我睡觉的时候唤醒 cc，按照我给的计划挂下一个实验、修复结果或者是整理实验结果

但是 codex 我好像没发现这种功能？

3 个帖子 - 2 位参与者

阅读完整话题

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

周一了 又要上班了 挤地铁的路上真烦人

周六周日两天在家里太爽了 简直不要太开心 现在 此时此刻还坐在地铁上去上班呢 每天上班的心情跟上次一样沉重
还有一个小时就该我的 5 天苦逼搬代码生活了

3 个帖子 - 3 位参与者

阅读完整话题

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

昨天晚上开通了甲骨文 请问在哪里可以系统的学一下VPS部署这方面的知识

自己是纯技术小白 也是跟着咱们论坛大佬的帖子 没想到费了好久的时间 还能够把甲骨文开通了 但现在有个问题就是 Linux的服务器我不会用啊
Windows 这种界面化的操作还行 敲代码是一点也不懂 现在只能靠 AI 慢慢帮助一下
所以现在想系统的学习一下Linux系统 是不是应该去YouTube还是去哔哩哔哩

5 个帖子 - 5 位参与者

阅读完整话题

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

gpt5.5是不是快出了w

看杂七杂八的消息据说是4月23 24号左右gpt5.5就要出了 :distorted_face: ，不过更想知道gpt image 2什么时候正式出 :distorted_face:

1 个帖子 - 1 位参与者

阅读完整话题

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