用途:从零创建规范的 batterie-de-savoir Python 仓库,也可把草稿代码提升为正式仓库,或从已有仓库中抽取模块成独立包。原则是结构确定、含义不确定:初始化脚本生成骨架,CLAUDE.md 内容需自行填写。
主要能力:通过五步工作流完成建仓。第一步访谈,确认项目名(kebab-case)、一行描述、bon 前缀(3-4 个小写字母),并判断模式:greenfield(空目录/不存在)、adopt(有代码但无 .git/)、extract(从其他仓库抽取)。第二步展示将创建的文件计划并确认。第三步执行初始化脚本。第四步填写 CLAUDE.md 中的 [TODO] 标记,包括模块地图与关键约定。第五步运行校验脚本或按清单人工核对。
使用方式:greenfield 用 uv run --script ${CLAUDE_SKILL_DIR}/scripts/init_repo.py --name <name> --prefix <prefix> --description "<desc>";adopt 需先把现有代码移入 src/<pkg>/ 并对工作目录执行脚本,脚本对非空目录的告警属预期;extract 先建目标目录、复制源模块、运行脚本,再从源仓库移除代码并添加依赖。校验用 uv run --script ${CLAUDE_SKILL_DIR}/scripts/validate_repo.py。
适用场景:新建 Python 包、把 scratch 代码转正、抽模块独立成包;/close 检测到非仓库目录代码时也会建议使用。
限制:仅支持 Python 仓库(TypeScript 为未来扩展);不创建插件结构(.claude-plugin/、skills/);不处理 monorepo。基准包括 git main 分支、hatchling、src 布局、tests、CLAUDE.md、bon、GitHub 远程。资料未提供收费、价格或其它平台信息。