健康
- 作者仓库星标 0
- 作者仓库 skills-registry
- 领域
- 安全
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @tomevault-io · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- macOS · Linux · Windows
- 运行环境要求
- Node.js
- 检测到的文件与系统行为
-
- 只读
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Health Skill — Codex Configuration Validation
Verify that the Codex Brain configuration is healthy and complete.
## Steps
### 1. AGENTS.md
- Exists and is not empty
- Line count: `wc -l < AGENTS.md`
- Size: `wc -c < AGENTS.md` (budget: ≤32KB = 32768 bytes)
- Contains key sections: Skills Roster, Exit Checklist, Terminal Rules
### 2. config.toml
- `.codex/config.toml` exists and is valid TOML
- Has `#:schema` directive on first line
- Has `codex_hooks = true` under `[features]`
### 3. hooks.json
- `.codex/hooks.json` exists and is valid JSON: `jq . .codex/hooks.json`
- Hook count: `jq '[.. | objects | select(has("command"))] | length' .codex/hooks.json`
### 4. Hook Scripts
- All `.codex/hooks/*.sh` files exist and are executable:
```bash
for h in .codex/hooks/*.sh; do test -x "$h" || echo "NOT_EXEC: $h"; done
```
### 5. Subagents
- All `.codex/agents/*.toml` files exist
- Each has `name`, `description`, `developer_instructions` fields:
```bash
for f in .codex/agents/*.toml; do grep -q 'developer_instructions' "$f" || echo "INCOMPLETE: $f"; done
```
### 6. Skills
- All `.agents/skills/*/SKILL.md` files exist
- Each has `name:` and `description:` in frontmatter:
```bash
for f in .agents/skills/*/SKILL.md; do grep -q '^name:' "$f" || echo "BAD FRONTMATTER: $f"; done
```
### 7. Error Log
- `brain/tasks/CODEX_ERRORS.md` exists (warn if missing)
### 8. Secrets Scan
```bash
git ls-files | xargs grep -l 'BEGIN.*PRIVATE KEY\|password\s*=\s*[^{][^"\x27]\{8,\}' 2>/dev/null | head -10
```
Report any matches as ⚠️ warnings.
### 9. MCP Tool Reachability
Check that the required runtimes are available (all MCP tools run via `uvx` or `npx`):
```bash
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)
```
## Report Format
```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
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.
---
> Source: [brain-bootstrap/codex-brain-bootstrap](https://github.com/brain-bootstrap/codex-brain-bootstrap) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->
章节与文件索引
按说明文件中的顺序排列。
1. 代理.md
2.配置.toml
3. 钩子.json
4. 钩子脚本
5. 分代理
文件/命令 -> wc -l < AGENTS.md · wc -c < AGENTS.md · .codex/config.toml · #:schema · codex_hooks = true · [features] · .codex/hooks.json · jq . .codex/hooks.json
内容校验值 -> e0a1bd57b867
当前原文的自动摘译,尚未人工审校。
1. 代理.md
存在且不为空 行数:
wc -l < AGENTS.md大小:wc -c < AGENTS.md(预算:≤32KB = 32768 字节) 包含关键部分:技能名册、退出清单、终端规则2.配置.toml
.codex/config.toml存在且有效 TOML 在第一行有#:schema指令 在[features]下有codex_hooks = true3. 钩子.json
.codex/hooks.json存在且有效 JSON:jq . .codex/hooks.json挂钩计数:jq '[.. | objects | select(has("command"))] | length' .codex/hooks.json4. 钩子脚本
所有
.codex/hooks/*.sh文件都存在并且可执行:5. 分代理
所有
.codex/agents/*.toml文件均存在,每个文件都有name、description、developer_instructions字段: