aif-quality-setup 是 lee-to/ai-factory 中用于本地质量检查与 Git 钩子配置的技能，地址为 https://www.skills.sh/lee-to/ai-factory/aif-quality-setup。其定位是：在搭建或改进本地质量工具链时，先检测项目实际技术栈，再提议并配置合适的代码检查与 Git 钩子。
一、用途与工作流程 技能按步骤推进。Step 0 解析上下文与范围：读取项目内的 .ai-factory/config.yaml（若存在）及其指向的说明、架构、规则文件，解析相对路径与仓库根，尊重 AGENTS/CLAUDE 等指令，并按“区域规则 > base > rules_file”的优先级处理；缺失的 AI Factory 上下文属正常情况，不可读的强制指令或含糊配置会暂停相关写入。随后依据发现的事实确认技术栈，并区分 UI 语言与产物语言。 调用参数支持三种模式：audit（默认，审计当前项目并给出建议）、setup（提议、选择后配置）、enhance（补充现有配置），audit 与 enhance 均可带显式路径（如 "/aif-quality-setup audit "../api" "../worker""），显式路径只增加读取范围，不授予改动所有仓库的权限；未知参数、缺失路径和冲突模式会在工作前被拒绝。
二、主要能力 支持已有和新建的 JS/TS、PHP、Python、Rust 项目，混合 monorepo 与多仓库；对其他技术栈会调研原生工具和当前官方文档，未解决的兼容性会明确说明。Step 1 以只读方式盘点根目录、仓库、组件、清单、运行时约束、环境、框架、命令、工具配置、钩子与 CI，不安装、不执行项目脚本、不修改文件。Step 2 先读推荐规则，再说明现有覆盖与缺口、推荐方案及有意义的备选方案，理由基于发现的实际情况，优先扩展现有工具，不顺便升级运行时。Step 3 通过可用的提问工具或纯文本编号选项确认仓库/组件、检查项、命令、钩子管理器与事件、严格程度和自动修复模式；默认自动修复模式为 check，fix-and-stop、fix-and-stage 仅在运行器有文档支持时作为候选，需通过暂存内容/未暂存块保留检查后才能启用。
三、应用与验证 Step 4 对 setup/enhance 先阅读 setup 与 hooks 说明再写入或安装，只应用选中的改动，尊重现有脚本、锁文件、钩子顺序、Git 路径与工作区脏状态，重跑不会重复工作；CI 与构建文件改动分别交给 /aif-ci 和 /aif-build-automation。Step 5 只运行选中且授权的检查，按仓库/组件、命令与 CWD 报告 configured/verified/not_run/failed，缺少工具和配置错误会显式呈现，失败时报告部分改动与后续步骤。技能只拥有选中的原生质量配置、相关清单/脚本条目、开发依赖锁文件变更、受跟踪的钩子配置与必要的本地钩子安装产物；不修改全局 Git 配置，不做笼统暂存/重置/清理，不自动提交推送，不迁移无关工具。涉及安装、执行、写入等运行时能力需由已暴露且被允许的工具提供，工具声明本身不产生运行时能力。
四、适用场景与限制 适用于需要为项目配置本地代码检查、静态分析或 Git 钩子的开发者，以及多仓库/混合语言项目。限制包括：audit 在给出建议后即结束，应用建议需另行请求 setup/enhance；非交互或后台运行中未决的材料性选择需返回调用方；未装提问工具时只能以纯文本方式提问并暂停相关写入；对其他技术栈的兼容性可能无法确定。