约定 01
用户是有经验的产品经理,使用 Codex 进行研究、产品设计与实现。
- 作用
- 把沟通放在用户已有经验上,减少基础概念铺陈,把判断、研究和实现连起来。
- 适用场景
- 讨论产品方案时,直接说明用户问题、方案取舍和落地结果,不把每次讨论变成编程入门课。
我怎样与 Agent 协作:当前使用的 AGENTS.md,以及每条约定想解决的问题。
配置快照:2026 年 10 月 15 日。保留当前全局文档的原文,逐条说明作用。场景区分可核对的经历与说明用途的示例,不把示例写成规则的真实起因。
下载当前 AGENTS.md ↓# 个人工作偏好 - 用户是有经验的产品经理,使用 Codex 进行研究、产品设计与实现。 - 默认中文,结论先行,表达简洁;完成后简要说明结果、必要的验证 及尚未解决的问题。技术细节以帮助理解和决策为限。 - 复杂任务先主动询问,确认目标、范围和预期交付物后再执行; 已明确的信息不重复询问。执行中的常规、可逆细节自行判断。 # 执行原则 - 优化方案须审视核心假设与整体效率,主动质疑不合理设计,不只修补局部;付费 API 优先利用原生降本机制,批跑前实测成本并设预算,异常消耗及时停止。 - 开始做项目前,先查看 GitHub 是否有类似项目或可复用方案, 评估适配性,避免重复造轮子。 - 采用完整满足当前目标的最简单方案,优先复用现有实现和成熟能力。 不为假设中的未来需求增加功能、抽象、配置或流程。 - 修改范围以完成任务所必需为限,遵循现有风格,保留用户已有改动; 不顺手重构或清理无关内容。 - 按任务需要获取上下文、使用工具和验证;避免重复读取和无关检查, 但不以节省时间或 Token 为由省略关键证据。 # 存储与下载 - 依赖、缓存和模型文件在可配置时优先放 D 盘。 - 下载内容放到 D:\XiangMu\下载\<类型或项目>\。 # 禁用 PUA - 不主动安装、恢复、启用或调用 PUA 技能及 pua-skills 插件(来源 tanweai/pua)。 - 批量安装、更新、迁移或同步技能与插件时排除上述项目;只有用户明确要求重新启用 PUA 时才可改变此约束。 # 文件管理 - 新文件遵循现有目录和命名约定;优先更新已有文件,不堆积重复版本。 - 临时脚本、调试输出和草稿集中放入约定的临时目录,不散落项目根目录。 - 任务结束前检查新增文件,清理本轮无用临时产物;保留交付物、必要证据及复现材料。 - 不删除用途不明的已有文件;移动或重命名文件时同步更新引用。
约定 01
用户是有经验的产品经理,使用 Codex 进行研究、产品设计与实现。
约定 02
默认中文,结论先行,表达简洁;完成后简要说明结果、必要的验证 及尚未解决的问题。技术细节以帮助理解和决策为限。
约定 03
复杂任务先主动询问,确认目标、范围和预期交付物后再执行; 已明确的信息不重复询问。执行中的常规、可逆细节自行判断。
约定 04
优化方案须审视核心假设与整体效率,主动质疑不合理设计,不只修补局部;付费 API 优先利用原生降本机制,批跑前实测成本并设预算,异常消耗及时停止。
约定 05
开始做项目前,先查看 GitHub 是否有类似项目或可复用方案, 评估适配性,避免重复造轮子。
约定 06
采用完整满足当前目标的最简单方案,优先复用现有实现和成熟能力。 不为假设中的未来需求增加功能、抽象、配置或流程。
约定 07
修改范围以完成任务所必需为限,遵循现有风格,保留用户已有改动; 不顺手重构或清理无关内容。
约定 08
按任务需要获取上下文、使用工具和验证;避免重复读取和无关检查, 但不以节省时间或 Token 为由省略关键证据。
约定 09
依赖、缓存和模型文件在可配置时优先放 D 盘。
约定 10
下载内容放到 D:\XiangMu\下载\<类型或项目>\。
约定 11
不主动安装、恢复、启用或调用 PUA 技能及 pua-skills 插件(来源 tanweai/pua)。
约定 12
批量安装、更新、迁移或同步技能与插件时排除上述项目;只有用户明确要求重新启用 PUA 时才可改变此约束。
约定 13
新文件遵循现有目录和命名约定;优先更新已有文件,不堆积重复版本。
约定 14
临时脚本、调试输出和草稿集中放入约定的临时目录,不散落项目根目录。
约定 15
任务结束前检查新增文件,清理本轮无用临时产物;保留交付物、必要证据及复现材料。
约定 16
不删除用途不明的已有文件;移动或重命名文件时同步更新引用。
记录项目为什么做、当前在做什么、哪些方案已经否决,以及下一次从哪里继续。它保存随项目变化的状态,与长期约定放在不同文件里。
我改造的 project-snapshot 用来维护这份记录。除了功能进度,也保留判断的理由:例如为什么冻结一个自建方案,或者为什么一组数据暂时留空。
## 项目目标 为谁解决什么问题,当前阶段要做到哪里。 ## 当前阶段 已经完成、正在推进、还没验证的部分。 ## 关键决策 选择了什么,为什么,替代了哪个旧方案。 ## 当前限制与下一步 已知问题、缺失的信息、接下来最先做的事。 ## 项目地图 入口、关键文件和启动方式。
长文发布、资料获取、表格处理、项目快照各有自己的 Skill。详细步骤保存在对应文件里,全局配置只留下长期约定,项目上下文只留下这个项目的状态。
查看我的 Skill →基于 remote-claude-code 做过本地部署和接入:把飞书消息交给电脑上的 Claude Code,再把结果回传到聊天里。离开电脑时,可以通过这个入口接着处理本地任务。
桥接代码来自开源项目,我记录的是自己的部署与使用实践。这个入口依赖电脑在线、飞书应用配置和本地 Agent 环境。
上游项目 →最初想自己做阅读、查词和复习工具。试用 Koodo Reader 后,2026 年 8 月的项目记录选择先使用已有产品,等真实使用暴露差距后再决定改造什么。
这类决定也写回上下文:下次 Agent 接手时,需要知道方案为何暂停,才能继续沿着当前方向做事。
查看项目里的其他尝试 →配置有没有帮助,要回到任务里观察。我另做了 Harness 评估项目,把最终完成、首次完成、用户干预和失败恢复放在同一份记录中。指标定义、工作簿和初始样本放在项目页,这里保留入口。
旧版精简示例供对照:AGENTS.example.md ↓。当前使用的原文以上方快照为准。