SuperAPI AI 工具集

setup-conventions

部署与运维

查看项目

更新于 10-15 19:56

技能介绍

用途:为 agentic-sdlc 技能集做一次性的仓库约定初始化,属于提示驱动的设置流程,而非脚本。原则是先探查、展示结果、确认,再写入;未获单独许可不进行提交、推送或导入。

主要能力与使用方式分四步。一、探查:执行 git remote -v 判断托管平台与仓库;检查根目录 AGENTS.md、CLAUDE.md 是否已有“Rules that bind”块;查看 docs/agents/、.agentic-sdlc.json、GLOSSARY.md、docs/adr/、.scratch/;查看 .github/workflows/ 中已有 CI 关卡;检查已应用的 ruleset 与分支保护;识别 monorepo 信号。二、展示并确认:给出推荐项供决策者一键接受。追踪器按远程平台选择(GitHub/GitLab/本地 markdown/other),标签默认 needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix;保护分支为 main 加发布分支;归属模式默认 patterns 或 strict;决策记录存于 docs/adr/ 或私有路径;机制为可复用工作流作为必需检查与 ruleset 导入。三、写入:按序写入并先展示、先检查路径。将“Rules that bind”块写入已存在的文件(若已有则就地替换,模板为 assets/AGENTS-block.md);不创建第二个 agent 文件;两者都不存在时需询问创建哪一个,不得自行选择。随后生成 docs/agents/tracker.md、docs/agents/conventions.md、.agentic-sdlc.json,并运行 agentic-sdlc validate 校验。本地 markdown 追踪器需将 .scratch/ 加入 .gitignore。GitHub 上生成调用 anivar/agentic-sdlc/.github/workflows/conventions.yml 的固定标签工作流,并给出 rulesets/main-protected.json 的导入命令;GitLab 使用 assets/gitlab-ci.yml 的任务;其他平台使用原生 git 钩子(agentic-sdlc hooks install)。所有改动作为一个评审用拉取请求提交;ruleset 导入由决策者在合并后执行。四、完成:说明哪些技能读取这些文件;仅切换追踪器或更改模式时才需重跑;此后手动编辑 docs/agents/*.md 与 .agentic-sdlc.json 为常规路径;修改配置文件、git 钩子等会改变守卫行为,需先描述并取得同意。

适用场景:为采用 agentic-sdlc 的仓库建立统一约定、追踪器、决策记录与 CI 关卡。限制:探查与写入细节依赖仓库实际状态;未提供具体价格与平台兼容清单。