AI agent skill · by @TencentBlueKing

Business Knowledge Workflow

获取陌生业务知识并沉淀为 BK-CI skill 或架构文档时使用，例如阅读 iWiki、结合代码交叉验证、提炼模块边界和重写知识文档。当用户要先理解业务再写文档时优先使用。

Archived 2026-10-23 · Source updated 2026-09-18. Check the original repository for the latest version.

SKILL.md instructions

# 业务知识工作流

## 适用场景

- 需要快速理解一个陌生业务模块
- 需要从 iWiki 或其他文档系统获取背景知识
- 需要把文档描述和实际代码做交叉验证
- 需要把知识沉淀成 skill、架构文档或模块说明

## 不适用场景

- 已经明确知道该修改哪段代码，只是去实现
- 只是压缩已有 skill，不需要重新获取业务知识
- 只是补普通说明，不需要形成复用知识资产

## 快速指导

1. 这个 skill 关注的是“先理解，再验证，最后沉淀”，不是直接改代码。
2. 业务知识获取通常分三段：
   - 文档发现与初筛：`reference/1-document-discovery.md`
   - 代码交叉验证：`reference/2-code-cross-check.md`
   - 沉淀为 skill / 架构文档：`reference/3-skill-distillation.md`
3. 文档内容默认不可信到可以直接复述，必须经过代码或运行链路验证。
4. 沉淀时优先写模块边界、关键对象、主链路和常见坑，而不是复制百科说明。
5. 如果最后产物是 skill，再联动看 `skill-writer`。

## 高信号规则

- 业务文档和代码实现经常不完全一致
- 好的业务知识文档应该能回答“这模块解决什么问题、主链路是什么、改动时先看哪里”
- 沉淀结果要优先服务后续开发和排障，而不是保留原始资料堆积

## 关键陷阱

- 只读文档，不做代码核验
- 把外部资料原样搬运进 skill
- 输出结构没有边界感，导致后续继续膨胀

## 延伸阅读

- 文档发现与初筛：`reference/1-document-discovery.md`
- 代码交叉验证：`reference/2-code-cross-check.md`
- 沉淀为 skill / 架构文档：`reference/3-skill-distillation.md`
- 如果你要写 skill：再看 `skill-writer`