用途:为已检测出的技术栈安装完整的自动化质量反馈层,覆盖 linter、formatter、类型检查器、静态分析器、依赖漏洞扫描、架构依赖边界检查、pre-commit 钩子与 CI 质量门禁,目标是不让未受检查的代码合入 main,且本地与 CI 检查零差异。
主要能力:先读取 plan.md、架构报告、技术栈报告,将结果写入 .ai/workspace/linter-setup/stack-profile.md;无法确定关键字段时直接询问用户。随后按工具类别用查询模板调研生态,对前 3 名按社区采用度、最近发布、CI 集成难度、配置复杂度评分,以直接询问方式向用户呈现前 2–3 个选项供选择,协议中不硬编码具体工具名。配置阶段采用最严格合理默认值,仅在用户明确批准时放宽,需逐条说明各规则拦截的问题;始终生成与栈无关的 .editorconfig,并把工具缓存目录加入 .gitignore。pre-commit 钩子按 formatter→linter→type-check 顺序、仅对暂存文件运行,需控制在 30 秒内,超时则迁移慢检查到 CI。CI 门禁镜像钩子顺序:格式化检查、lint、类型、静态分析、依赖扫描,覆盖率仅作诊断不用于失败构建。完成后用故意制造的违规验证钩子确实能阻断。
适用场景:新项目脚手架之后、搭建更完整工程护栏之前;需要统一团队代码质量工具时。
限制:所有步骤须按声明顺序执行并记录证据,跳过、重排或合并需用户事先批准;任务跟踪工具不可用时需建立等价计划跟踪器;若某步骤或工具在当前环境无法运行,应停止并先询问用户;强制的规则与命令、分类边界由外部流程定义,本文档按原样保留。资料未提供具体工具名称、版本、价格及安装命令细节。