对齐参考仓库移除临时技能

This commit is contained in:
wxm
2026-05-19 00:35:54 +08:00
parent 06799561ab
commit 8cd173889c
11 changed files with 32 additions and 82 deletions

View File

@@ -1,7 +1,7 @@
{ {
"name": "codex-game-studios", "name": "codex-game-studios",
"version": "0.2.0", "version": "0.2.0",
"description": "A Codex plugin for game-production workflows, project runtime setup, and guided game concept brainstorming.", "description": "A Codex plugin for game-production workflows and guided game concept brainstorming.",
"author": { "author": {
"name": "wxm", "name": "wxm",
"email": "18854896936@163.com", "email": "18854896936@163.com",
@@ -14,7 +14,6 @@
"games", "games",
"game-development", "game-development",
"studio-workflow", "studio-workflow",
"runtime-setup",
"brainstorm", "brainstorm",
"gdd" "gdd"
], ],
@@ -22,7 +21,7 @@
"interface": { "interface": {
"displayName": "Codex Game Studios", "displayName": "Codex Game Studios",
"shortDescription": "Game-production workflows for Codex", "shortDescription": "Game-production workflows for Codex",
"longDescription": "Codex Game Studios exposes plugin-native skills for initializing game projects, installing bundled director agents, and guiding concept ideation into structured game design documentation.", "longDescription": "Codex Game Studios exposes plugin-native skills for guided game concept ideation and structured game design documentation.",
"developerName": "wxm", "developerName": "wxm",
"category": "Coding", "category": "Coding",
"capabilities": [ "capabilities": [
@@ -34,9 +33,7 @@
"privacyPolicyURL": "https://gitea.wuxianming.ac.cn/wxm/codex-game-studios", "privacyPolicyURL": "https://gitea.wuxianming.ac.cn/wxm/codex-game-studios",
"termsOfServiceURL": "https://gitea.wuxianming.ac.cn/wxm/codex-game-studios", "termsOfServiceURL": "https://gitea.wuxianming.ac.cn/wxm/codex-game-studios",
"defaultPrompt": [ "defaultPrompt": [
"Use $setup-runtime to initialize this game project.", "Use $brainstorm to shape my game concept."
"Use $brainstorm to shape my game concept.",
"Use $using-codex-game-studios to explain the workflow."
], ],
"brandColor": "#0F766E", "brandColor": "#0F766E",
"composerIcon": "./assets/codex-game-studio.svg", "composerIcon": "./assets/codex-game-studio.svg",

View File

@@ -8,8 +8,6 @@ skills expose the runtime workflows directly. Do not use a global
## Current State ## Current State
- Skills: - Skills:
- `$using-codex-game-studios` explains the plugin workflow and entry points.
- `$setup-runtime` installs bundled director agents into a target game project.
- `$brainstorm` guides game concept ideation into `design/gdd/game-concept.md` - `$brainstorm` guides game concept ideation into `design/gdd/game-concept.md`
and `design/gdd/game-pillars.md`. and `design/gdd/game-pillars.md`.
- Runtime agents: `creative-director`, `art-director`, `technical-director`, `producer` - Runtime agents: `creative-director`, `art-director`, `technical-director`, `producer`
@@ -33,11 +31,11 @@ still call specialist subagents as part of their core work.
## Runtime Setup ## Runtime Setup
To install the bundled custom agents into a game project, invoke `$setup-runtime` To install the bundled custom agents into a game project, run the installer
or run the installer directly: directly:
```bash ```bash
python3 skills/setup-runtime/scripts/install_codex_runtime.py /path/to/game-project python3 scripts/install_codex_runtime.py /path/to/game-project
``` ```
The installer writes custom agents to: The installer writes custom agents to:

View File

@@ -21,9 +21,10 @@ Spawn `creative-director` via Codex custom-agent delegation using gate
The matching custom agent must already be installed in the target project at The matching custom agent must already be installed in the target project at
`.codex/agents/<agent-name>.toml`. The plugin source copies for those agents live `.codex/agents/<agent-name>.toml`. The plugin source copies for those agents live
in `runtime/agents/`; run `$setup-runtime` if the target project is missing in `runtime/agents/`; run `python3 scripts/install_codex_runtime.py <target-project>`
them. Pass the context listed under that gate's **Context to pass** field, then from the plugin root if the target project is missing them. Pass the context
handle the verdict using the **Verdict handling** rules below. listed under that gate's **Context to pass** field, then handle the verdict
using the **Verdict handling** rules below.
Director names are Codex custom agent names. Do not recreate them by pasting Director names are Codex custom agent names. Do not recreate them by pasting
profile text into a generic default agent. profile text into a generic default agent.

View File

@@ -12,10 +12,8 @@ from pathlib import Path
ROOT = Path(__file__).resolve().parents[1] ROOT = Path(__file__).resolve().parents[1]
FORBIDDEN_NAMES = {".DS_Store", ".env", "plan.md"} FORBIDDEN_NAMES = {".DS_Store", ".env", "plan.md"}
FORBIDDEN_PARTS = {".git", "__pycache__"} FORBIDDEN_PARTS = {".git", "__pycache__"}
REQUIRED_SKILLS = { EXPECTED_SKILLS = {
"brainstorm", "brainstorm",
"setup-runtime",
"using-codex-game-studios",
} }
REQUIRED_RUNTIME_AGENTS = { REQUIRED_RUNTIME_AGENTS = {
"art-director.toml", "art-director.toml",
@@ -78,6 +76,20 @@ def assert_skill(skill_name: str) -> None:
fail(f"Missing skill description in {skill_path.relative_to(ROOT)}") fail(f"Missing skill description in {skill_path.relative_to(ROOT)}")
def assert_skill_set() -> None:
present = {
path.parent.name
for path in (ROOT / "skills").glob("*/SKILL.md")
}
if present != EXPECTED_SKILLS:
fail(
"Skill set mismatch. Expected exactly: "
+ ", ".join(sorted(EXPECTED_SKILLS))
+ "; found: "
+ ", ".join(sorted(present))
)
def assert_runtime_agents() -> None: def assert_runtime_agents() -> None:
agent_dir = ROOT / "runtime" / "agents" agent_dir = ROOT / "runtime" / "agents"
if not agent_dir.is_dir(): if not agent_dir.is_dir():
@@ -113,7 +125,8 @@ def assert_package_hygiene() -> None:
def main() -> int: def main() -> int:
assert_manifest() assert_manifest()
for skill_name in sorted(REQUIRED_SKILLS): assert_skill_set()
for skill_name in sorted(EXPECTED_SKILLS):
assert_skill(skill_name) assert_skill(skill_name)
assert_runtime_agents() assert_runtime_agents()
assert_package_hygiene() assert_package_hygiene()

View File

@@ -20,9 +20,10 @@ When this skill is invoked:
Director agent source files live in `../../runtime/agents/`. Before running Director agent source files live in `../../runtime/agents/`. Before running
any `full` review-mode gate, verify the target project has the matching any `full` review-mode gate, verify the target project has the matching
`.codex/agents/<agent-name>.toml` files installed. If they are missing, run `.codex/agents/<agent-name>.toml` files installed. If they are missing, run
`$setup-runtime` for the project first. When a gate is active, spawn the `python3 scripts/install_codex_runtime.py <target-project>` from the plugin
named Codex custom agent; do not recreate the director role by pasting root first. When a gate is active, spawn the named Codex custom agent; do not
profile text into a generic default agent. recreate the director role by pasting profile text into a generic default
agent.
2. **Check for existing concept work**: 2. **Check for existing concept work**:
- Read `design/gdd/game-concept.md` if it exists (resume, don't restart) - Read `design/gdd/game-concept.md` if it exists (resume, don't restart)

View File

@@ -9,7 +9,7 @@ Run the Codex Game Studios brainstorm workflow.
Before acting, read `DETAILS.md` for the full workflow. Apply project guidance from `AGENTS.md` and use `../../standards/` for path-specific standards. Before acting, read `DETAILS.md` for the full workflow. Apply project guidance from `AGENTS.md` and use `../../standards/` for path-specific standards.
Director gates use the bundled custom agents from `../../runtime/agents/`. If the current project does not already have those agents installed in `.codex/agents/`, run `$setup-runtime` first. Director gates use the bundled custom agents from `../../runtime/agents/`. If the current project does not already have those agents installed in `.codex/agents/`, run `python3 scripts/install_codex_runtime.py <target-project>` from the plugin root first.
Review mode controls review-gate intensity, not all custom-agent usage: Review mode controls review-gate intensity, not all custom-agent usage:
`full` runs key director/lead gates, `lean` runs only PHASE-GATE checks such as `full` runs key director/lead gates, `lean` runs only PHASE-GATE checks such as

View File

@@ -1,23 +0,0 @@
---
name: setup-runtime
description: "Use when a user asks to initialize, install, or refresh the Codex Game Studios runtime in a game project. Installs bundled director custom agents into the target project's .codex/agents directory."
---
# Setup Runtime
Install the Codex Game Studios runtime assets into the current game project.
## Workflow
1. Treat the current working directory as the target project unless the user names another path.
2. Run `scripts/install_codex_runtime.py <target-project>`.
3. Report installed, unchanged, and conflicting agent files.
4. If conflicts are reported, do not overwrite them unless the user explicitly asks for `--force`.
The installer copies runtime agents from the plugin's `runtime/agents/` directory to:
```text
<target-project>/.codex/agents/
```
The runtime currently contains only Codex custom-agent TOML files. It does not install hooks, rules, MCP servers, apps, or project templates.

View File

@@ -1,4 +0,0 @@
interface:
display_name: "Setup Runtime"
short_description: "Install game-studio agents into a project"
default_prompt: "Use $setup-runtime to initialize this game project."

View File

@@ -1,29 +0,0 @@
---
name: using-codex-game-studios
description: "Use when a user asks how the Codex Game Studios plugin is structured, what workflow to run next, how to initialize it, or how it differs from generic development workflow plugins."
---
# Using Codex Game Studios
Codex Game Studios is a game-production plugin built around plugin-discovered skills, not global `~/.codex/skills` bridge folders.
## Entry Points
- Use `$setup-runtime` when a project needs the bundled director agents installed into `.codex/agents/`.
- Use `$brainstorm` to turn a rough game idea into `design/gdd/game-concept.md`.
- Use `runtime/agents/` as the plugin source of bundled custom agents.
- Use `references/` and `standards/` only when the active workflow points to them.
## Review Intensity
`production/review-mode.txt` controls review-gate intensity, not whether agents
exist or whether future team workflows may use subagents for core work:
- `full` — all key director / lead review gates call their custom agents.
- `lean` — only PHASE-GATE review gates such as `/gate-check` call directors;
ordinary per-skill review gates are skipped.
- `solo` — all director review gates are skipped.
## Design Rule
Do not rely on a global `~/.codex/skills/codex-game-studio` bridge. The installed plugin exposes its skills through `.codex-plugin/plugin.json` with `"skills": "./skills/"`, matching the normal Codex plugin layout.

View File

@@ -1,4 +0,0 @@
interface:
display_name: "Using Codex Game Studios"
short_description: "Understand the game-studio plugin workflow"
default_prompt: "Use $using-codex-game-studios to explain this plugin workflow."