开发工具链

Nexus 的 AI 驱动开发依赖一套「AI 编程助手 + 项目规则 + 技能」的工具链。产品经理可以用自然语言说明业务目标并验收结果，开发人员可以进一步控制技术方案和代码质量；两种角色使用的是同一套工程和流程。

Coding Agent

Coding Agent 是能够读取工程、修改文件、执行命令并反馈结果的 AI 编程助手。Nexus 当前支持以下工具：

工具	角色
Claude Code（推荐）	Anthropic 出品的 AI 编程 CLI，最适合执行 Nexus 的 Spec 工作流
Codex	OpenAI 出品的 Coding Agent，可通过 CLI、IDE 或云端任务使用
Trae	字节跳动推出的 AI IDE，支持 Builder 与智能 Agent 工作流
GitHub Copilot	GitHub / Microsoft 的 AI 编程助手，覆盖 IDE、CLI 与代码评审

这些工具可读取项目中的规则与技能文件，按 Nexus 约定的方式工作。不同工具的规则入口名称可能不同，接入时应将 Nexus 主规则同步到对应文件（例如 AGENTS.md、CLAUDE.md 或工具自定义规则）。

推荐优先使用 Claude Code：它与 Nexus 当前 .claude/skills/、.claude/rules/ 和 Spec 指令集配合最完整。其他 Agent 可通过等效规则文件接入。

规则与技能目录对照

下表指项目仓库内的配置目录。个人级技能通常安装在各 Agent 的用户配置目录中，不应提交到项目仓库；具体优先级以所使用工具的当前版本为准。

Agent	项目级规则入口	项目级技能目录	备注
Codex	AGENTS.md	.agents/skills/	也会读取用户级 $CODEX_HOME/skills/。
Claude Code	CLAUDE.md、.claude/rules/	.claude/skills/	Nexus 当前 .claude/ 结构可直接使用。
Trae	.trae/rules/	.trae/skills/	若版本未提供原生 skills 入口，可将技能说明放入规则目录或引用 AGENTS.md。
GitHub Copilot	.github/copilot-instructions.md	.github/skills/	也可使用仓库根目录 AGENTS.md 作为通用规则。
Nexus 的规范技能源目录是 .claude/skills/。接入其他 Agent 时，保留技能的指令内容和触发方式，并按上表复制或转换到目标 Agent 的目录；不要只改目录名而忽略其规则格式差异。

规则与技能（.claude/）

项目根 .claude/ 是 Agent 的「行为配置」：

• CLAUDE.md / 等效规则文件：AI 必读的项目快照与强制规则（类型、技术栈、CLI 约定、工程铁律、前后端规范、AI 协作规范）。
• .claude/rules/：细粒度规则文件（编码质量、Spec 工作流、密码哈希、系统初始化、双 schema 同步等）。
• .claude/skills/：Spec 工作流和通用任务技能，让 Agent 以标准化指令完成规划、实施与专项操作。
• .claude/settings.json：本地权限配置。

规则文件的同步约定：若使用多款 Agent（如 Codex + Claude Code + Trae），修改主规则文件后需同步对应的等效规则文件，保证 Agent 行为一致。

Nexus Skill 指令集

Nexus 提供一组标准化的 Agent 指令（Skill），覆盖从规划到上线的全链路。典型能力包括：

• 规格驱动：/spec-* 系列（规划、设计、实施、测试、评审、归档、提交）
• 启动与开发：/quick-start、/new-module
• 界面与内容：/i18n-translate、/theme-extend
• AI 与质量：/models-update、/security-scan
• 构建与维护：/build-image、/migration-baseline

具体 Skill 名称以项目 .claude/skills/ 中实际注册为准。其共同点是：都是「人类触发、Agent 执行、产出可追溯文档」的标准化指令。

各通用技能的适用范围、调用方式和完整示例见通用技能使用。

工具协同关系

Coding Agent（Codex / Claude Code / Trae / Copilot 等）
   │ 读取
   ├─ CODING.md / .claude/rules/（强制规则与编码规范）
   ├─ .claude/skills/（Spec 工作流与通用任务技能）
   │ 操作
   └─ .oms/（规格 / Sprint / Plan / Feat 归档）

文档约定

• CODING.md（项目根）：代码风格与命名规范（见 项目规则体系），Agent 修改扩展代码时应遵循。
• 目录边界：业务扩展优先落在 modules/<name>/，保持主应用与框架解耦。