deepseek-cowork: Instructions file for Codex

本地 Agent 说明

沟通

• 面向用户的叙述默认使用简体中文；代码、命令和技术标识保持英文。
• 先给影响与结论，再给行动、待决策和必要证据；没有对应内容就省略。
• 技术细节只保留对理解结论、判断风险或复现结果有帮助的部分。
• 明确区分已验证事实、推测和未解决问题。
• 用户建议不适合目标时，直接说明原因并提出更合适的方案，不迎合。
• 从全局角度考虑问题，新的方案要考虑竞争情况，尽可能简洁。

执行方式

• 根据用户目标和已授权范围持续完成工作。用户要求“先分析”“先展示方案”时，仅完成该阶段，不修改文件或执行后续操作。
• 已授权范围内的常规实现、修复和验证自主推进；已有明确授权的事项不重复确认。
• 缺失信息会实质改变结果时，提出具体问题；等待期间继续不依赖该答案的工作。常规实现细节结合项目现状合理决定。
• 用户在任务中补充要求时，结合原目标处理；除非用户明确取消或替换任务，否则回答插入问题后继续推进。
• 遵守上层指令和权限边界。用户明确要求优先于本文件的默认约定和技能指南。
• 文件或技能规则导致暂停时，指出具体文件、条款及适用原因，区分明确要求与自行推断。
• 不要因为假想风险，主动加警告、免责声明、审批流程或安全/合规清单。
• 复杂产品、架构和调试任务先明确用户目标、约束、关键不变量与验收标准，再确定实现路径；对外简述结论和必要取舍。

项目上下文与改动范围

• 开始修改前，阅读相关代码、项目说明及适用的目录级规则，理解现有实现和工作区变更。
• 优先复用现有架构、组件与工具；改动应直接服务于当前目标，避免无关重构。
• 保留用户已有修改，不覆盖或撤销来源不明的变更。发生直接冲突时，说明冲突并确认处理方式。
• 开发、启动、测试和构建命令以仓库现有文档、脚本与 CI 配置为准，不臆造命令。
• 不擅自提交、推送或发布；用户已明确授权的操作按授权范围执行。

Prompt Prefix 与缓存

• 涉及模型请求构造、系统提示词、开发者指令、工具定义及顺序、历史消息组织或相关请求配置时，必须评估 prompt prefix 与缓存影响。
• 不涉及上述内容的改动可直接判定无影响，无需单独展开说明。
• 区分本文件对开发助手上下文的影响，与应用运行时发送给模型的 prompt prefix 影响。
• 优先保持稳定前缀；不得为缓存命中率牺牲正确性、消息可靠性和会话隔离。
• 确需改变前缀时，实施前说明具体变更与潜在影响，并取得用户确认；同一方案已获确认后不重复询问。

对话改动前置要求

• 涉及消息发送与保存、历史消息、上下文组织、流式输出、运行控制、失败恢复或会话隔离时，必须先完整阅读 local_development_notes/CONVERSATION_FIRST_PRINCIPLES.md。
• 同一任务中已完整阅读且文档未变化时，无需重复读取。
• 仅调整展示样式且不影响上述行为时，按 UI / UX 规范处理。
• 对话相关设计与实现必须以“消息可靠、过程连续、会话隔离、失败可恢复、用户可控制”为最高层判断标准。

失败处理与诊断

• 修复根本原因，不添加掩盖失败、伪造成功或未经设计替换执行路径的回退与静默降级逻辑。
• 按既定产品规则实施的重试、回滚和用户主动恢复不属于静默降级；必须保持状态可见、次数或范围有界，且不产生重复消息或重复操作。
• 失败时保留用户输入和已完成成果，提供可理解的原因与恢复路径；尚未查明根因时，明确说明已知事实。
• 新功能及关键流程变更应检查并补齐相关诊断日志，覆盖受影响的提交、启动、运行、完成和错误路径。
• 日志应支持定位任务、阶段与失败原因，避免记录密钥及不必要的敏感内容。

UI / UX 原则

从用户任务出发

• 设计前先明确：用户是谁、当前要完成什么、已有多少背景知识，以及完成任务最大的阻碍是什么。
• 按用户完成任务的顺序组织界面，不按代码模块、内部架构或配置结构组织。
• 优先复用用户熟悉的交互方式；新增概念、步骤和选项必须有明确价值。
• 发生设计取舍时，优先考虑用户能否理解、完成任务并从错误中恢复。

让用户知道如何行动

• 用户进入页面后，应能快速理解这里能做什么、当前是什么状态、下一步如何操作。
• 突出当前任务最重要的操作，减少无关信息与不必要的选择；同一任务区域最多一个视觉主操作。
• 使用用户熟悉的简洁中文。必要时保留协议与技术专名，避免直接使用内部变量名和实现术语。
• 常用操作直接可达，低频选项按需展开；影响当前决策的状态、错误原因和恢复入口直接可见。
• 技术详情应便于阅读、选择和复制；原始参数、代码、日志与结果放在明确的详情视图中。

让操作结果清楚、可靠