AI Pod Manual

English

简体中文

English

简体中文

Appearance

AI App Skill ​

lzc-aipod-aiapp is an Agent Skill for AI Pod AI App development. It organizes the AI App's resource directory, aipod.yml, agxorin/thor services, browser extensions, loading startup logic, dependency declarations, and old package migration rules into a reusable development context.

Skill repository address:

text
https://github.com/lazycatcloud/lzc-aipod-aiapp-skill/tree/master/lzc-aipod-aiapp

Applicable Scenarios ​

Recommend enabling this skill for the following tasks:

  • Creating a new AI Pod AI App.
  • Migrating the old pkg/ai-pod-service/docker-compose.yml to the resource export layout.
  • Adding agxorin/docker-compose.yml and thor/docker-compose.yml to the same AI App.
  • Adjusting shortcuts, dependencies, and localization configurations in config/aipod.yml.
  • Integrating /startup/gate or initiating loading.
  • Troubleshooting AI App service host, dependency resolution, browser extensions, and resource directory issues.

Codex Installation ​

The skill for Codex is installed by default at:

text
~/.codex/skills/<skill-name>/SKILL.md

The simplest way is to directly request installation of a skill from a GitHub repository within Codex:

text
请安装这个 Codex skill:
https://github.com/lazycatcloud/lzc-aipod-aiapp-skill/tree/master/lzc-aipod-aiapp

If manual installation is required, execute:

bash
tmpdir="$(mktemp -d)"
git clone --depth 1 https://github.com/lazycatcloud/lzc-aipod-aiapp-skill.git "$tmpdir"
mkdir -p ~/.codex/skills
rm -rf ~/.codex/skills/lzc-aipod-aiapp
cp -R "$tmpdir/lzc-aipod-aiapp" ~/.codex/skills/
rm -rf "$tmpdir"

After installation, a newly opened Codex chat will automatically detect this skill. When the query involves scenarios such as AI Pod AI App creation, migration, or debugging, Codex will automatically load it. It can also be explicitly specified in the prompt using 使用 lzc-aipod-aiapp skill.

Codex Example ​

text
使用 lzc-aipod-aiapp skill，帮我把当前仓库里的旧 AI App 迁移到 resource export 布局。
要求:
1. 将 pkg/manifest.yml 里的 aipod 配置拆到 config/aipod.yml
2. 将 pkg/ai-pod-service/docker-compose.yml 拆成 agxorin/docker-compose.yml
3. 如果已有 thor 镜像，补充 thor/docker-compose.yml
4. 检查 Traefik Host、depends_on_hosts 和启动 loading
5. 最后运行仓库现有验证命令

Claude Code Installation ​

Claude Code's personal skill is installed by default to:

text
~/.claude/skills/<skill-name>/SKILL.md

Installation command:

bash
tmpdir="$(mktemp -d)"
git clone --depth 1 https://github.com/lazycatcloud/lzc-aipod-aiapp-skill.git "$tmpdir"
mkdir -p ~/.claude/skills
rm -rf ~/.claude/skills/lzc-aipod-aiapp
cp -R "$tmpdir/lzc-aipod-aiapp" ~/.claude/skills/
rm -rf "$tmpdir"

If you only want the current project to use this skill, you can place the directory inside the project:

bash
mkdir -p .claude/skills
cp -R ~/.claude/skills/lzc-aipod-aiapp .claude/skills/

Claude Code can directly input /lzc-aipod-aiapp to invoke it, or describe tasks related to the AI Pod AI App. Claude will automatically load the relevant skills based on the skill description.

text
/lzc-aipod-aiapp

请检查这个 AI App 的 resource 导出是否正确:
1. aipod-resources/config/aipod.yml 是否只包含 AI Pod 专属配置
2. agxorin 和 thor compose 是否暴露相同的 Host
3. lzc-build.yml 是否正确声明 resource_exports
4. lzc-manifest.yml 是否可以直接使用 application.upstreams 转到服务 UI

Update ​

When updates are available in the skill repository, simply re-run the corresponding installation command. The installation command will first remove the local old directory and then copy the latest lzc-aipod-aiapp directory.

After updating, it is recommended to start a new Codex or Claude Code session to ensure the tools reload the latest SKILL.md and references.

References ​