贡献新的 Coding Agent 宿主
宿主支持是一组由证据支撑的能力声明,不是单个 manifest 或会话解析器。 贡献可以只实现宿主确实具备的部分,但必须明确标注部分支持和不可用能力。
完整且规范的流程位于仓库中:
先确定支持边界
| 能力切片 | 必须明确的决定 |
|---|---|
| 原生契约 | 已验证的宿主版本与第一手来源 |
| Shell | 原生、源码本地、生成产物或不提供 |
| 已配置资产 | 可用、部分可用或不可用的作用域 |
| 会话证据 | 可用、部分可用或不可用的字段与事件 |
| 公共注册 | 只注册实际实现的能力 |
| 输出 | 现有 Canvas、HTML、Markdown,或理由充分的新模式 |
| 打包 | 公共 npm、运行时 bundle、仅源码或不打包 |
Shell 不代表已经支持会话证据,解析器也不代表 Skill 能被宿主原生发现。 请在带日期的 spec 中为每项声明设置稳定的验收 id 和证据路径。
贡献流程
- 阅读宿主带版本的第一手契约,核对 manifest、路径、配置优先级、 工作区身份、事件和隐私边界。
- 保持宿主 Shell 轻量;规范的判断继续归属于共享 Skill、模型、参考资料、 模板和能力自有脚本。
- 分别实现已配置资产和会话适配器。使用脱敏 fixture,拒绝其他工作区的 证据,并把缺失字段标为未观测,而不是记为零。
- 只在已实现相应能力的注册表中加入宿主 id。遇到不支持的能力时应明确 报错,不能回退到其他宿主。
- 按风险验证聚焦测试、完整测试、真实宿主 smoke、打包边界,以及 Windows、macOS、Linux 行为。
- 更新适配矩阵,并通过仓库 PR 模板提交 Story/Spec/Test/Risk 证据。
PR 示例
- PR #6 — Qwen Code 展示了为什么除合成测试外,还需要原生源码核对、环境变量优先级、隐私边界 和大小写不敏感文件系统测试。
- PR #22 — GitHub Copilot 展示了如何用 spec 把 Shell、资产、会话、注册、文档和证据诚实性拆成 可审查的部分。
PR 会在审查中变化。请把它们当作复盘示例,并以仓库当前指令和规范指南为准。