| name | starter-kit-import |
| description | Codex 中文技能工程的导入安装技能。当需要把共享仓库中的技能安装到 `~/.codex/skills` 或其他目标目录，并在安装前检查同名冲突时使用。 |
Starter Kit 导入安装
把准备好的技能工程导入到 Codex 技能目录。
默认来源
如果用户没有额外指定，默认当前工作区就是 starter kit 根目录。
默认目标
- 推荐全局目录：
~/.codex/skills/
- 也可以安装到用户指定的项目级技能目录
脚本安装方式
想直接安装时，优先使用 starter kit 根目录下的 scripts/install_starter_kit.py。
示例：
python scripts/install_starter_kit.py
py -3 scripts/install_starter_kit.py
python scripts/install_starter_kit.py --dry-run
python scripts/install_starter_kit.py --overwrite
python scripts/install_starter_kit.py --target ~/my-codex-skills
python scripts/install_starter_kit.py --overwrite --init-project .
导入流程
- 确认来源目录下存在
skills/ 子目录
- 检查目标目录中是否有同名技能
- 有冲突时询问覆盖还是跳过；脚本模式下可通过
--overwrite 指定
- 把选中的技能目录复制到目标目录
- 保留每个技能目录内的完整结构，包括
agents/openai.yaml
- 如果目标是某个真实项目，额外初始化项目根
AGENTS.md、docs/codex/v1/ 骨架和 .codex/plans/main/TASKS.md
- 输出新增、跳过、覆盖结果
说明
- 需要安装的是技能目录本身
- 安装后即可由 Codex 自动发现或显式调用
- 想恢复接近原版的项目级自动触发，应同时在项目根放置
AGENTS.md
- 如果用户本机 Python 版本不确定，优先建议使用
py -3
- 推荐命令：
python scripts/install_starter_kit.py --overwrite --init-project <项目目录>
