用途:从经过筛选的上游模板初始化 GitHub 仓库配置,适合在搭建仓库自动化、Issue 与 PR 模板、CI 工作流等场景使用。
主要能力:通过运行时脚本 gh_bootstrap_runtime.py 完成 detect(检测语言、框架与已有 GitHub 文件)、fetch-template(下载模板源)、render-template(确定性替换占位符)、validate-tree(校验生成目录树)等步骤。输出目标包括 .github/workflows/、Issue 模板、PR 模板以及基础社区文件。
使用方式:先询问用户沟通语言、模板语言偏好以及模式(quick 快速、custom 自定义、full 全部模板)。检测命令为 python "<skill-dir>/scripts/gh_bootstrap_runtime.py" detect "$ARGUMENTS";若未检测到语言,应让用户手动指定主语言而非猜测。随后用 AskUserQuestion 收集项目名、GitHub owner/repo、作者、许可证等配置变量,扫描已有配置文件并规划冲突处理。读取 specs/template-catalog.md 映射所需文件与仓库 URL,再用 fetch-template 下载模板,用 render-template 渲染,最后用 validate-tree <target-root> 校验。
限制与规则:运行时脚本是唯一执行引擎,不得手工实现 detect/fetch/render/validate 步骤。绝不凭记忆编写配置文件,必须从下载的模板渲染。必须替换 {{variable}} 占位符(如 {{projectName}}),但不得改动 GitHub Actions 表达式(${{ github.* }}、${{ secrets.* }})或 action 版本固定(如 @v4),渲染器只替换 {{...}}。未经用户明确批准不得覆盖已有文件。模板下载失败(网络错误、404、超时)时需报告失败模板并提供跳过或重试选项。若仍有未替换的 {{placeholders}},拒绝完成。