---
name: kd-skill-autoload
description: 技能与规则的加载账本（本轮 skill/规则真由扩展路由；本文为可读索引）
alwaysApply: false
---

# 技能与规则加载说明

**规则正文注入**：扩展 `kingdee-rule-router`（`before_agent_start`）按产品画像 + 本轮需求动态选 1–2 条 `rule://` 注入 system prompt。  
**不要**依赖「先读本文件才能知道加载哪些规则」。

## 双层加载

| 层 | 来源 | 何时 | 内容 |
|---|---|---|---|
| **包级** | `packages/kcode-pi/package.json` 的 `kcode.extensions` | 项目加载 kcode-pi 即激活 | 5 个金蝶扩展：rule-router / header / product-line / metadata / tools |
| **项目级** | `<project>/.kcode/settings.json` 的 `extensions` | 项目 `kcode init` 写入 | Trellis 子代理调度（含 channel / 实施 / 审查 / 研究） |

两层都通过 `before_agent_start` / `turn_start` 等钩子逐次执行；金蝶层处理产品知识，项目层处理工作流编排，互不替代。

## 产品 skill（写代码主路径）

| 场景 | 主 Skill | 软辅助 |
|------|---------|---------|
| Cosmic Java 写代码 | `ok-cosmic` | `kd-cosmic-review`（审查）/ `kd-grill`（澄清） |
| 企业版 C# | `kd-enterprise-csharp` | 同上 |
| IronPython | `kd-enterprise-python-plugin` | 同上 |
| OpenAPI | `kd-enterprise-openapi` | — |
| KSQL / 数据修复 | `kd-ksql` | — |
| 苍穹单测 | `cosmic-unittest` | — |

## 规则

- 动态正文：`kingdee-rule-router` 注入 `rule://…`
- 硬约束：`<project>/.kcode/RULES.md`（每轮 always）
- TTSR：模型按内容触发，注入 `kd-ttsr-*`
- 清单真源：`packages/kcode-pi/src/rules/rule-catalog.ts`

## 跨产品线

- `kd-grill` 前置澄清：所有新交付/二开场景
- 共享手册（`_shared/`）：跨 skill 引用，**非** always 注入

## 反模式

- 不要把 SKILL 整本塞进 system prompt（依赖模型按需 read）
- 不要让产品 skill 改变产品画像（`kcode init` 是唯一写入入口）
- 不要再加永远 always 加载的产品 skill（用 router 注入）
