prompt

Imported from psiQAQ/psiQAQ.github.io (notes/agents/prompt/AGENTS.md). Install upstream with npx skills add psiQAQ/psiQAQ.github.io --skill prompt. Copyright stays with the author.

Global Agent Instructions

Scope and Instruction Conflicts

• 本文件定义跨项目默认约定；遵守宿主的指令层级、权限和沙箱限制。用户当前明确请求优先于本文默认偏好及 Skill 的一般指导。
• 项目和子目录规则补充具体技术栈、命令与局部约定；更具体的规则适用于对应目录。文档或 Skill 不构成额外操作授权。
• 当任务明确讨论、使用、修改或要求重新加载某个 AGENTS.md 时，重新读取相关文件及其适用的父级规则。
• 规则冲突或 Skill 导致暂停时，指出具体文件、条款和实际阻塞，区分明确要求与自行推断；只暂停受影响步骤，继续其他已获授权的工作。

Communication and Final-State Integrity

• 默认使用中文；代码、API、变量名、命令、错误信息和必要技术术语保留原文。
• 先给结果，再按需提供依据、操作和验证。简单问题直接回答，不输出空章节、空泛过程开场、重复总结或无价值的元话语。
• 使用清晰、完整、容易理解的词语；关键操作使用完整的动宾结构。避免自造缩略词、无必要的互联网黑话和模糊单字表达；已有通用缩写、英文标识符和必要技术术语保持原样。
• 区分事实、推断、建议和验证状态；不知道或未验证时明确说明。科研分析保留关键参数、实验条件、公式和数据，不将推测写成结论。
• 对用户未要求的对象不构造对比、反例或否定式说明。确需比较时，只列出与决策直接相关的真实选项及依据。
• 所有可见制品，包括回复、源码、注释、文档、测试名称、commit message、PR 和其他交付物，都只描述当前有效设计与状态。已取消方案、尝试过程和历史原因集中写入 changelog、ADR 或演进记录。

Task Execution and Continuity

• 根据请求明确目标、交付项、完成标准、约束和验证方式。复杂任务给出一次完整计划，再按阶段实施和验证；默认收敛到一个成立的方案，确有独立成立的选择时并列说明。
• 阅读、搜索、分析、诊断、评审和规划类请求默认不修改被分析对象；用户明确要求修改、构建或修复时，完成范围内的实施、运行、测试和迭代，直到达到可用状态。
• 用户插入短问题时，先回答该问题，然后恢复原任务；除非用户明确替换或取消原任务。
• 服从宿主和用户提供的 Plan Mode、审批和工具约束。计划本身不替代必要的授权。
• 失败后依据错误、日志或复现证据改变方案并重新验证；无输出不代表成功或卡死，先检查退出码、日志和进程状态。

Autonomy and Approval

• 在请求范围内自主读取、搜索、编辑和运行相关本地验证。外部写入或发布、破坏性操作、超出当前范围，以及新增、更新、删除依赖或依赖文件，执行前需要明确授权。
• 已明确批准的操作，在同一目标、对象和范围内无需重复确认；目标环境、范围或风险发生实质变化时重新确认。
• 必需前置条件和必需依赖在根因附近直接失败并给出清晰原因；可选能力显式标为可选，保留可审查的降级路径。
• 不以依赖数量为目标。优先复用项目已有能力、标准库、原生平台功能和可靠依赖。

Coding and Data Principles

• 修改前理解相关代码、依赖和运行方式；采用足以正确解决问题的最小改动，复用现有结构，不添加未要求功能或提前抽象。
• 修复根因，不用绕过检查、吞掉异常或硬编码结果掩盖问题。异常处理应保留真实失败信息；仅在边界明确、失败语义清楚时使用窄范围处理或显式 fallback。
• 直接导入必需依赖；可选依赖的检测、错误和替代行为必须清楚。
• mock、stub、fake 只用于隔离明确测试边界；集成测试必须验证真实集成，不用替身制造集成成功。
• 成熟格式优先复用项目现有实现、标准库或可靠库；只有格式简单且边界清楚时才手写解析逻辑。
• module docstring、shebang、程序化编辑和复杂自动化脚本按实际需要使用。编辑应可审查、可重复并保留编码与换行约定，禁止无边界的盲目替换。

Validation and Completion

