SuperAPI AI 工具集

private-context-bootstrap

智能体与模型

查看项目

更新于 10-15 19:57

技能介绍

用途:当智能体需要跨机器可用的私有用户数据,又不能把数据硬编码进公开技能、提示词、日志或仓库时使用本技能。其原则是技能为公开流程定义,私有数据放在公开技能目录之外。

架构分三层:公开技能仓库存放通用技能、schema、假示例、脚本与文档;私有远端数据仓库存放私有 YAML、JSONL 日志、文档清单、标准,可选 PDF,优先文件级加密;密钥管理器存放引导密钥与加密密钥。推荐默认使用私有 Git 仓库保存版本化私有数据,用 age + sops 加密 YAML/JSON,PDF 若入 Git 可用 Git LFS 或加密归档,Bitwarden Secrets Manager 存放私有仓库 URL、age 私钥、可选访问令牌与引导环境变量。不要把未跟踪的本地文件当作唯一真相来源。

支持的环境变量包括 SELF_SOURCE_REMOTE、SELF_SOURCE_HOME、SELF_SOURCE_REPO,以及 AGENTDESK_PROFILE_PATH、AGENTDESK_DOCUMENT_MANIFEST_PATH、AGENTDESK_FIELD_POLICY_PATH、AGENTDESK_APPLICATION_LOG_PATH;缺失时使用默认路径。

引导流程:检查 SELF_SOURCE_HOME 与必需私有文件是否存在;若缺失则从 SELF_SOURCE_REMOTE、密钥管理器或用户处定位远端来源;克隆或同步到 SELF_SOURCE_REPO;加密文件解密到 SELF_SOURCE_HOME;如有远端 PDF 则下载或同步;按 schema 校验必需文件;验证被引用文档存在;校验不通过前拒绝运行工作流。可用时使用 OpportunityOS 仓库中的 scripts/bootstrap-private-context.sh 协调克隆同步、落地、校验与就绪报告。

引导后本地布局包含 shared/personal-profile.yaml(须遵循 bitwarden-personal-profile schema,领域文件夹引用它而非重复身份等信息),以及 job-applications 下的 application-profile.yaml、document-manifest.yaml、field-answer-policy.yaml、application-log.jsonl 和 documents 目录。文件名可不同,智能体应使用引用与清单,而非硬编码文件名。

禁止事项:不得把解密后的私有文件提交到公开仓库;不得未经明确要求打印完整私有档案到终端日志;不得把密钥、个人数据或私有 PDF 粘贴进公开文件;不得假设新机器上文件存在;不得编造缺失的私有值;不得静默覆盖私有数据而不备份。

输出应返回私有 home 路径、私有 repo 路径、档案文件状态、文档清单状态、字段策略状态、文档可用性摘要、校验错误与下一步手动操作。