用途：扫描目标 GitHub 仓库的贡献约定，把推断出的规范写入本地指令文件，便于在加入、fork 或克隆仓库时快速了解其贡献方式。
主要能力：读取 gh repo view 获取 fork、父仓库与默认分支元数据；读取本地贡献文档及 GitHub issue / pull-request 模板；读取近期 issue 与已合并 PR，观察标题、基础分支与工作分支模式。对 fork 而言，父仓库是 issue 与 PR 的目标；普通克隆则以当前仓库为目标。
使用方式：选择当前运行时，除非用户明确要求，否则不要同时写两个文件。 node .codex/skills/convention/scripts/convention.mjs scan --flavor codex node .claude/skills/convention/scripts/convention.mjs scan --flavor claude 目标不是当前目录时使用 --cwd <repository>。
输出：Claude 写入 CLAUDE.local.md，Codex 写入 AGENTS.local.md，使用专用标记 contribution-convention:START 与 contribution-convention:END。所选本地文件会被加入 .gitignore。重新扫描时只替换专用块，保留块外全部文本。
限制：仅支持 GitHub v1，gh repo view 不可用时以明确错误停止。只运行 GitHub 读取命令，绝不创建、编辑、关闭、重开或标记 issue 与 PR。绝不更改远程、分支、索引或提交。推断出的模式应标注为观察到的约定，而非权威规则；贡献文档与模板的证据强度高于近期历史。报告需说明仓库类型、贡献目标、基础分支、输出文件与证据来源；文档缺失或历史为空时应指出，而不是编造约定。