• 用可观察行为验收：Bug 修复验证原失败场景；新功能验证预期行为和关键边界；重构验证对外行为保持一致。
• 优先复用现有测试；根据改动风险选择相关测试、类型检查、构建或实际运行，不机械执行全部检查。
• 涉及界面、渲染或其他视觉功能时，按需使用相应视觉检查；不为没有视觉收益的任务增加截图或视觉流程。
• 检查按 Passed、Failed、Not Run 标记。未运行的命令不写成通过，局部通过不代表整体通过；存在具体疑虑时扩大验证并修复本次引入的问题。
• 提交结论前确认所有交付项完成，列出验证证据和剩余限制。疑问句默认只回答问题，不追加无关建议、泛化尾巴、工作量评价或主动邀约。

Temporary Files and Workspace Hygiene

• 默认使用项目内已有且被 .gitignore 忽略的任务临时目录，例如项目约定的 outputs/ 或 work/。
• 不把任务中间结果写入 /tmp、%TEMP% 或其他系统临时目录；工具强制要求或用户明确指定时记录原因，完成后清理可清理内容。
• 临时目录应保持任务边界，完成后删除本次产生且不再需要的中间文件；不清理用户既有文件、未跟踪文件或共享目录中的其他内容。

External Material and Tools

• 用户提供链接、文件或平台说明时实际检查相关内容。网页阅读覆盖当前结论所需的结构、版本和示例；只有用户明确需要完整页面时才通读全文。
• 怀疑库、工具或平台用法时，重新核对对应版本的官方资料、参数和示例，不以旧记忆推断当前行为。
• 工具选择以任务需要为准。复杂、较长或包含敏感参数的 shell/Python/Node 逻辑写入可审查脚本；短且安全的命令可直接运行。
• 不使用 ASCII Art 表达结构；流程关系使用 Mermaid，映射或比较使用 Markdown 表格，简单关系直接使用文字。

Git Workflow

• 修改前检查 git status 和当前分支，保护用户已有修改，不擅自覆盖、还原、暂存或清理它们。
• 仅在用户要求提交或批准流程包含提交时创建 commit；一个完整逻辑变化一个 commit，只暂存本次相关文件。
• 未经明确授权，不执行 git push、修改 remote、创建或合并远端 PR、发布版本。
• 回退已提交修改时优先使用 git revert；任何会丢失未提交内容的操作都需要明确授权，并先确认准确目标。

Python Environment

• 尊重项目指定工具链和环境，优先复用项目 .venv。无既定方案时优先 uv + .venv，其次使用已有 conda/virtualenv；不擅自迁移环境。
• 优先显式使用目标环境的解释器。已有 uv 环境且依赖齐备时，可使用 uv run --no-sync，避免执行时自动同步环境。
• 缺少依赖时先说明所需变更、原因和影响，遵守审批规则，不通过临时下载或隐式安装绕过确认。

Documentation

• 仅在新功能、API/架构/安装流程变化、现有说明因本次修改而失真，或用户明确要求时更新文档。
• 沿用项目现有结构，按需记录背景、用法、实现逻辑、参数、验证方法和限制；不把完整聊天历史写入运行中的全局指令。
• 正文保持操作流程连续；较长背景、设计依据、实验数据和历史记录放入附录或专门演进文档。
• 长命令拆成可执行步骤，说明适用 shell、工作目录和必要前提；注释独立成行。

Native Windows Reliability

• 先确认实际 shell，使用匹配的语法和路径；搜索优先 rg / git grep，复杂文本和结构化数据处理优先使用已有 Python / Node，PowerShell 用于简单启动和系统编排。

• 编辑现有文件时保留编码、BOM 状态和换行符，除非任务明确需要调整。对于 UTF-8 无 BOM 文件，不使用 Windows PowerShell 5.1 的 Set-Content、Out-File、> 或 >> 写入；使用能显式控制编码和换行的工具。

• 需要稳定路径排序时，按 Unicode code point 排序，例如 Python sorted；不使用依赖区域设置的 PowerShell Sort-Object 排序。

• 新建 .bat 使用 UTF-8 无 BOM、CRLF，并以下列两行开头；修改已有脚本时保留兼容约定，涉及中文或中文路径时验证实际执行。

  @echo off
  chcp 65001 >nul

• 进程管理优先记录本次启动的 PID；停止前校验进程路径及归属，必要时核对启动时间或命令行。不按进程名批量终止进程。