用途:为仓库建立或更新可执行、可审查、可复用的工程约束基线(Guardrails),回答三件事:默认怎么做、绝对不能做什么、什么变化会触发下游重审。它不是每个 feature 的固定流程节点,主流程默认消费 Guardrails,只有命中触发条件时才创建或更新。
主要能力:支持首次生成与更新两类动作。首次生成分 interview_first(访谈式,适用于新项目)与 repository_scan_first(仓库分析式,适用于存量仓库,需按事实标准做证据分层)。更新策略分 create baseline、update impacted domains、restructure、no change。先判定动作再写正文,并输出触发原因、受影响领域、下游重审建议、是否阻塞设计/发布。
使用方式:先扫描现有 Guardrails、ADR、架构说明、CI 规则、事故复盘、Runbook、发布规范;证据不足时用 AskUserQuestion 只问关键缺口;按模板撰写,每条规则包含 Rule ID、Level、Rule、Rationale、Applies To、Verification、Owner、Source;更新场景附变更影响摘要;完成后建议运行 guardrails-reviewer 准出。
适用场景:项目启动建基线、技术栈/平台/认证/数据存储变化、新安全合规标准进入、事故复盘产出长期规则、同类评审问题反复出现、多团队协作边界模糊等。
限制:不写单功能局部实现、一次性 workaround、仅影响单模块差异或个人偏好;无证据不发明默认规则;不把偶然实现或技术债升格为 Guardrail;不静默修改无关领域;不把 feature 决策塞入 Guardrails。语言默认跟随用户输入。具体命令、模板文件与自检清单细节以实际安装资源为准。