用途:当协调者或任一代理需要回答“该状态应放在哪里”“谁有权写这个文件”,或在写入 .squad/decisions.md、审查代理是否违反仅追加规则、解释 Squad 文件布局、裁决文件冲突时加载此项技能。squad.agent.md 中的简短摘要仅用于路由,本技能才是完整参考。状态后端说明:标注为“派生/仅追加”的文件属于可变状态,代理通过运行时状态工具(squad_state_read、squad_state_write、squad_state_append、squad_state_delete、squad_state_list)访问;运行时决定这些文件存储在磁盘、git 原生状态还是外部提供者。标注为“权威”的文件是静态配置,无论后端如何都位于磁盘。文件层级要点:.github/agents/squad.agent.md 为权威治理文件,由仓库维护者(人类)写入,Squad(协调者)读取;.squad/decisions.md 为权威决策账本,仅协调者追加,所有代理可读;.squad/team.md 为权威名册,协调者写入;.squad/routing.md 为权威路由规则,协调者读写;.squad/ceremonies.md 为权威仪式配置,协调者可写,协调者与 Facilitator 可读;.squad/casting/policy.json 与 registry.json 为权威选角配置与名称注册表;.squad/casting/history.json 为派生/仅追加历史;.squad/agents/{name}/charter.md 为权威代理身份,创建时由协调者写入,代理不可自改;history.md 为派生/仅追加的个人学习记录,仅所属代理追加、仅所属代理读取;history-archive.md 由 Scribe 追加,所属代理只读;.squad/orchestration-log/、.squad/log/ 为派生/仅追加日志,Scribe 写入,所有代理只读;.squad/templates/ 为参考格式指南;.squad/rai/policy.md 与 .squad/fact-checker/policy.md 为权威策略文件,由协调者初始化,相关代理可提出更新;对应的 audit-trail.md 为派生/仅追加审计日志;.squad/plugins/marketplaces.json 为权威插件配置,由 Squad CLI 写入。规则:squad.agent.md 与其他文件冲突时以其为准;仅追加文件不得回溯修改含义,更正需新条目引用旧条目;代理只能写其“可写”列中的文件,违规属契约缺陷,运行时后端会拒绝非本地后端上的写入;非协调者代理可提出决策,但只有协调者将已接受的决策记入 .squad/decisions.md。
coordinator-source-of-truth
智能体与模型
更新于 10-16 09:55