安装项目 AGENTS 指南

This commit is contained in:
wxm
2026-05-18 19:21:55 -07:00
parent 8cd173889c
commit 0c4227cba6
7 changed files with 240 additions and 23 deletions

View File

@@ -12,6 +12,7 @@ skills expose the runtime workflows directly. Do not use a global
and `design/gdd/game-pillars.md`.
- Runtime agents: `creative-director`, `art-director`, `technical-director`, `producer`
- Runtime source: `runtime/agents/`
- Project guide template: `project-template/AGENTS.md`
- References: `references/studio-docs/director-gates.md`, `references/studio-docs/templates/game-concept.md`, `references/studio-docs/templates/game-pillars.md`
- Standards: `standards/design-docs.md`
- Marketplace: `.agents/plugins/marketplace.json`
@@ -38,15 +39,20 @@ directly:
python3 scripts/install_codex_runtime.py /path/to/game-project
```
The installer writes custom agents to:
The installer writes custom agents and the project guide to:
```text
/path/to/game-project/.codex/agents/
/path/to/game-project/AGENTS.md
```
Each runtime agent is a standalone TOML file with `name`, `description`, and
`developer_instructions`, matching Codex custom-agent conventions.
If the target project already has a different `AGENTS.md`, the installer reports
a conflict and leaves it unchanged. Use `--force-agents-md` only when you intend
to overwrite it.
## Packaging Hygiene
Only plugin source files should be packaged. `.git/`, `.env`, `.DS_Store`, local