SuperAPI AI 工具集

brain-link-discipline

智能体与模型

查看项目

更新于 10-16 03:47

技能介绍

用途:这是一项由工具链路由 brain 页面交付消息所遵循的报告约定,用于确保每次汇报 brain 页面写入时,链接与该消息同时抵达用户,用户无需再追问“链接在哪”。它是需要在撰写此类消息时遵守的常驻规则,而非工具强制保证的机制。

主要能力:

  • 同消息规则:若提交并推送了 brain 页面,链接必须出现在报告该工作的同一条消息中,包括创建/编辑报告、批量报告、日常对话引用以及转述子智能体结果。
  • 两种输出面采用相反形式:面向用户的聊天消息使用经核实的绝对 URL(或回退链);brain 页面正文内部使用相对 Markdown 链接,如 Alice Example,因为 gbrain 的链接抽取依赖文件系统相对链接来构建 links/backlinks 图,页面间使用绝对 URL 会让该图不可见。frontmatter 的 related: / people: 键保持裸相对路径。link 密集写入后可用 gbrain check-backlinks check 审计,并用 gbrain sync --no-pull 使其可搜索。
  • 机械推导路径:仓库相对路径相对于 git 仓库根(git rev-parse --show-toplevel),而非当前工作目录。不要手工剥离前缀。

必要用法(保持原样): cd "$(dirname <file>)" && git ls-files --full-name "$(basename <file>)" 再组装 https://<host>/<owner>/<repo>/blob/<branch>/<that-exact-path>;host/owner/repo 取自 git remote get-url origin,branch 取自 git rev-parse --abbrev-ref HEAD 或远端默认分支;文件用 /blob/,目录用 /tree/。

顺序为先推送后链接:写/编辑文件;git add <file> && git commit -m "..." && git push;确认推送真正落地(推送输出须显示 ref 更新);在同一条报告提交的消息中输出链接,用可点击链接或裸 URL,不要用反引号代码段。

验证:有托管远端时,发送前确认路径存在。GitHub 私有仓库需要 token,使用 Authorization: token $GITHUB_TOKEN 请求 api.github.com,仅在 200 时发送链接;刚推送且 API 延迟时,推送输出证明 ref 已移动即可,绝不猜测 URL。token 只发给其签发主机:github.com 远端用 api.github.com;其他远端应做未认证验证或跳过验证。存疑时不要发送 token。

回退链(按序):1) 经核实的托管 git 远端 URL;2) 无托管远端时给出仓库相对路径并说明这是 brain 仓库中的本地路径;3) 用 gbrain publish <page-path> 生成自包含本地 HTML 文件(输出行为 Published: <local-path>),可提供作为附件发送,但绝不可当作 URL,敏感内容可用 --password。

子智能体转述改写:子智能体返回本地路径,逐字转述是链接错误的首要来源;转述前须按上述推导与回退链改写每个 brain 页面路径。派生子智能体时应在任务提示中要求其用 git ls-files --full-name 的仓库相对路径报告 brain 页面。

批量列表:每行一个链接,完整 URL 或回退形式,不用反引号。

限制:托管远端链接仅对拥有仓库权限的成员可打开,不是面向外部受众的分享链接,外部分享应改用 gbrain publish 产物。该技能与 publish(负责如何生成可分享 HTML 产物)、_output-rules.md(跨技能规范)、brain-first.md(一行原则)等有明确分工。资料中未提供具体价格、收费或平台信息。