Access Guide
状态：Active / 接入规则与回写协议 最后更新：2026-05-15 用途：定义所有接入者（人类、Agent、Controller、外部协作者）如何在本仓库中工作
按任务意图选择阅读文档，请用 CONTEXT-MAP.md。查找文档状态和角色，请用 INDEX.md。
1. 事实源与接入原则
仓库内 .md 文件是事实源。门户、搜索、llms.txt、docs-manifest.json 只是呈现和路由。controllers/ 和 packets/ 是恢复状态和协同记录——稳定结论必须回写到正式文档。
接入规则：
- 按任务意图先选最小上下文（3–5 份文件），不全仓库扫描
- 每轮输出 evidence / gap / proposal / risk / next-read
- 工程实现细节不写成生态事实；参考项目不直接变成需求
- 正式事实源只能通过明确的文档更新、sync 或 escalation 修改
2. 按角色选择工作方式
| 接入者 | 工作方式 | 输出要求 |
|---|---|---|
| 人类参与者 | 通过门户、README、Context Map 和目标文档理解上下文 | 判断、问题、决策、评审意见 |
| 个人域 Agent | 按任务意图读取 3–5 份文件，完成后停止 | evidence、gap、proposal、risk、next-read |
| 团队域 Agent | 基于 packet、handoff 或任务契约执行 | 执行证据、验证结果、回写候选 |
| Program Controller | 维护某个产品 / 系统的上下文分发、工程衔接和回写闭环 | alignment packet、sync、escalation、正式文档更新建议 |
| 外部协作者 | 从公开入口和指定材料受限接入 | 指定范围内的分析、建议或实现证据 |
3. 低上下文读取协议
每轮读取需标明边界：
| 字段 | 内容 |
|---|---|
| 本轮目标 | 一句话说明要判断或完成什么 |
| 允许读取 | 3–5 份文件，必要时说明顺序 |
| 暂不读取 | 明确哪些目录 / 项目 / 工程仓库不进入本轮 |
| 输出格式 | evidence / gap / proposal / risk / next-read |
| 工程权限 | 是否允许进入工程仓库 |
| 文档权限 | 是否允许提出正式文档变更 |
| 协同判断 | 是否需要 sync / escalation / handoff packet |
4. Agent 指令模板
你正在接入 Labs-FinTecAI-Gov。
任务对象：<生态 / 产品 / 系统 / 来源材料 / 参考材料 / 评测 / packet / Controller>
本轮目标：<一句话目标>
先读取：
- <文件 1>
- <文件 2>
- <文件 3>
读取边界：
- 不读取完整仓库或完整工程仓库
- 不扩大到未列出的产品线
- 不把工程事实写成生态事实
- 不把 packet / checkpoint / 参考材料 / 评测报告当成产品事实源
输出：
- 关键结论 + 证据引用
- gap / proposal / risk
- 是否需要 sync / escalation
- 下一批建议读取文件
完成后停止。
5. 回写路由
| 结论类型 | 写回位置 |
|---|---|
| 生态结构、风险边界、readiness | baseline/、contexts/ecosystem/CONTEXT.md、registry/project-registry.md |
| 项目定位、产品定义、MVP、对象和接口 | projects/*（由对应项目 Controller 承接） |
| 材料接入、治理规则、变更范围、更新闭环 | governance/ |
| 跨项目信号、handoff、阶段结论 | packets/sync/ |
| 需要生态层裁决 | packets/escalation/ |
| Controller 恢复状态 | controllers/ |
| 来源、参考、竞品、评测证据 | source/、references/、evaluation/ |
6. 不作为常规入口的内容
portal/、src/、static/、.docusaurus/、build/、agent-context/graphiti/、.github/、package.json 等属于构建、发布或机器路由，不是阅读入口。