SSP Better Stack

Agent Path

给 Agent 一个明确入口,让它从项目事实走到可解释的工程交付。

Agent 不需要从侧边栏逐页阅读。把这个地址交给它:

https://ssp-ui-registry-staging.sh3.agoralab.co/agent.md

agent.md 会让 Agent 读取版本化 manifest 和 Engineering Graph,再按项目事实选择 Skill。所有相对地址都以当前站点为基准。

Agent 实际执行什么

发现入口

读取 /generated/agent-manifest.v0.1.json/generated/engineering-graph.v0.1.json。完成标准:版本、支持的 Profile 和可用 Skills 已确定。

声明 Project Profile

根据职责和部署边界声明 Profile、owns、does not own 和 boundaries。无法确认的职责记录为 finding,不从框架或目录名推断。

计算第一次 Readiness

加载并运行 project-readiness,写入 assessments、Evidence 和 findings,然后执行 compileEngineeringGraph(documents)BLOCKED 时停止实现;有 exceptions 时继续保留在结果中。

路由工程工作

profile:web-application 进入 web-application-engineeringprofile:platform-service 进入 platform-service-engineering

验证并记录 Evidence

Code、Contract、Runtime 分开验证。每份 Evidence 都记录 source version、环境、操作、预期、实际结果、状态、freshness 和 limitations。

重新计算 Readiness

改动完成后再次执行 compiler,一起返回最终状态、原因、Evidence 和未解决 findings。

机器入口

入口用途
/agent.md最短启动说明和完成契约
/generated/agent-manifest.v0.1.json六步路径、Profile 路由和必需输出
/generated/engineering-graph.v0.1.jsoncanonical Profile、规则、关系和 Readiness 投影
manifest 中的 skillsBundle三个可安装 Skills 的非索引下载地址

完成时必须返回

  • Project Profile、职责、非职责和边界。
  • 选择的工程 Skill,以及为什么匹配。
  • compiler 推导的 Readiness 和每一条原因。
  • 每个适用 Validation layer 的 Evidence。
  • 尚未解决的 findings;不得用“测试通过”把它们抹掉。

给人看的文档不是 Agent 的入口

/llms.txt 是内容索引;/agent.md 才是执行入口。manifest 决定下一步,Graph 决定哪些事实和关系有效。

本页目录