SuperAPI AI 工具集

hermes-forge

通用与其它

查看项目

更新于 10-15 22:12

技能介绍

用途:定义 Hermes 会话在 Forge 仓库中的读取与回写契约。Forge Kernel 是唯一事实来源,Hermes 只消费状态,不得成为第二来源,也不得通过直接读取原始议题存储、设计文件或内核内部来推断状态。

主要能力:项目状态只能通过两个 CLI 包装器获取,并输出确定性 JSON envelope(assembly 为 deterministic-file-assembly-v1): forge orient --json forge orient --budget 4000 --json forge recap <issue-id> --json 解析 JSON,不要抓取人类可读文本。envelope 含 schema_version(当前 1,未知主版本应拒绝)、kind(orientation / issue_recap / prime)、generated_at、assembly、token_budget、sections[]、sources[]、next_commands[]。每个 section 含 id、title、content、sources、truncated、estimated_tokens。默认预算 2000 估算 token,最小 40,估算近似(chars_per_token 为 4);需更多细节时用 --budget N 明确提高,不要盲目重试。

引用与截断:每个事实须可归因,sources 含 path、source_kind、authority、role;来源冲突时应暴露冲突而非静默选择。截断按 token_budget.truncation_order 确定性执行,被截断段落以字面标记 [truncated deterministically by token budget] 结尾且 truncated 为 true;截断内容视为不完整。

回写路径:证据与决策只通过 Forge CLI 回流: forge comment <id> <body...> forge update <id...> [flags] forge create [title] [flags] 注意 forge audit 仅验证(forge audit verify),不追加证据。写入落在议题存储中成为持久历史,可通过 forge show <id> 查看;但 orient/recap 不回显单条评论,不要假设其会原样再现。

限制:Hermes 不得把 profile 状态、会话记忆或 Hermes 原生产物写入 Forge Kernel 状态(存储、设计/决策文件、议题后端)。PR shepherd 由外部调度器运行 forge shepherd <pr>,执行有界单动作,不合并、不解决评审线程;Hermes 不运行 shepherd,orient 也不携带实时 PR 感知,PR/CI 状态需直接读 PR。使用时机:在 Forge 仓库中开始 Hermes 会话时、处理具体议题前的议题回顾时、需要当前项目状态时。