# AGENTS.md

本仓库提供一个跨 agent 通用的 skill：把 Markdown 改造成 ADHD 友好、可扫读的版本。

## 要改文档时

读 `skill/SKILL.md` 并严格执行其中的工作流。确定性工具层在 `skill/scripts/adhd_md.py`（纯标准库，`python3` 直接跑）。

**铁律：只重排信息，绝不删信息。** 篇幅太长就折叠或移到附录。

`scope=format` 时 `verify` 是硬门禁，不通过必须回退。

## 要改本仓库时

改完必须跑：

```bash
python3 skill/scripts/adhd_md.py selftest        # 34 项，含示例语料回归
python3 scripts/build_standalone.py --check      # dist/ 是否与 skill/ 同步
```

改了 `skill/SKILL.md` 或 `skill/references/{rules,antipatterns,cjk}.md` 之后，重新生成单文件版：

```bash
python3 scripts/build_standalone.py
```

`dist/` 是生成产物，不要手改。

规则的阈值、扣分、轴/档在三处必须一致：`references/rules.md` 的表、`references/rubric.md` 的扣分表、`scripts/adhd_md.py` 的 `DEDUCT` 字典。改一处就要同步另两处。