AGENT SKILL
tanaab-codex-tools-maintenance
Tanaab-based Codex plugin maintenance using the packaged Codex Tools CLI. Use when inspecting installation health, diagnosing drift, refreshing a plugin, or reconciling its managed cache.
- License 许可
- MIT
- 最近更新
- 2026-09-27
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- tanaab-codex-tools-maintenance
- license
- MIT
- metadata
- { "tags": [ "tanaab", "workflow", "codex" ], "type": "workflow", "owner": "tanaab", "openclaw": { "emoji": "🩺", "homepage": "https://github.com/tanaabased/codex-tools/tree/main/skills/codex-tools-maintenance", "requires": { "bins": [ "node" ] } } }
- description
- Tanaab-based Codex plugin maintenance using the packaged Codex Tools CLI. Use when inspecting installation health, diagnosing drift, refreshing a plugin, or reconciling its managed cache.
02 资源文件 3
- 参考文档agents/openai.yaml363 B
- 资产文件assets/icon-large.png23.5 KB
- 资产文件assets/icon-small.svg9.6 KB
03 SKILL.md 正文
Codex Plugin Maintenance
Overview
Inspect one Codex plugin and apply the requested refresh or managed-cache repair through the bundled Codex Tools runtime.
When to Use
- Diagnose installation health, compatibility, registration, enablement, or payload drift.
- Refresh a local source or pinned npm release, or reconcile managed cache content.
When Not to Use
- For first installation or an npm release change, use
$tanaab-codex-tools-setup. - Do not publish packages or repair unrelated Codex configuration.
Preconditions
- Resolve
<plugin-root>two directories above thisSKILL.md. Use itsdist/codex-toolsexecutable; never substitute a checkout or global executable. - Require Node; npm refresh also needs npm.
- Resolve the intended source and any explicit Codex home, marketplace, or cache path.
Workflow
- Run
<plugin-root>/dist/codex-tools --version. Stop if missing or mismatched with the plugin package version. - Inspect with
status --repo-root <plugin-path> --json(doctoris an alias), or usecache check --repo-root <plugin-path> --jsonfor managed payload drift. - Select the repair:
refresh <plugin-path>reinstalls changed local source.refresh npm:<package>reinstalls the exact recorded npm release.cache syncreconciles the selected managed cache; it does not install a plugin.
- Preview the chosen command with
--dry-run --json. Review the source, target, marketplace, planned writes, preservation behavior, and unresolved native checks. - When the request authorizes repair, repeat the reviewed command without
--dry-run. - Re-run
statusorcache checkas appropriate and report the observed outcome.
Checkpoints
- An inspection request does not authorize mutation. Preserve reviewed selectors and targets.
- Refuse ambiguous targets, preserve unmanaged and excluded content, and retain npm release pins.
- Report partial native effects and retained source edits without promising rollback.
Completion Criteria
- Diagnosis ends without filesystem writes or child processes.
- Repair has a matching final check that demonstrates convergence or identifies remaining problems.
- Installation, authentication, activation, and payload claims remain distinct.
Bundled Resources
- CLI: options, precedence, and failure contract.
../../dist/codex-tools: packaged Node runtime.
Validation
Confirm the bundled runtime and any mutation matched the requested repair, and that final status or cache readback supports the reported outcome. Keep unobserved authentication and activation unknown.