Back to Details

bootstrap-monorepo

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Bootstrap Polyglot Monorepo

初始化多语言单体仓库

This skill redirects to the canonical reference in mise-tasks.
→ See: mise-tasks/references/bootstrap-monorepo.md
该技能会重定向至mise-tasks中的标准参考文档。
→ 查看: mise-tasks/references/bootstrap-monorepo.md

When to Use This Skill

何时使用该技能

Use this skill when:
  • Starting a new polyglot monorepo from scratch
  • Setting up Python + Rust + Bun/TypeScript project structure
  • Need autonomous 9-phase bootstrap workflow (includes release setup)
  • Want Pants + mise integration for affected detection
在以下场景中使用该技能：
  • 从零开始新建多语言单体仓库
  • 搭建Python + Rust + Bun/TypeScript项目结构
  • 需要自主式9阶段初始化工作流（包含发布配置）
  • 希望集成Pants + mise以实现变更影响检测

Stack

技术栈

ToolResponsibility
miseRuntime versions (Python, Node, Rust) + environment variables
PantsBuild orchestration + native affected detection + dependency inference
工具职责说明
mise运行时版本管理（Python、Node、Rust）+ 环境变量配置
Pants构建编排 + 原生变更影响检测 + 依赖自动推导

Quick Commands

快速命令

bash
undefined
bash
undefined

After bootstrap, use these Pants commands:

After bootstrap, use these Pants commands:

pants --changed-since=origin/main test # Test affected pants --changed-since=origin/main lint # Lint affected pants tailor # Generate BUILD files pants list :: # List all targets
undefined
pants --changed-since=origin/main test # Test affected pants --changed-since=origin/main lint # Lint affected pants tailor # Generate BUILD files pants list :: # List all targets
undefined

Related Skills

相关技能

  • itp:mise-tasks
    - Task orchestration and affected detection (Level 11)
  • itp:mise-configuration
    - Environment and tool version management
  • itp:semantic-release
    - Release automation (Phase 8 reference)
  • itp:mise-tasks
    - 任务编排与变更影响检测（Level 11）
  • itp:mise-configuration
    - 环境与工具版本管理
  • itp:semantic-release
    - 发布自动化（参考第8阶段）

Troubleshooting

故障排查

IssueCauseSolution
Pants not foundNot installedInstall via 
brew install pantsbuild/tap/pants
mise not loadingShell hook not configuredConfigure mise shell hook in ~/.zshrc
BUILD files not generatedMissing 
pants tailor
Run 
pants tailor
to generate BUILD files
Affected detection emptyNo base branch setEnsure 
origin/main
exists and is up to date
Python version mismatchmise vs Pants conflictAlign Python version in mise.toml and pants.toml
Rust targets not foundPants Rust backend missingEnable Rust backend in pants.toml
Node/Bun not detectedNot in mise toolsAdd to mise.toml: 
node = "latest"
or 
bun
Dependency inference failsMissing imports in sourceEnsure explicit imports, run 
pants tailor
again
问题原因解决方案
未找到Pants未安装通过 
brew install pantsbuild/tap/pants
安装
mise 无法加载未配置Shell钩子在 ~/.zshrc 中配置mise Shell钩子
未生成BUILD文件未执行
pants tailor
运行
pants tailor
以生成BUILD文件
变更影响检测结果为空未设置基准分支确保
origin/main
分支存在且为最新状态
Python版本不匹配mise与Pants版本冲突对齐mise.toml与pants.toml中的Python版本
未找到Rust目标缺少Pants Rust后端在pants.toml中启用Rust后端
未检测到Node/Bun未添加至mise工具列表在mise.toml中添加：
node = "latest"
或 
bun
依赖自动推导失败源码中缺少显式导入确保存在显式导入，重新运行
pants tailor