SuperAPI AI 工具集

stop-me-init

编程与开发

查看项目

更新于 10-27 16:20

技能介绍

用途

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

大多数仓库两个列表都不需要。空猜测是一个真实有效的答案——此时应说明“默认规则已经适合这个仓库”,而不是为了显得周全而填充文件。

使用方式

  1. 技能扫描仓库并推断各字段取值。
  2. 在一个代码块中展示建议的 YAML,每个字段附一行证据。
  3. 提出恰好一个问题:按原样写入,还是做哪些修改?
  4. 只有在得到答复之后,才将 .stop-me.yml 写入仓库根目录。

适用场景

适用于需要为仓库初始化 stop-me 配置的场合,例如执行 “/stop-me-init” 或进行相关设置时。

限制

  • 绝不编写 DECISIONS.md——stop-me 会在其第一次提出异议时创建该文件。
  • 在用户确认之前不得写入 .stop-me.yml。
  • 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。