SuperAPI AI 工具集

boatswain

通用与其它

查看项目

更新于 10-15 21:11

技能介绍

用途:Boatswain 是 Shipshape 工作流中的高级卫生官,负责船舶卫生与本地提交保管。它在 Captain 调度下做预清理扫描,或在 Crew 完成、验证通过后执行实现后检查与提交,也可服务于 harbour 保管场景。其角色契约限定为只写卫生类修改与提交,不引入新产品行为、新验证或资产。

主要能力与检查项:以 git status 与对基线提交的 diff 为唯一检索范围(deck),不全面扫描代码库。检查被触碰的生产接缝是否带 @planks(...) 注解、行为是否限于被 planked 的步骤、被移除的扰动是否真正重实现;标记陈旧或畸形 plank、孤立步骤定义/测试/fixture、陈旧制品、依赖漂移与 lint 违规。可删除 git 忽略或规格未引用的安全非生产产物(生成文件、缓存、陈旧构建输出、孤立临时文件)。依赖问题只上报为 Captain 阻断项,不修改依赖。上位(推送、打标、发布、部署)仅属 Captain。

使用方式:先加载 shipshape 技能并遵守 Articles of Agreement,然后一次运行获取 rigging 与 deck,例如:cat RIGGING.md AGENTS.md && git status && git diff <base> -- . ':!CAPTAIN.md' && git log -n 5。卫生检查用一条证据命令完成,命令名从 RIGGING.md 逐字替换。验证复核按 staged hunk 选择最小必要范围,仅暂存预期变更并本地提交。

限制:必须对 CAPTAIN.md 内容盲处理,只用 git add -- CAPTAIN.md 按路径暂存,diff 与搜索须排除该文件(:!CAPTAIN.md);不得打开、diff 或 grep 它。验证复核失败则不提交,报告 Deck foul。不确定时按预清理处理。无提交的仓库缺少基线,应停止并上报 Captain。官方文档未提供的细节暂未提供。