贡献指南

欢迎贡献代码、文档、语言适配器与插件。完整指南见仓库 CONTRIBUTING.md， 这里给出要点。

开发环境

pip install -e ".[dev]"
python -m pytest                 # 全量测试
python -m flake8 --jobs=1 <files> # 风格检查

仓库统一 LF（.gitattributes 强制）；Windows 下 git add 的 CRLF 规范化提示属正常，可忽略。

新增语言适配器

1. 实现 LanguageAdapter（文件识别 / check_syntax / analyze_tests / 输出解析）， 参考 anti_shortcut/languages/ 下现有实现。
2. 注册到 LANGUAGE_REGISTRY 与 _LANGUAGE_MARKERS（自动检测）。
3. 编写测试并保证覆盖率 ≥ 90%。

新增拦截规则 / 校验器

• 拦截规则签名：rule(kind, target, config, stage, content=None) -> (bool, str) | None
• 校验器：{stage: fn} 映射或带 stage 属性的可调用
• 内置规则包见 anti_shortcut/rules/，自定义规则可通过入口点或 YAML rules: 启用

插件开发

插件可通过入口点注册，python -m anti_shortcut plugin-verify 自动验证。 模板与提交流程见 插件与生态。

发布流程

发布为里程碑驱动：日常改动合入 main 累积、不打 tag；只有用户可感知里程碑或 紧急修复才发版（同日不重复发布）。节奏政策详见 发布流程。

打 tag 时由 git tag 驱动版本号：

git tag vX.Y.Z && git push origin vX.Y.Z

触发 CI + release 工作流（PyPI Trusted Publishing + sigstore 签名 + GitHub Release）； 发版前把累积变化汇总进 更新日志。