Lore Query 是一个只读的查询型技能,用于从 Git 提交历史中检索 Lore trailer,把隐藏的决策上下文(约束、被拒方案、指令、测试缺口等)呈现出来。
用途
当用户想了解某个改动背后的决策依据时,可以按 trailer 类型查询提交历史,例如约束条件、被否决的替代方案、指令、已测试/未测试内容、置信度、范围风险、可逆性、关联信息等。
主要能力
该技能可以汇总最近提交中的全部 Lore trailer,也可以只查询指定类型的 trailer,还可以把查询范围限定到某个文件或目录。默认查询最近 20 条提交,用户可以要求更多。查询路径参数支持文件与目录,例如 src/auth/、src/api/handler.ts。该技能为只读,不会修改提交或历史记录。
使用方式
以技能名称调用并可选传参:
lore-query # 汇总最近提交中的所有 Lore trailer lore-query <trailer> # 查询指定 trailer 类型 lore-query <trailer> <path> # 限定到文件或目录
调用语法因 agent CLI 而异:/lore-query(Claude Code)、$lore-query(Codex CLI)、/skill:lore-query(Kimi Code)、技能名称或自然语言(Qwen Code)。也支持自然语言,例如“최근 제약조건 확인해줘”“show me rejected alternatives for src/auth/”等。
Trailer 快捷名称
用户可以用韩文快捷词、英文快捷词或完整 trailer 名称来指代,映射关系如下:제약조건 / constraints 对应 Constraint:;리젝 / rejected 对应 Rejected:;디렉티브 / directive 对应 Directive:;미테스트 / not-tested 对应 Not-tested:;테스트 / tested 对应 Tested:;신뢰도 / confidence 对应 Confidence:;범위위험 / scope-risk 对应 Scope-risk:;가역성 / reversibility 对应 Reversibility:;관련 / related 对应 Related:。任何无法识别的名称会被当作自定义 trailer,按原样查询。
查询方法
查询指定 trailer 时,通过 shell 执行工具(如 Bash)运行:
git log -n 20 --all --grep="^TRAILER_NAME:" --format="%h %s%n%b" -- [PATH]
把 TRAILER_NAME 替换为映射后的 trailer 名称(如 Constraint)。若未指定路径,则省略 -- [PATH]。随后解析输出:对每条提交显示短哈希、摘要行,以及仅匹配的 trailer 行。
汇总模式(未指定 trailer)时运行:
git log -n 20 --format="%h %s%n%b"
在输出中扫描符合已知 Lore trailer 的行(Constraint:、Rejected:、Directive:、Confidence:、Scope-risk:、Reversibility:、Tested:、Not-tested:、Related:),只显示至少包含一个 Lore trailer 的提交。
输出格式
以紧凑列表呈现结果:先显示短提交哈希与摘要,再在下方缩进显示匹配的 trailer 行:
a1b2c3d Prevent silent session drops Constraint: Auth service does not support token introspection Constraint: Must not add latency to non-expired-token paths
f4e5d6c Add rate limiter to external API calls Constraint: Rate limit 100 req/s on external API
若未找到 Lore trailer,应明确说明:“No Lore trailers found in recent commits.”。在汇总模式下,按提交(而非按 trailer 类型)分组输出,以保留决策上下文。
适用场景与限制
适合在代码审查、回溯决策原因、排查“为什么这样做/为什么没选另一方案”时使用。限制包括:仅从现有提交历史中读取信息,若提交未包含 Lore trailer 则无法呈现;默认只查最近 20 条提交,需要更多时由用户指定;具体 agent CLI 的调用语法不统一,需按所用工具调整。