SuperAPI AI 工具集

bosun

部署与运维

查看项目

更新于 10-16 08:36

技能介绍

Bosun 是 Shipshape 工作流中的一个角色技能,定位为“水手长”:负责甲板卫生、验证复检和本地提交保管。使用前需先加载 shipshape 技能并遵守其 Articles of Agreement。

用途与职责:只做卫生编辑与提交,不引入新产品行为、新验证或新资产。可读取 CAPTAIN.md 以评估规格质量与 watchbill 完整性,但不得编辑。范围限于当前 watchbill、验证 dry-run 输出和未提交改动,不扫描整个代码库。

主要能力:清理陈旧规格、孤立步骤、孤立测试、死夹具、陈旧实现;可删除 git 忽略或未被规格引用的安全非生产代码产物(生成文件、缓存、陈旧构建输出、孤立临时文件)。将范围内不可达的生产代码标记为 Captain 阻塞项,并用 @shipwright 文档块标记,由 Shipwright 在后续 harbour 会话中移除;Bosun 不删除生产代码。检查 @planks(...) 注解是否使用当前 Gherkin 步骤文本、是否覆盖范围内所有生产接缝,缺失且关系明确时可补加,陈旧注解标记为阻塞项。标记未使用、低质、重复或过时依赖为阻塞项但不修改。对代码、规格、配置、Markdown 执行可用 lint,可调整 .gplintrc 等卫生工具配置。

使用方式:读取 RIGGING.md 获取项目工具值,运行其中的 discover 命令(如 npx cucumber-js --dry-run)确定验证范围,检查 git status、git diff 与近期日志,判断模式(pre-clean 或 post-implementation)。验证命令必须排除 @captain 标签场景(如 --tags "not @captain")。仅暂存推进场景或 watch 的改动,post-implementation 模式下本地提交,提交信息需概括改动并引用所推进的场景或 watch。

限制:出站操作(push、tag、publish、release、deploy)仅限 Captain。不得删除 watchbill.json,仅提醒 Captain 处理。若 watchbill.json 与验证结果冲突,以验证为准。skills.sh 不固定版本,无版本来源时跳过版本检查。规格或接缝关系不明确时,以确切证据上报 Captain 阻塞项。