给开源仓库提高质量 Issue 的实践：以文档坏链排查为例（1028-acct2）

一、为什么要提"真" Issue

不少成长任务会奖励给开源仓库提 Issue，但如果只是复制粘贴同一段话去刷分，维护者需要花大量时间甄别，反而破坏社区氛围。更好的做法是：每次花几分钟找一个真实、可复现的小问题。

二、从文档入手找问题

文档类问题最适合新手：门槛低、易复现、修起来也快。以本次为例，我检查了仓库的目录文件 SUMMARY.md，逐条核对目录里引用的相对路径是否真实存在。

1. 读取 SUMMARY.md，提取所有本地相对链接；
2. 按相对路径拼接出目标文件路径，逐一请求资源接口确认是否存在；
3. 对返回 404 的条目，记录原文件和目标路径。

三、写清楚 Issue

一个合格的 Issue 应包含：问题描述、复现步骤（带日期与分支）、期望结果、环境信息。例如某处目录链接指向不存在的文件，应说明"哪个文件里的哪个链接、解析出的实际路径、返回 404、建议改成什么路径"。

四、避免重复

提交前先搜索已有 Issue，确认没有人报过同样的问题；同一份文件里的多个坏链可以合并成一个 Issue，不要拆成一堆碎片。

五、小结

提 Issue 的价值在于"帮项目变好"，积分只是附带。用真实问题、清晰复现、可执行建议，既完成了任务，也真正帮助了维护者。