back
loading skill details...
为新仓库一键初始化“任务前先查技能”的工作流。适用于初始化技能预检新仓库、给新仓库装技能工作流、迁移 skill preflight、把当前流程封装到另一个仓库,或把技能预检、项目级 hooks、`.learnings/` 和团队使用说明快速落到目标仓库时。
--- name: skill-preflight-bootstrap description: 为新仓库一键初始化“任务前先查技能”的工作流。适用于初始化技能预检新仓库、给新仓库装技能工作流、迁移 skill preflight、把当前流程封装到另一个仓库,或把技能预检、项目级 hooks、`.learnings/` 和团队使用说明快速落到目标仓库时。 --- # 新仓库技能预检初始化 把“先查技能,再执行任务”的仓库级能力一键落到目标目录。 ## 什么时候用 在下面这些场景触发: - 你想把当前仓库的技能预检流程迁移到另一个新仓库 - 你希望新仓库默认带上 `skill-preflight.py` - 你需要同时生成项目级 `.codex/settings.json` / `.claude/settings.json` - 你希望顺手创建 `.learnings/` 和团队说明文档 ## 快速使用 ### 1. 先决定目标目录 目标目录通常是一个新的或尚未配置这套流程的仓库。 ### 2. 执行 bootstrap 脚本 从本 skill 根目录运行: ```bash python3 scripts/bootstrap-skill-preflight.py /path/to/target-repo ``` 如果只想先看将要写入什么: ```bash python3 scripts/bootstrap-skill-preflight.py /path/to/target-repo --dry-run ``` 如果目标仓库里已有同名模板文件,且你确认要覆盖: ```bash python3 scripts/bootstrap-skill-preflight.py /path/to/target-repo --force ``` ## 它会写什么 - `scripts/skill-preflight.py` - `scripts/hooks/skill-preflight-reminder.sh` - `scripts/hooks/error-learning-reminder.sh` - `.codex/settings.json` - `.claude/settings.json` - `.learnings/LEARNINGS.md` - `.learnings/ERRORS.md` - `.learnings/FEATURE_REQUESTS.md` - `docs/skill-preflight-usage.md` - `AGENTS.md` 中的技能预检片段 ## 使用原则 - 默认只写项目级配置,不碰用户全局环境 - 已存在的 `AGENTS.md` 只追加片段,不整文件覆盖 - 已存在的设置文件会合并 hooks,而不是粗暴覆盖 - 默认跳过已存在的模板文件;只有 `--force` 才覆盖 ## 验证 落地后建议至少做三步检查: 1. 验证 JSON: - `python3 -m json.tool /path/to/target-repo/.codex/settings.json` - `python3 -m json.tool /path/to/target-repo/.claude/settings.json` 2. 验证预检脚本: - `python3 /path/to/target-repo/scripts/skill-preflight.py "react performance"` 3. 检查 `AGENTS.md` 是否只追加一次技能预检片段 ## 参考 - 示例和验收方式见 `references/examples.md` ## 注意 如果目标仓库的 `AGENTS.md` 或设置文件有强烈的项目定制逻辑,先用 `--dry-run` 看计划,再决定是否执行。
don't have the plugin yet? install it then click "run inline in claude" again.