用途:在编写非平凡任务的代码之前,检查工作区中是否存在问题规格(problem spec)或约定文档。这类文档通常包含测试所断言的确切格式规则、边界情况和约束,阅读成本低但收益高。
主要能力:按优先级查找文档,依次为 .docs/instructions.md 与 .docs/instructions.append.md(exercism 风格的问题规格);仓库根目录的 AGENTS.md / CLAUDE.md(面向智能体的指令);当前目录的 README.md、SPEC.md / SPECIFICATION.md 以及 docs/.md。可用 find 发现这些文件(.md、.docs/*.md、AGENTS.md),再读取相关文件。
使用方式:在任务开始时执行一次即可,不必每轮都做。示例流程:先 find(".docs/*.md") 找到 instructions.md,再 read(".docs/instructions.md"),可能发现诸如“输出必须排序”之类的测试约束,从而省去多次调试迭代。
适用场景:开始实现任务、修复测试或任何代码改动之前。若规格能澄清某个失败测试,单次阅读即可节省大量调试。
限制:纯只读问题可跳过,仅在即将修改代码时才投入读取;但即将写代码时绝不可跳过此步骤,因为规格常含测试约束。