AGENT SKILL

codex-bugfire-customizer

Direct, build, validate, preview, install, or package a custom Codex BUGFIRE companion from an original character brief and user-supplied background/pet images. Use when someone asks to create a structured AI character-direction draft, make their own Codex desktop pet or skin, convert owned PNG/JPEG/WebP art into a Bugfire Pack, require a human rejection/review gate, validate a bugfire-pack.json folder, or prepare a reusable companion pack without modifying the official Codex app.

License 许可
MIT
最近更新
2026-11-03
Stars
★ 1
Forks
0

01 前言 Front Matter

name
codex-bugfire-customizer
description
Direct, build, validate, preview, install, or package a custom Codex BUGFIRE companion from an original character brief and user-supplied background/pet images. Use when someone asks to create a structured AI character-direction draft, make their own Codex desktop pet or skin, convert owned PNG/JPEG/WebP art into a Bugfire Pack, require a human rejection/review gate, validate a bugfire-pack.json folder, or prepare a reusable companion pack without modifying the official Codex app.

02 资源文件 9

03 SKILL.md 正文

Codex BUGFIRE Customizer

Create one portable Bugfire Pack that controls the Codex background, six pet states, interaction sayings, local quest board, colors, and keepsake title. Use the deterministic compiler in this skill; do not hand-edit the runtime injector.

Locate the engine

Run scripts/find-engine.sh. It prints the first valid engine directory from CODEX_BUGFIRE_ROOT, this skill's repository, or ~/.codex/codex-dream-skin-studio.

Require either repository layout macos/scripts/bugfire-pack.mjs or installed-engine layout scripts/bugfire-pack.mjs. If no engine is found, ask the user to clone the project or set CODEX_BUGFIRE_ROOT.

Gather inputs

Read references/input-contract.md before accepting or generating assets.

Require exactly these minimum user inputs:

  • one background image;
  • one transparent or clean-background pet image used for every state;
  • pack name and pet name;
  • confirmation that the user has permission to use the assets.

Accept five optional pet images for building, bug, fire, success, and levelUp, plus a tagline, quote, palette, sayings, quest titles/targets, season label, and keepsake title.

Never require task text, source code, prompts, API keys, shell output, or account data. Do not fetch copyrighted character art merely because a user names a character; require user-supplied or clearly licensed art.

Optional AI character director

Read references/director-contract.md when the user wants AI-assisted character direction. The director may propose names, palette, voice, quests, and a pack manifest, but it cannot approve rights or bypass the pack validator.

For a real OpenAI-compatible request, set credentials in the environment and run the engine's bugfire-director.mjs draft-live. Never put the key in a command argument, plan, log, or shared fixture. If no key is available, do not pretend a live call happened; use a clearly labelled, checksum-verified recorded fixture if the project supplies one.

Before materialization, require an explicit review file that rejects and materially replaces one decision. materialize accepts only a human-approved plan; bugfire-pack validate is still mandatory afterward. Treat a scripted review fixture as a reproducible demo input, not proof that a named person approved it.

Build a pack

  1. Create a working directory outside the engine source tree.

  2. Initialize it:

    node scripts/create-pack.mjs init /absolute/path/to/workdir
    
  3. Copy user files to the exact paths declared by bugfire-pack.json. The starter requires assets/background.png and assets/pet-idle.png.

  4. Edit only bugfire-pack.json; preserve schema version 1 and allowed quest metrics.

  5. Validate, then compile into a separate empty directory:

    node scripts/create-pack.mjs validate /absolute/path/to/workdir
    node scripts/create-pack.mjs build /absolute/path/to/workdir /absolute/path/to/output
    
  6. Inspect theme.json and pack-report.json. Report which optional state images fell back to idle art.

Do not bypass validation or copy undeclared files into the output.

Preview and install

Create an offline interactive preview. Use its six state buttons to inspect every mapping and click the pet to sample configured sayings:

