business-knowledge-workflow
A structured method to understand complex business logic and convert it into documentation or code assets.
Install
mkdir -p .claude/skills/business-knowledge-workflow && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/3013" && unzip -o skill.zip -d .claude/skills/business-knowledge-workflow && rm skill.zipInstalls to .claude/skills/business-knowledge-workflow
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
获取陌生业务知识并沉淀为 BK-CI skill 或架构文档时使用，例如阅读 iWiki、结合代码交叉验证、提炼模块边界和重写知识文档。当用户要先理解业务再写文档时优先使用。Key capabilities
- →Understand unfamiliar business modules
- →Acquire background knowledge from iWiki or other documentation systems
- →Cross-verify documentation descriptions with actual code
- →Distill knowledge into a skill or architectural document
- →Refine module boundaries, key objects, and main workflows
- →Identify common pitfalls for future development and troubleshooting
How it works
This skill guides users through discovering and pre-screening documents, cross-verifying information with code, and then distilling the validated knowledge into a structured format.
Inputs & outputs
When to use business-knowledge-workflow
- →Document a complex or unfamiliar business module
- →Verify business logic documentation against actual code
- →Convert internal business knowledge into a formal skill
About this skill
业务知识工作流
适用场景
- 需要快速理解一个陌生业务模块
- 需要从 iWiki 或其他文档系统获取背景知识
- 需要把文档描述和实际代码做交叉验证
- 需要把知识沉淀成 skill、架构文档或模块说明
不适用场景
- 已经明确知道该修改哪段代码，只是去实现
- 只是压缩已有 skill，不需要重新获取业务知识
- 只是补普通说明，不需要形成复用知识资产
快速指导
- 这个 skill 关注的是“先理解，再验证，最后沉淀”，不是直接改代码。
- 业务知识获取通常分三段：
- 文档发现与初筛：
reference/1-document-discovery.md - 代码交叉验证：
reference/2-code-cross-check.md - 沉淀为 skill / 架构文档：
reference/3-skill-distillation.md
- 文档发现与初筛：
- 文档内容默认不可信到可以直接复述，必须经过代码或运行链路验证。
- 沉淀时优先写模块边界、关键对象、主链路和常见坑，而不是复制百科说明。
- 如果最后产物是 skill，再联动看
skill-writer。
高信号规则
- 业务文档和代码实现经常不完全一致
- 好的业务知识文档应该能回答“这模块解决什么问题、主链路是什么、改动时先看哪里”
- 沉淀结果要优先服务后续开发和排障，而不是保留原始资料堆积
关键陷阱
- 只读文档，不做代码核验
- 把外部资料原样搬运进 skill
- 输出结构没有边界感，导致后续继续膨胀
延伸阅读
- 文档发现与初筛：
reference/1-document-discovery.md - 代码交叉验证：
reference/2-code-cross-check.md - 沉淀为 skill / 架构文档：
reference/3-skill-distillation.md - 如果你要写 skill：再看
skill-writer
When not to use it
- →When the specific code modification is already known
- →When only compressing an existing skill without new knowledge acquisition
- →When adding general descriptions that do not form reusable knowledge assets
Limitations
- →Does not directly modify code
- →Requires cross-verification with code or runtime paths
- →Output structure must define boundaries to prevent expansion
How it compares
This workflow prioritizes understanding and verification before documentation, unlike directly modifying code or simply summarizing existing information.
Compared to similar skills
business-knowledge-workflow side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| business-knowledge-workflow (this skill) | 1 | 3mo | No flags | Intermediate |
| search-company-knowledge | 2 | 5mo | No flags | Beginner |
| confluence-deep-reader | 1 | 5mo | No flags | Beginner |
| knowledge-base | 1 | 6mo | Review | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by TencentBlueKing
View all by TencentBlueKing →You might also like
search-company-knowledge
atlassian
Search across company knowledge bases (Confluence, Jira, internal docs) to find and explain internal concepts, processes, and technical details. When Claude needs to: (1) Find or search for information about systems, terminology, processes, deployment, authentication, infrastructure, architecture, or technical concepts, (2) Search internal documentation, knowledge base, company docs, or our docs, (3) Explain what something is, how it works, or look up information, or (4) Synthesize information from multiple sources. Searches in parallel and provides cited answers.
confluence-deep-reader
krafton-ai
Read a Confluence page and recursively explore its child pages up to 3 levels deep. Use when users want to comprehensively read a Confluence page tree, understand hierarchical documentation, or analyze content across parent and child pages.
knowledge-base
incidentfox
Search runbooks, documentation, and knowledge base articles from Confluence. Use when looking for incident response procedures, service documentation, post-mortems, or troubleshooting guides.
c4-architecture-documentation
Hack23
Document system architecture using C4 model with context, container, component views and Mermaid diagrams
arc42-documentation
MikBin
arc42 architecture documentation template and guidance
adr
landphieran
Record an Architecture Decision Record (ADR). Produces an immutable docs/architecture/ADR-[NNN]-[title].md capturing the context, options considered, decision made, and consequences. Use when making any significant technical decision about architecture, technology choice, or design pattern.