创建新 workspace
先生成受管约定，再按需创建具体的包和应用。
pnpm create repoctl
pnpm run repo:new
稳定的任务生命周期
每条命令回答一个仓库问题，并留下可以复查和保存的结果。
repo init初始化
安装受管根目录资产和标准 repo 脚本。
repo doctor诊断
检查 workspace 结构、工具版本、hooks 与发布配置。
repo new创建
选择已知模板，在写入前预览完整文件计划。
repo check校验
用一份可复现计划串联 lint、typecheck、build、test 与 tsd。
repo release发布
记录变更意图、更新固定版本组、发布并执行收尾 hook。
从仓库当前状态开始
repoctl 同时支持新建项目和渐进接入，不强迫两类仓库走同一条迁移路线。
接入已有 workspace
保存脱敏基线，预览资产差异，再用可审查的小步骤逐项接入。
repo doctor --markdown --redact
repo upgrade --no-overwriterepoctl
边界清楚的仓库任务
模板、受管资产、校验与报告相互独立，让自动化保持透明。
受管资产
覆盖本地决策前，先比较标准根目录文件。
模板目录
按名称创建类库、CLI、服务、客户端与文档站。
校验计划
执行前通过 dry-run、JSON 或 Markdown 查看完整任务图。
环境报告
隐藏仓库路径和 token 后再共享排障上下文。
记得住的命令地图
日常入口保持简短，脚本需要稳定输出时再使用显式模式。
repo init- 建立仓库约定
repo doctor- 诊断仓库健康状态
repo templates- 查看可用模板
repo new- 创建 workspace 项目
repo check- 规划或执行校验
repo env- 输出运行环境
repo upgrade- 同步受管资产
repo release- 更新版本并发布
同时服务人和自动化
在命令边界预览写入、保存稳定产物，并对支持信息执行脱敏。
- 终端
- JSON
- Markdown
- 文件输出
repo check --full --dry-run --json --out reports/check-plan.json
repo env support --markdown --redact --out reports/support.md先得到一份有效诊断
本地安装 repoctl，检查仓库，再根据证据选择下一项任务。
pnpm add -D repoctl
pnpm exec repo init
pnpm exec repo doctor
pnpm exec repo check --dry-run继续处理眼前的任务
文档按仓库目标组织，需要实现细节时再进入对应参考页。