docs: declare subtask compatibility and extension boundaries

[liujuanjuan1984]

背景

本 PR 收敛最近一轮围绕 opencode.sessions.*、subtask/subagent 与 extension 边界的文档/契约调整。

目标不是新增一套 A2A orchestration API，而是把当前已经存在的 upstream 兼容面正式声明清楚，并把 extension 暴露边界写成可引用的仓库原则。

变更内容

1. 显式声明 prompt_async 的 subtask 兼容面

• 在 src/opencode_a2a/contracts/extensions.py 中补齐 opencode.sessions.prompt_async 的 request.parts[] machine-readable contract。
• 明确当前接受的 provider-private part types：text / file / agent / subtask。
• 对 subtask 补齐字段模型：
  • required: prompt / description / agent
  • optional: model / command
• 明确其定位为 passthrough-compatible，执行语义仍属于 upstream OpenCode runtime，而不是新的 A2A orchestration API。

2. 同步 Agent Card / OpenAPI / guide / extension spec

• 更新 Agent Card、OpenAPI example、docs/guide.md、docs/extension-specifications.md。
• 在 guide 中补充 topology 边界说明，明确：
  • A2A Task 是协议层对象
  • opencode.sessions.prompt_async 是 provider-private extension method
  • subtask 是 upstream-compatible 输入形状
  • task tool / subagent 属于 upstream 内部执行链路

3. 落库统一的 extension boundary principles

• 在 docs/guide.md 中新增统一原则，明确：
  • opencode.* 默认作为 provider-private extension 暴露
  • 优先只读发现、稳定兼容面与低风险控制
  • 仅在低歧义只读投影时映射为 A2A core object
  • 不默认把 upstream 内部 runtime 机制提升成 first-class A2A API

4. 回归与 issue 收敛

• 补齐 prompt_async subtask payload 透传回归测试。

• 补齐 Agent Card contract 断言。

• 将一批已确认越界或已完成收敛判断的 issue 补评论并关闭：

• Closes [Priority: Low] [Feature] 暴露文件检索与运行时观测只读能力 #337

• Closes [Priority: Med] [Feature] 暴露 OpenCode subagent/subtask/task tool 扩展能力 #338

• Closes [Priority: Med] [Feature] 设计 A2A 显式子 agent 编排与并行 subtask 契约 #339

• Closes [Priority: Low] [Docs/Architecture] 记录 A2A、subtask、subagent 与 task tool 的拓扑关系 #342

• Closes [Priority: Med] [Feature/Contracts] 显式收敛 opencode.sessions.prompt_async 的 subtask 输入契约 #347

• Closes [Priority: Med] [Feature] 拆分会话管理面：评估 create/delete/update/init 扩展能力 #350

• Closes [Priority: Med] [Feature] 拆分会话精细编辑面：评估 message/part 编辑扩展能力 #388

验证

• ./scripts/doctor.sh
• 结果：522 passed

Issues 关联

• Closes [Priority: Low] [Docs/Contracts] 收敛 OpenCode extension 边界原则并补齐 subtask 兼容声明 #389
• Related [Priority: Med] [Feature] 暴露 MCP 资源与 tool catalog 发现能力 #336
• Related [Priority: Low] [Bug/Ops] 上游 opencode temp .so 文件堆积与部署缓解跟踪 #355
• Related [Priority: Med] [Security] 设计单租户实例内认证与授权模型 #166
• Related [Priority: Low] [Architecture] 设计多单租户实例的接入与编排模型 #167