ask-exemplar

ask-exemplar

在选择或评判目标之前，先查阅当前外部证据。每次运行都是一次咨询：以来源为依据，且不会更改目标。独立运行会返回决策简报；嵌入式评估只会返回优先修复项。

工作流

1. 确定目标。 判断目标是未完成还是已完成。未完成的目标使用指导，已完成的目标使用评估。只有当尚未解决的歧义会改变研究方向时，才提出一个问题。确定领域、强制要求和用户的硬性约束。对于指导，确定各个选项。对于评估，阅读已完成的产物或差异，以及项目背景。
2. 研究外部证据。 每次调用时都搜索或重新验证当前在线来源。优先选择一手来源，例如正式标准、官方文档、已发布的作品、直接测量结果和范例发布的原则。将标准结论归类为 formal requirement、dominant convention、contested practice 或 no Standard。只有在证据缺口导致无法归类时，才使用 undetermined。选取一到两个范例，考量其证据、相关性和可迁移性。个人、组织、产品或方法都可以作为范例，但声誉本身不构成证据。将支持来源记录为已验证来源集。
3. 推导可观察的标准。 将有证据支持的内容转化为可用于检查目标的标准。区分强制要求、惯例和范例特征。每项重要主张旁都附上来源链接。对于代码、UI、文档、API、CLI、范围、可靠性、测试、短篇写作或 Agent 技能目标，请阅读 REFERENCE.md。任何标准都不得依赖对名人建议的模拟。
4. 应用标准。 排除违反强制要求或用户硬性约束的选项，然后依据惯例和范例对可行选项进行排序。说明每项重要结论的权衡和置信度。违反强制要求或硬性约束的修复方案不算修复；应指出其中的冲突。
   • 在指导中，比较各选项并默认选择一个。只有当某个尚未解决的选择会改变首选方案时，建议才应附带条件。
   • 在评估中，依据每项标准检查已完成的目标，为每处差距提出一项具体修复，并按影响力对去重后的优先修复项排序。同时检查是否有维护中的社区工具、库、模式或惯用写法能够替代目标中的自定义实现；有支持的替代方案可列为优先修复项候选，其依赖和维护成本则属于权衡因素。
5. 返回决策简报。 除非用户要求提供文件，否则请在对话中使用下方格式。对于嵌入式评估，则只返回优先修复项。

证据规则

• 仅在无法获取一手证据时，将可信的二手来源用作临时背景信息。标注证据缺口，并降低置信度。
• 无法在线访问时，报告证据缺口，不对当前标准或有最充分依据的范例作出任何断言。仅将可用的本地来源用作临时背景信息，将置信度设为 low，并说明原因。
• 只有证据能够证明某个范例是全球最佳时，才称其为全球最佳。否则，应称其为此目标下有最充分依据的范例，并说明覆盖范围限制。
• 当前证据足以判定标准结论并支持一两个相关范例时，停止研究。说明重要限制，不要暗示搜索已穷尽。
• 仅在当前对话或父工作流中复用已验证来源集，且仅限领域和标准结论未发生变化的情况。复用前重新核查时效性声明。
• 使用 high、medium 或 low 作为置信度，并简要说明原因。置信度不得使用数值评分。

决策简报

## Decision Brief

### Standard Finding
<classification, evidence, and Confidence>

### Exemplars
<one or two selections, why each fits, evidence, and Confidence>

### Observable criteria
<criteria and comparison with the Target>

### Recommendation
<preferred Feasible Option, tradeoffs, and Confidence>

### Evidence limits
<Evidence Gaps and Coverage Limits, or "None material">

对于评估，将标准部分制作成包含 criterion、bar、current 和 fix 列的表格；在建议部分指出最具杠杆效应的改进；并以 ### Top Fixes 部分结束简报。每个 Top Fixes 条目都应包含发现、具体修复方案、置信度和权衡。REFERENCE.md 中有一份填写好的示例。

嵌入式评估

当父工作流要求进行嵌入式评估时，仅提供报告，并且只返回编号的 Top Fixes 列表。每个条目都应包含发现、具体修复方案、置信度和权衡。不要编辑文件、提交或推送；所有更改均由父工作流控制。如果没有实质性改进项，则只返回 No Top Fixes.。

自检

只有当评估指出正确性、简化和可维护性审核人员在结构上无法发现的问题——例如缺少标准工具或模式，或未达到外部标准——才有用。只有当指导流程的评估标准来自引用的证据，而不是复述用户已知内容时，该流程才有用。如果未达到此标准，请返回第 2 步，研究该领域的一手来源，或者说明不存在适用的外部标准。