Agent Path
给 Agent 一个明确入口,让它从项目事实走到可解释的工程交付。
Agent 不需要从侧边栏逐页阅读。把这个地址交给它:
https://ssp-ui-registry-staging.sh3.agoralab.co/agent.mdagent.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-engineering;profile: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.json | canonical Profile、规则、关系和 Readiness 投影 |
manifest 中的 skillsBundle | 三个可安装 Skills 的非索引下载地址 |
完成时必须返回
- Project Profile、职责、非职责和边界。
- 选择的工程 Skill,以及为什么匹配。
- compiler 推导的 Readiness 和每一条原因。
- 每个适用 Validation layer 的 Evidence。
- 尚未解决的 findings;不得用“测试通过”把它们抹掉。
给人看的文档不是 Agent 的入口
/llms.txt 是内容索引;/agent.md 才是执行入口。manifest 决定下一步,Graph 决定哪些事实和关系有效。