用途:在仓库中搭建或配置代码质量工具(格式化器、Linter、类型检查器、依赖扫描器),并可为含 Web UI 的项目配置视觉无障碍自动化检查。
主要能力: 格式化自动化分三层:编辑器/智能体在写入模式下即时格式化;pre-commit 钩子对改动文件写入模式格式化并暂存;CI 以只检查模式运行格式化检查,发现漂移即失败,不写入、不提交、不改动仓库。 GitHub Actions 运行时版本迁移:在运行器默认版本较旧期间,可在顶层 workflow env 设置 FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true";新版本成为默认后,在同一变更集中移除该变量。
按语言工具链: JavaScript/TypeScript(含 React/Next):ESLint + Prettier,需维护 .prettierignore 排除生成/构建产物与合成文件(如 dist/、构建产物、由 compose-agentsmd 生成的 AGENTS.md);tsc 严格模式;osv-scanner,不支持时用包管理器审计。 Python:Ruff、Pyright、pip-audit。 Go:gofmt、golangci-lint(含 staticcheck)、govulncheck。 Rust:cargo fmt、cargo clippy(警告视为错误)、cargo audit。 Java:Spotless + google-java-format、Checkstyle + SpotBugs、OWASP Dependency-Check。 Kotlin:Spotless + ktlint、detekt,CI 启用警告即错误。 C#:dotnet format(CI 用 verify-no-changes)、.NET 分析器、可空引用类型、dotnet list package --vulnerable。 C++:clang-format、clang-tidy,CI 运行 ASan/UBSan。 PowerShell:PSScriptAnalyzer(Invoke-Formatter + Invoke-ScriptAnalyzer),Set-StrictMode -Version Latest,测试用 Pester,发现视为错误。 Shell:shfmt、shellcheck。Dockerfile:hadolint。Terraform:terraform fmt -check、terraform validate、tflint、trivy config。YAML:yamllint。Markdown:markdownlint。
视觉无障碍:仅适用于含 Web UI 的项目,需纳入仓库标准验证命令与 CI;用路由发现(sitemap、生成的路由列表或框架路由清单)自动覆盖新页面;支持主题切换时校验明暗两套主题;交互元素至少校验默认、悬停、聚焦状态;对所有呈现边界的可见元素做非文本边界对比度检查;用宽泛 DOM 发现,仅做最小技术排除;违规即 CI 失败,临时排除须范围窄、有记录并及时移除。
安全基线:合并前要求生态对应的依赖漏洞扫描(SCA),不可用时报告限制并取得用户明确批准;启用 GitHub 密钥扫描并修复发现,不得提交密钥,不可用时加仓库本地扫描器;对支持语言启用 CodeQL,不可用时用该生态最佳替代。
限制:资料未提供安装命令、具体配置代码、收费与平台信息。