SuperAPI AI 工具集

query

智能体与模型

查看项目

更新于 10-15 23:46

技能介绍

用途:Query 是 Lode 决策回放索引的查询技能,从本地决策记忆中回答针对项目历史的定向问题,例如某条路径为何被选中、哪些替代方案被否决或推迟、哪些未决问题应重新考虑、某决策带来哪些下游影响。当前任务涉及既有决策、架构边界、被否决选项、长期风险或产品取舍时使用;会话开始时的定位用 recall,具体追问用 query。默认范围为项目内。

主要能力:提供 why、alternatives、revisit、impact 四种模式,以及自由模式 free。自由模式适合不明确对应前四种的自然语言问题(如状态检查、是否讨论过某主题);代理按 why → revisit → impact 顺序依次尝试,返回第一个 answerable=true 的结果,不把 alternatives 放入该回退链。全部返回 answerable=false 时,说明记录证据不足,建议用户澄清后用 /lode:capture 补充。

使用方式:运行 python <this-skill>/scripts/decision_graph.py query "<question>" --cwd "$PWD" --mode why --limit 5。按问题替换 --mode alternatives、--mode revisit、--mode impact 或走自由模式回退顺序;用户给出项目 slug 时传 --slug <slug>,提供 vault 路径时传 --vault <path>。随后读取 JSON 证据包,并仅依据证据包作答。输出应包含:answerable=true 时的直接回答、匹配的决策节点 id 与来源时间戳、matched_terms、evidence_strength、answerability_reason,每条引用决策的 source_entry_refs,必要时列出被否决的替代方案与未决问题,节点为推断时给出 confidence 与 inference_notes,以及 suggested_docs 中的仓库本地文档建议。

限制与证据规则:原始条目是唯一事实来源,{vault}/raw/decisions/{project-slug}.json 是派生检索索引;无已保存索引时助手可从原始条目在内存中重建,但该技能不写入新记忆,也不写任何文件。不得用 git 历史、外部文档或模型假设填补缺失的决策证据。confidence=explicit 视为直接记录的原始证据,confidence=inferred 仅作导航线索而非已证事实;evidence_strength=weak 时即使 answerable=true 也应保留不确定措辞或索取更多证据。引用决策必须带 source_entry_refs,边与支撑节点只是上下文扩展,不构成独立证明。answerable=false 时应说明记录证据不足,附 missing_evidence,并建议用户澄清后用 /lode:capture 记录。读取来源包括 {vault}/raw/decisions/{project-slug}.json、作为重建回退的 {vault}/raw/weeks/{YYYY-WNN}/{project-slug}.json,以及可选导航元数据 {vault}/raw/artifacts/{project-slug}.json;资料未提供具体收费、价格或平台信息。