算力舱手册

Appearance

AI App Skill ​

lzc-aipod-aiapp 是用于 AI Pod AI App 开发的 Agent Skill。它把 AI App 的资源目录、aipod.yml、agxorin/thor 服务、浏览器扩展、启动 loading、依赖声明和旧包迁移规则整理成可复用的开发上下文。

Skill 仓库地址:

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

适用场景 ​

在下面这些任务中建议启用这个 skill:

  • 创建新的 AI Pod AI App。
  • 将旧版 pkg/ai-pod-service/docker-compose.yml 迁移到 resource export 布局。
  • 为同一个 AI App 补充 agxorin/docker-compose.yml 和 thor/docker-compose.yml。
  • 调整 config/aipod.yml 中的 shortcut、依赖和本地化配置。
  • 接入 /startup/gate 或启动 loading。
  • 排查 AI App 服务 host、依赖解析、浏览器扩展和 resource 目录问题。

Codex 安装 ​

Codex 的 skill 默认安装到:

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

最简单的方式是在 Codex 中直接请求安装 GitHub 仓库中的 skill:

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

如果需要手动安装，可以执行:

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"

安装后，新开的 Codex 对话会自动发现这个 skill。当问题命中 AI Pod AI App 创建、迁移或调试场景时，Codex 会自动加载它；也可以在提示词中明确写上 使用 lzc-aipod-aiapp skill。

Codex 示例 ​

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 安装 ​

Claude Code 的个人 skill 默认安装到:

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

安装命令:

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"

如果只想让当前项目使用这个 skill，也可以把目录放到项目内:

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

Claude Code 中可以直接输入 /lzc-aipod-aiapp 调用，也可以描述 AI Pod AI App 相关任务，让 Claude 根据 skill 的 description 自动加载。

Claude 示例 ​

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

更新 ​

后续 skill 仓库有更新时，重新执行对应安装命令即可。安装命令会先删除本地旧目录，再复制最新的 lzc-aipod-aiapp 目录。

更新后建议开启一个新的 Codex 或 Claude Code 会话，确保工具重新读取最新的 SKILL.md 和 references。

参考 ​