跳到主要内容

贡献新的 Coding Agent 宿主

宿主支持是一组由证据支撑的能力声明,不是单个 manifest 或会话解析器。 贡献可以只实现宿主确实具备的部分,但必须明确标注部分支持和不可用能力。

完整且规范的流程位于仓库中:

先确定支持边界

能力切片必须明确的决定
原生契约已验证的宿主版本与第一手来源
Shell原生、源码本地、生成产物或不提供
已配置资产可用、部分可用或不可用的作用域
会话证据可用、部分可用或不可用的字段与事件
公共注册只注册实际实现的能力
输出现有 Canvas、HTML、Markdown,或理由充分的新模式
打包公共 npm、运行时 bundle、仅源码或不打包

Shell 不代表已经支持会话证据,解析器也不代表 Skill 能被宿主原生发现。 请在带日期的 spec 中为每项声明设置稳定的验收 id 和证据路径。

贡献流程

  1. 阅读宿主带版本的第一手契约,核对 manifest、路径、配置优先级、 工作区身份、事件和隐私边界。
  2. 保持宿主 Shell 轻量;规范的判断继续归属于共享 Skill、模型、参考资料、 模板和能力自有脚本。
  3. 分别实现已配置资产和会话适配器。使用脱敏 fixture,拒绝其他工作区的 证据,并把缺失字段标为未观测,而不是记为零。
  4. 只在已实现相应能力的注册表中加入宿主 id。遇到不支持的能力时应明确 报错,不能回退到其他宿主。
  5. 按风险验证聚焦测试、完整测试、真实宿主 smoke、打包边界,以及 Windows、macOS、Linux 行为。
  6. 更新适配矩阵,并通过仓库 PR 模板提交 Story/Spec/Test/Risk 证据。

PR 示例

  • PR #6 — Qwen Code 展示了为什么除合成测试外,还需要原生源码核对、环境变量优先级、隐私边界 和大小写不敏感文件系统测试。
  • PR #22 — GitHub Copilot 展示了如何用 spec 把 Shell、资产、会话、注册、文档和证据诚实性拆成 可审查的部分。

PR 会在审查中变化。请把它们当作复盘示例,并以仓库当前指令和规范指南为准。