技能安装与迁移说明

技能名称：project-init-panel-deploy 用途：自动化克隆、初始化、品牌化、Docker 部署开源项目，并强制改造成炫酷科技感玻璃面板风格 UI；同时对齐《开源软件改造部署外包服务合同》的交付物与验收标准。

一、目录内容

project-init-panel-deploy/
├── SKILL.md                      # 技能主文件（18 步工作流，必须先读）
├── references/
│   ├── panel-ui.md               # 面板风格 UI 设计与验收规范
│   └── delivery-contract.md      # 外包合同对齐的交付/验收规范
├── scripts/
│   ├── workflow_manager.py       # 工作流状态管理（初始化/恢复/报告）
│   ├── panel_ui_audit.py          # 阻断式面板 UI 自动审计
│   ├── deliverables_check.py     # 交付物清单核查
│   └── build_delivery_package.py # 交付压缩包构建
├── requirements.txt              # Python 第三方依赖
├── install.ps1 / install.sh      # 一键安装脚本
└── INSTALL.md                    # 本文件

二、环境要求

Python 3.9+（推荐 3.11/3.12）
Node.js 18+、pnpm、Docker / Docker Compose（执行实际项目部署时需要）
ffmpeg（项目内含视频推流/转码时需要）
网络可访问目标 Git 仓库与 npm / pip / apt 源

三、安装步骤

Windows（PowerShell）

# 1. 复制整个技能目录到 Codex 技能目录
Copy-Item .\project-init-panel-deploy "$env:USERPROFILE\.codex\skills\" -Recurse -Force

# 2. 执行安装脚本（创建 venv 可选；安装 playwright）
.\project-init-panel-deploy\install.ps1

macOS / Linux

# 1. 复制技能目录
cp -r ./project-init-panel-deploy ~/.codex/skills/

# 2. 执行安装脚本
bash ./project-init-panel-deploy/install.sh

若使用的是其他 Agent 框架，技能目录也可能是 ~/.agents/skills/，按对应框架要求放置即可。

四、安装 Playwright 浏览器

UI 审计脚本需要 Playwright 的 Chromium 内核：

python -m pip install -r requirements.txt
python -m playwright install chromium
# Linux 如缺系统库，再执行：
python -m playwright install-deps chromium

五、验证安装

python ~/.codex/skills/project-init-panel-deploy/scripts/panel_ui_audit.py --help
python ~/.codex/skills/project-init-panel-deploy/scripts/workflow_manager.py --help

能正常打印帮助即安装成功。

六、使用方式

在 Codex 对话中用自然语言触发，例如：

“初始化并部署项目，使用面板风格 UI <Git 仓库地址>”
“克隆并改造这个开源项目，Docker 部署”
“项目页面改版成科技感大屏风格”

Agent 会自动读取 SKILL.md 并按 18 步工作流执行，最终必须通过阻断式 UI 审计（0 violations）。

七、注意事项

技能脚本不含任何硬编码本机路径，可跨设备/跨平台直接迁移。
是否 git push、是否本地提交，严格以用户授权为准；用户要求“不推送代码”时禁止推送。
默认账号密码必须来自项目实际初始化逻辑，禁止猜测。
合同相关交付规范见 references/delivery-contract.md。

3.2 KiB Raw Blame History Unescape Escape