# 齐衡 QIHENG 商用能力目录

## 产品边界

齐衡商用交付的核心产品是 **21 个 Skills、19 个 SubAgents 及其可执行编排契约**。
命令行运行时负责安全安装、能力裁剪、完整性检查、门禁状态和证据格式，不替代
Skills/SubAgents 本身，也不把通用签名或治理功能包装成独立产品。

- Skill 定义可复用的方法、触发条件、输入、步骤、停止条件和输出。
- SubAgent 承担有边界的角色责任，并通过标准交接向下游交付结论。
- Harness 按项目画像选择适用能力，冻结候选版本并管理失效与重跑。
- 能力目录是安装器、体检、发布门禁和企业资产台账共同使用的单一产品物料表。

机器可读目录位于
[`catalog/capability-catalog.json`](catalog/capability-catalog.json)，其稳定结构由
[`schemas/capability-catalog.schema.json`](schemas/capability-catalog.schema.json)
约束。

目录同时声明 Codex、Claude Code、OpenCode、MiMo Code、BitFun 和通用
Coding Agent 的支持等级、安装范围与 SubAgent 适配格式。`supported` 表示目录
协议和安装路径已作为稳定支持面；`compatible` 表示依赖宿主兼容约定，企业部署
必须锁定宿主版本并在基准仓库回归。

## 能力包

| 能力包 | 自有 Skills | 自有 SubAgents | 安装依赖 | 商用场景 |
| --- | ---: | ---: | --- | --- |
| `foundation` 流程基座 | 6 | 1 | 无 | 总入口、事实采集、项目画像、编排与候选版本门禁 |
| `design` 需求与设计 | 5 | 6 | `foundation` | 规格导入、BDD、规格质量、跨规格和架构评审 |
| `implementation` 实现与修复 | 5 | 7 | `foundation`、`design` | 影响分析、实现检查、修复、代码和测试质量 |
| `assurance` 质量与准入 | 5 | 5 | `foundation` | 持续集成、对抗、证据、一致性和仓库准入 |
| `full` 完整套件 | 21 | 19 | 全部能力包 | 默认企业试点和生产交付 |

安装器会自动解析依赖闭包。例如只请求 `design`，实际安装
`foundation + design`，共 11 个 Skills 和 7 个 SubAgents：

```text
qiheng install --host coding-agent --pack design
```

多个能力包可以重复指定：

```text
qiheng install --host opencode \
  --pack design \
  --pack assurance
```

未提供 `--pack` 时保持向后兼容，安装 `full`。使用以下命令查看当前版本真实
能力清单，不依赖 README 中可能过期的人工表格：

```text
qiheng catalog
qiheng catalog --json
```

## 企业安装与变更控制

每次安装清单额外记录：

- 请求和依赖解析后的能力包；
- 实际安装的 Skill 与 SubAgent 标识；
- 宿主、范围、目标目录、版本和安装时间；
- 每个受管文件的 SHA-256。

从完整套件切换到较小能力包时，只会移除上一份安装清单管理、且内容未被修改的
旧组件。若客户定制了待移除文件，安装器默认拒绝操作；应先迁移定制到独立策略或
适配器，再决定是否使用 `--force`。这使能力裁剪可回滚、可审计，同时避免升级
静默覆盖客户资产。

## 商用验收基线

交付验收至少应覆盖：

1. `qiheng catalog --json` 与采购范围、版本和组件数量一致。
2. `qiheng install --dry-run --json` 的宿主、目录和能力包解析符合部署方案。
3. 安装后 `qiheng doctor --json` 返回健康，且无缺失或修改的受管文件。
4. 21 个 Skill 的名称、触发描述和版本通过结构校验。
5. 19 个 SubAgent 的名称、版本、职责和最小权限与能力目录一致。
6. 基准项目完成画像、设计检查、实现修复、专项质量和仓库准入主路径。
7. 升级、降级能力包、本地修改保护和卸载流程均完成演练。

正式商业合同仍应另行明确许可主体、用户或设备范围、允许的宿主、更新权利、
支持等级、数据边界、责任限制和终止后的卸载义务。本文件定义技术产品范围，
不替代法律协议。