ln-740-quality-setup

用途

ln-740-quality-setup 是一个 L2 领域协调器（Domain Coordinator），属于 7XX 项目引导分类，父技能为 ln-700-project-bootstrap。它的职责是协调项目代码质量工具链的配置，包括 linter、pre-commit 钩子和测试基础设施。

它适用于以下场景：

ln-720-structure-migrator 完成后由 ln-700 自动委派；
需要手动进行质量设置时，直接携带项目路径调用；
已有项目需要引入质量工具时，以现有配置检测模式运行。

主要能力

该技能本身不直接生成配置文件，也不修改源代码，而是通过检测与委派完成工作：

技术栈检测：根据文件特征识别项目技术栈。
- package.json + tsconfig.json → TypeScript/React，对应 ESLint + Prettier；
- *.csproj 或 *.sln → .NET，对应 editorconfig + Roslyn；
- pyproject.toml 或 requirements.txt → Python，对应 Ruff；
- 检测到多种技术时，为所有检测到的技术配置。
现有配置检查：在委派前检查已有配置，并据此决定创建、扩展还是跳过。
- 未找到配置 → 从模板创建；
- 存在但不完整 → 扩展以匹配模板；
- 存在且匹配模板 → 跳过并告知用户。
- 对 Python 会依据 ln-741 的完整性检查表（7 个方面：Ruff 规则、per-file-ignores、高级设置、MyPy strict、高级工具、lint 脚本、editorconfig）评估，若任一不完整则委派 ln-741 进行扩展而非替换。
并行委派：将各质量方面委派给专门的工作技能，这些工作技能可并行运行。
- ln-741-linter-configurator：ESLint/Prettier（TypeScript）、editorconfig/Roslyn（.NET）、Ruff（Python）；
- ln-742-precommit-setup：Husky + lint-staged（Node.js）、pre-commit 框架（Python）、commitlint；
- ln-743-test-infrastructure：Vitest（TypeScript）、xUnit（.NET）、pytest（Python）。
验证：所有工作技能完成后，验证质量流水线是否可用，包括 lint、format、类型检查、导入边界、未使用依赖、死代码、漏洞扫描、统一脚本、测试以及钩子触发等检查。验证失败时记录具体失败项、建议修复或重新运行特定工作技能，未通过验证不得标记为完成。

使用方式

该技能通过 Skill 工具进行委派调用，调用格式为：

Skill(skill: "ln-741-linter-configurator", args: "{projectPath}")
Skill(skill: "ln-742-precommit-setup", args: "{projectPath}")
Skill(skill: "ln-743-test-infrastructure", args: "{projectPath}")

在 Claude 中需按所示方式调用 Skill 工具；在 Codex 中若没有 Skill 工具，则需在可用技能中定位对应技能、读取其 SKILL.md、将 args 视为 $ARGUMENTS 并执行该技能工作流，然后返回结果。不得内联工作技能逻辑，也不得在未执行目标技能的情况下标记其完成。

工作流分为五个阶段：

技术栈检测；
现有配置检查；
并行委派；
验证；
元分析（可选，仅在用户要求运行后元分析或协议格式的运行反思时，加载 references/meta_analysis_protocol.md）。

适用场景

新项目引导流程中，在结构迁移完成后自动配置质量工具链；
已有项目需要引入 linter、pre-commit 钩子和测试基础设施；
需要统一多种技术栈（TypeScript/React、.NET、Python）的质量配置。

限制

不直接生成配置文件（由工作技能完成）；
不修改源代码；
不能独立运行，需要先完成 ln-720 结构迁移；
未经明确确认，不得覆盖用户现有配置；
必须在技术栈检测之后才能调用工作技能；
验证阶段为强制要求，工具未成功运行前质量设置不算完成；
同时配置 ESLint 和 Prettier 时，eslint-config-prettier 为必需项。

参考文件

stack_detection.md：详细检测规则；
verification_checklist.md：完整验证清单。

错误处理

未检测到技术栈（空项目）：询问用户预期技术栈；
工作技能失败（缺少依赖）：安装前置依赖后重试；
验证失败（配置错误）：检查具体工具输出并修复；
钩子不工作（Git 未初始化）：先运行 git init。

版本：3.0.0；最后更新：2026-03-18。