用途
stop-me-init 用于为当前仓库编写 .stop-me.yml 配置文件。它的核心原则是:通过阅读仓库来写配置,而不是通过访谈用户来写配置。字段本身的含义由 stop-me 技能定义(gate 1 overrides、gate 3 horizon),而本技能只负责为某一个具体仓库决定这些字段的取值。
主要能力
技能会猜测每一个字段,展示每个猜测及其背后的证据,只询问一次,然后写入文件。
猜测 horizon
在猜测之前需要先阅读以下内容:
- git log(仓库年龄、贡献者数量,通过 git log --format=%ae | sort -u 统计)
- 部署文件(Dockerfile、fly.toml、Procfile、compose、k8s manifests)
- CI workflows
- 发布配置(package.json 的 publishConfig / not-private、pyproject 的 classifiers)
- 用于判断租户列的 schema 文件
horizon 的三种取值及判断依据:
- prototype — 仓库存在时间约 30 天以内,只有一个部署目标或没有部署目标,没有 CI
- platform — 发布包、暴露有文档的 API,或带有租户列
- product — 其他所有情况。当在两者之间犹豫时,选择 product;horizon 只影响 gate 3 的权重,猜错只需改一行即可修正。
猜测 irreversible / reversible
只列出内置默认规则对该仓库判断错误的部分:
- 默认规则会遗漏的已发布 SDK、proto 或 wire-format 目录 → irreversible
- 仅本地使用的临时路径(启动时重建的开发迁移、scratch 目录)→ reversible
大多数仓库两个列表都不需要。空猜测是一个真实有效的答案——此时应说明“默认规则已经适合这个仓库”,而不是为了显得周全而填充文件。
使用方式
- 技能扫描仓库并推断各字段取值。
- 在一个代码块中展示建议的 YAML,每个字段附一行证据。
- 提出恰好一个问题:按原样写入,还是做哪些修改?
- 只有在得到答复之后,才将 .stop-me.yml 写入仓库根目录。
适用场景
适用于需要为仓库初始化 stop-me 配置的场合,例如执行 “/stop-me-init” 或进行相关设置时。
限制
- 绝不编写 DECISIONS.md——stop-me 会在其第一次提出异议时创建该文件。
- 在用户确认之前不得写入 .stop-me.yml。
- 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。