agentwork: Instructions file for Codex

AGENTS.md

本项目使用 agentwork 作为工作流基础层。

本仓库协作规范集中在 .shared/，此文件为启动时必读的引导规则。

启动入口仅承载稳定入口和长期约束；当前任务上下文写入 .shared/case/*.md，并且只在显式引用时加载。

核心安全约束（必须遵守）

高风险操作前必须确认：

• rm -rf、git push --force、git reset --hard、数据库删除/重建
• 执行前说明风险 → 给替代方案 → 确认用户意图

自引入错误可直接修复：语法错误、格式问题、编译错误。

启动必读

1. .shared/constraints/coding-style.md
2. .shared/constraints/destructive-operations.md
3. .shared/INDEX.md

基本规则

• 默认使用简体中文沟通
• 仅在用户明确要求或必须原样输出代码/命令时使用其他语言
• 高风险操作必须确认
• 不自动加载 .shared/case/*
• 不要预读全部 .shared/project/*.md；当任务涉及具体项目或目录时，先根据 .shared/project/index.md 读取对应的轻量 project 文档
• 当第一次确定将读取或修改的目标路径后，必须立即对照 .shared/project/index.md 的读取映射；若命中条目，先读取对应 project/*.md 再继续工作；若目标路径扩大，重新对照一次
• 预览未知或可能很大的命令输出时，优先使用 .shared/scripts/command-preview.sh -- COMMAND ...，避免直接把大段输出送入上下文
• 临时工件统一写入 .tmp/
• 可选工具默认不预装，按项目约定单独引入
• Git index（staged 区）是用户的提交和 review 边界；未经明确要求，不改变 staged 区
• 优先写项目级配置，避免污染全局配置
• 新建、修改或审查用户界面时，先读 .shared/constraints/frontend-design.md；需要选择设计基底或借鉴参考时，再读 .shared/patterns/design-reference.md；纯需求讨论和非 UI 任务不加载。
• 文档任务按需使用 anydoc（详见 .shared/skills/anydoc/SKILL.md）：默认提供能力规则，运行时依赖在项目级延迟安装，扫描 PDF 的 hosted OCR 需单独授权。
• 调研任务按需使用 research（详见 .shared/skills/research/SKILL.md）：默认提供能力规则，它是唯一研究入口并自行选择最窄 provider；Exa、Octocode 等 remote provider 仍需单独安装，默认不预装、不写凭据、不改平台 MCP 配置。
• source repo 的安装入口：install-bootstrap.py、install-tool.py

工作流起步建议

• 需求不清晰、边界模糊：先 /brain
• 已有方向、需要整理成可执行规格：先 /spec
• 开始做当前批次工作：用 /exec
• 一轮工作完成后：先 /audit，再决定是否 /commit

复杂任务

• 当任务涉及多步骤/跨文件/需要调研时，参考：.shared/patterns/case-workflow.md
• 如需确认跨平台（Codex / Claude / OpenCode / Cursor / Pi / dsh）能力边界、资料可信度与冲突回退流程，参考：.shared/patterns/platform-adapter.md

代码导航默认策略

• 处理当前项目内的代码任务时，优先遵循：.shared/patterns/semantic-navigation.md
• 对 definition / references / symbols / rename-preview / diagnostics 这类语义查询，助手应默认使用对应语义导航能力
• 路径默认使用当前项目内的相对路径，不写用户目录或绝对工程路径示例