node scripts/create-pack.mjs preview /absolute/path/to/output /absolute/path/to/preview.html

Install only when the user asks to apply the pack:

ENGINE="$(scripts/find-engine.sh)"
if [ -x "$ENGINE/macos/scripts/install-bugfire-pack-macos.sh" ]; then
  INSTALLER="$ENGINE/macos/scripts/install-bugfire-pack-macos.sh"
else
  INSTALLER="$ENGINE/scripts/install-bugfire-pack-macos.sh"
fi
"$INSTALLER" --pack /absolute/path/to/workdir --no-apply

Without --no-apply, first tell the user that applying may ask to restart Codex. Never restart silently. Preserve the official .app, app.asar, signature, native controls, and loopback-only CDP boundaries.

Verify

Run:

ENGINE="$(scripts/find-engine.sh)"
cd "$ENGINE/macos"
npm test
node scripts/injector.mjs --check-payload --theme-dir /absolute/path/to/output

After an explicitly authorized live install, also run doctor-macos.sh --require-live and verify-dream-skin-macos.sh --reload. Do not claim live success unless the verifier returns pass: true.

Package for sharing

Share the compiled output directory or ZIP, not the raw workspace. Include theme.json, declared local images, and pack-report.json. Do not include progress files, logs, personal paths, .codex/auth.json, task screenshots, or API configuration.

Use references/acceptance.md for final signoff. Read references/research-notes.md only when explaining why these mechanics were selected.

04 同仓库更多 Skills

siuserxiaowei
siuserxiaowei/xiaowei-ai-tools

x-article-draft-uploader

把本地 Markdown 转为经核验的 X Articles 新草稿。适用于需要保留首图封面、正文图片相对位置,并在独立 Playwright 会话中复用用户已授权 Chrome 登录态的任务;不负责公开发布。

★ 1
siuserxiaowei
siuserxiaowei/xiaowei-ai-tools

wecom-operations

通过用户已配置的官方 wecom-cli 管理企业微信文档、智能文档、待办、会议和日程。适合创建或查询这些云端对象、把本地 Markdown 转为智能文档,以及在明确确认后更新或取消对象;不发送消息、不控制桌面客户端。

★ 1
siuserxiaowei
siuserxiaowei/xiaowei-ai-tools

wecom-local-vault

Inspect authorized local WeCom databases on macOS, create private plaintext snapshots, and query or export contacts, conversations, and messages without modifying the source account store. Use when the user asks to parse 企业微信/WeCom local data, recover a private database snapshot, inspect local contacts or sessions, search chat history, or export a bounded conversation.

★ 1
siuserxiaowei
siuserxiaowei/xiaowei-ai-tools

wechat-reading

Read and analyze WeRead/微信读书 search results, book metadata, bookshelf entries, progress, notes, highlights, public reviews, recommendations, and reading statistics through the official read-only Agent Gateway. Use for WeRead account questions or exports; do not imply that the current Gateway can add, remove, upload, rate, like, or edit content.

★ 1
siuserxiaowei
siuserxiaowei/xiaowei-ai-tools

wechat-mp-batch-exporter

Build a bounded, private archive from known WeChat Official Account article URLs or an owner-authorized account-history export, with explicit reconciliation of article, publish-group, and platform-marked-original counts. Use for batch body capture, history normalization, or enhanced metrics/comments workflows. Do not use for a one-page summary or to automate the WeChat client.

★ 1
siuserxiaowei
siuserxiaowei/xiaowei-ai-tools

wechat-local-vault

在 macOS 本机建立并查询私有微信数据快照。适用于盘点数据库、离线校验已有密钥候选、创建全量或增量明文快照、查会话与联系人、按时间检索消息、导出指定聊天、查看朋友圈或收藏,以及准备群聊摘要素材。所有查询只读,默认隐藏内部账号标识,不操控微信界面,也不发送任何内容。

★ 1