القائمة
Verify Codex configuration health — AGENTS.md, hooks, config.toml, agents, skills, secrets scan, and MCP reachability. Reports ✅/⚠️/❌ for each check.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | health |
| description | Verify Codex configuration health — AGENTS.md, hooks, config.toml, agents, skills, secrets scan, and MCP reachability. Reports ✅/⚠️/❌ for each check. |
Verify that the Codex Brain configuration is healthy and complete.
wc -l < AGENTS.mdwc -c < AGENTS.md (budget: ≤32KB = 32768 bytes).codex/config.toml exists and is valid TOML#:schema directive on first linecodex_hooks = true under [features].codex/hooks.json exists and is valid JSON: jq . .codex/hooks.jsonjq '[.. | objects | select(has("command"))] | length' .codex/hooks.json.codex/hooks/*.sh files exist and are executable:
for h in .codex/hooks/*.sh; do test -x "$h" || echo "NOT_EXEC: $h"; done
.codex/agents/*.toml files existname, description, developer_instructions fields:
for f in .codex/agents/*.toml; do grep -q 'developer_instructions' "$f" || echo "INCOMPLETE: $f"; done
.agents/skills/*/SKILL.md files existname: and description: in frontmatter:
for f in .agents/skills/*/SKILL.md; do grep -q '^name:' "$f" || echo "BAD FRONTMATTER: $f"; done
brain/tasks/CODEX_ERRORS.md exists (warn if missing)git ls-files | xargs grep -l 'BEGIN.*PRIVATE KEY\|password\s*=\s*[^{][^"\x27]\{8,\}' 2>/dev/null | head -10
Report any matches as ⚠️ warnings.
Check that the required runtimes are available (all MCP tools run via uvx or npx):
command -v uvx &>/dev/null && echo "uvx: ✅" || echo "uvx: ❌ missing — install via: pip install uv"
command -v npx &>/dev/null && echo "npx: ✅" || echo "npx: ⚠️ missing — install Node.js (for playwright)"
command -v ccc &>/dev/null && echo "cocoindex CLI (ccc): ✅" || echo "cocoindex CLI (ccc): ⚠️ optional — install via: pip install cocoindex"
# uvx-based: codebase-memory-mcp, code-review-graph, serena, cocoindex-code-mcp-server (available when uvx installed)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Codex Health — <repo>
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
AGENTS.md budget ✅ 187 lines / 4.2KB (budget: 32KB)
config.toml ✅ valid + schema directive
hooks.json ✅ valid JSON, 9 hooks registered
Hook scripts ✅ 9/9 executable
Subagents ✅ 5/5 complete
Skills ✅ 30/30 have valid frontmatter
Error log ✅ CODEX_ERRORS.md exists
Secrets scan ✅ no leaks detected
codebase-memory-mcp ⚠️ missing — run setup-plugins.sh
cocoindex (ccc) ✅ installed
code-review-graph ✅ installed
uvx (playwright/serena) ✅ installed
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Overall: ⚠️ healthy with 1 warning
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
After the table, list any ⚠️/❌ items with one-line fix instructions.
Auto-configure AGENTS.md and brain/ knowledge docs for a new project. Use when setting up Brain Bootstrap in a new repository. Discovers the codebase, fills in templates, and writes project-specific configuration.
Use before any new feature, component, or behavioral change — when you need to explore requirements and design before writing code. Hard gate — no code until design is approved.
Build the project and verify it compiles cleanly. Use after making changes to confirm nothing is broken before running tests. Reads the build command from brain/build.md.
Activate safety mode — review every destructive command before running. Use before working on production infrastructure, migration scripts, or any task where a typo could be catastrophic.
Generate a user-facing changelog from git commits — categorize, filter noise, translate to user language. Pass a tag or date as argument (e.g. "$changelog v1.0.0" or "$changelog 2026-01-01").
Save session state before context gets full or before ending. Writes current task state, branch, and loaded docs to brain/tasks/todo.md so the next session can resume cleanly.