SuperAPI AI 工具集

backend-resolution

编程与开发

查看项目

更新于 10-15 22:40

技能介绍

用途:确定一个 dh 项目配置的唯一 backlog 后端,并在调用后端相关工具前按该结果行动。工作项、梳理、计划、任务状态、产物清单与内容都归属于这一个后端。

解析顺序(首个命中生效):1) 环境变量 BACKLOG_BACKEND 非空时;2) .dh/config.yaml 中的 backlog.backend;3) 同一文件中的 backend.name(全局回退,仅在上面的子系统键缺失时检查,按配置搜索顺序逐文件应用,较近文件的全局键优先于较远文件的子系统键);4) 存在 .beads/dh-backend 标记文件时选择 Beads;5) 否则为 github。实现位于 backlog_core/backend_protocol.py 的 create_backend(),委托给 dh_config.py 的 DHConfig.get_backend(subsystem="backlog"),_auto_detect_beads() 实现第 4 步。

不要自行推导:不要编写自己的检测片段。已知两种错误做法会静默返回错误答案——只读环境变量后落到默认值,从不查 .dh/config.yaml;以及只检测 .beads 目录而非标记文件(目录本身不足以表明使用 Beads 后端)。

按结果行动:调用后端专属操作前,查阅 docs/backend-providers.md 的能力表与 supports_* 标志,不要靠试探或捕获异常判断。后端不支持某步骤时,应说明并停止该步骤,不要用文件系统读取、缓存读取或第二个后端替代。能力缺失时,在读者会查看结果的位置写明“不适用——后端不支持此能力”。报告结果时,若后端身份会影响读者行动,应指明是哪个后端。

标识符:issue_number 不总是整数,在 beads 上是形如 bd-a3f8 的字符串;MCP 层透明接受两种类型,仅在自行解析、格式化、排序或模式匹配时需注意。

限制:资料未提供安装命令、收费、平台与效果信息。