SuperAPI AI 工具集

business-knowledge-workflow

写作与研究

查看项目

更新于 10-16 04:47

技能介绍

业务知识工作流

适用场景

  • 需要快速理解一个陌生业务模块
  • 需要从 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