关于 maintain
面向 setup-ai-build-kit 项目的维护技能,用于核对记录、线上副本差异、分支保护、密钥、版本更新和定期维护,并避免将未提交工作纳入提交。
主要功能
- 01核对记录与线上副本差异
- 02检查分支保护和密钥
- 03跟踪月度与季度维护
- 04处理升级检查和工具包更新
适用场景
- 01维护访问时检查项目
- 02确认月度或季度工作是否到期
- 03检查密钥与分支保护缺口
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ gwpicard/ ai-build-kit --skill maintain安装后在 Claude Code 中输入/maintain确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
VERSIONreferences/handover-retirement.mdkit-update.mdlatest-release.mdmonthly.mdproject-checks.mdquarterly.mdrecipe-move.mdrisk-move.mdtruing.mdscripts/kit-leftovers.pykit-released-copies.jsonkit-retired-skills.jsonold-skill-pointers.pyrecipe-freshness.pyrisk_move.pysettings-rules.pystanding-lines.shupgrade-check.pytemplates/handover.md详细介绍
维护
维护绝不会提供排队、并行、循环构建或自动合并。
确保记录属实,将实时副本与 main 比较,并完成工具包更新。除常规
更新外,应用任何更改前先报告发现的问题。
在 Codex 中,如果推送、获取或远程检查失败,并提示 unable to get password from user,请使用 python3 运行已安装的 setup-ai-build-kit 技能中的
templates/foundation/codex-github-check.py,并传入 --message。给出
它生成的句子,然后停止。
每次访问
- 加载
references/truing.md并遵照执行。确保此人的未提交 工作不会进入任何提交。报告这些工作,并指向/what-now; 清理检查点步骤暂停,但只读步骤继续。 使用scripts/recipe-freshness.py读取项目配方。如果它报告配方 已过时或被取代,请说明其单行结论,并提议打开一个条目,转向当前建议。 如果对方拒绝,不要更改任何项目文件。 - 使用
live-copy技能,将实时副本与main比较。不要更改实时服务或变更日志。 对于备份、恢复、预览或配方检查,提供/setup-hosting,并指出任何差距。 - 从项目根目录运行
merge/scripts/protect-branch.py --check <origin's owner/repository> main。 退出码为 0 表示必需;3 表示私有 Free 方案的限制,只通知一次, 不提供操作选项;4 表示可用,因此可在获得批准后提议不带--check运行。 报告其他退出码。未经批准,不要更改保护设置。 - 从项目根目录运行已安装的
setup-ai-build-kit技能中的templates/foundation/scan-secrets.sh,并传入--all。 退出码为 0 表示未发现机密;1 表示发现机密;2 表示扫描无法运行。 如果发现机密,请建议轮换它。绝不显示其值。 - 阅读
.ai-build-kit-maintenance。每月工作在last-light-pass之后 30 天到期;若该字段缺失,则从建项时起算。 每季度工作在last-full-pass之后 90 天到期;若该字段缺失,则从建项时起算, 且有人要求交接时也要执行。任一工作在被请求时都要执行。说明跳过的工作何时到期。 - 使用
references/latest-release.md,运行scripts/upgrade-check.py --latest --route。 - 每次访问都使用
references/kit-update.md完成工具包更新。每月常规流程的第一步会完成此项。在 Codex 中,提供会话开始时的 GitHub 检查。
到期的例行工作
每月工作到期时,加载 references/monthly.md 并按顺序执行。
每季度工作到期时,还要加载 references/quarterly.md。
交接与退役
交接或退役时,加载 references/handover-retirement.md。
完成条件
记录与实际事件相符;已报告保护检查和实时副本差距;到期工作及获批的更改已保存; 并且此人知道下次访问何时到期。
评论
支持 Markdown