knowledge-engineering

A method for assessing an unfamiliar project's documentation and turning missing business knowledge into a clear documentation structure. It is intended for AI engineers working in external projects.

In plain words
What is it for?
It helps inspect README files, documentation folders, project manifest files, architecture notes, and links to external documentation. It produces a situation report, a recommended path, guidance for adding knowledge in layers, and a documentation outline.
Why use it?
It helps when code exists but the project's purpose, architecture, or working rules are not written down. It identifies the documentation situation and suggests whether to guide documentation work or use an existing scanner.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/zts212653/clowder-ai/knowledge-engineering
Any agent
npx skills add zts212653/clowder-ai --skill knowledge-engineering
Clone the repo
git clone --depth 1 https://github.com/zts212653/clowder-ai

Made for: Claude Code, Codex.

Per session 109 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,470 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00109 $0.03470
Opus 5 $0.00055 $0.01735
Sonnet 5 $0.00022 $0.00694
Haiku 4.5 $0.00011 $0.00347

Measured 3d ago against content hash 51fe661fef05, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

knowledge-engineering scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

cat-cafe-skills/knowledge-engineering/SKILL.md · 290 lines

How it starts

The opening of the file, as written. The whole thing — 290 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Knowledge Engineering — AI FDE 知识工程方法论

你是 AI FDE(Forward Deployed Engineer):带着知识工程方法论,部署到用户的业务系统中,指导和完成开发。

核心认知:Scanner 再强也只能吃已有的文档。如果项目连结构化文档都没有,扫出来的东西价值极低。真正帮到用户的不是更好的扫描,而是指导用户把隐性知识显性化为结构化文档

方法论来源:IdeaHub 社区咨询实证((internal reference removed))。


Phase 1: 项目文档现状评估

进入外部项目后,先评估文档现状再决定路径。按以下步骤执行:

  1. 检查 docs/ 目录是否存在及其内容(有无 .md 文件、有无 YAML frontmatter)
  2. 检查 README.md 内容密度(空/极简/详细)
  3. 检查 manifest 文件(package.json / Cargo.toml / pyproject.toml / go.mod
  4. 检查是否有 ARCHITECTURE* / ADR* / CONTRIBUTING* / CHANGELOG*
  5. 检查是否有指向外部文档的链接(wiki / Confluence / 飞书 / Notion)

四种场景判定

场景 判定信号 推荐动作
A: 已有结构化文档 docs/*.md 存在且有 YAML frontmatter 不需要本 skill。CatCafeScanner 直接索引,或 GenericRepoScanner 处理
B: 只有代码无文档 docs/README.md 为空/极简,无独立文档文件 Guided path 核心场景——从代码结构推导文档骨架,指导用户填充
C: 文档散落 README 或代码中有 wiki/Confluence/飞书链接,但仓库内无 .md 先指导迁移策略(哪些搬到仓库内),再走 Guided path
D: 代码仓与文档仓分离 README 引用外部文档仓库,或 monorepo 中文档在独立 package 识别并提醒用户。指导在代码仓内建索引入口(至少一个 docs/README.md 指向文档位置)

输出:向用户报告评估结论——"你的项目属于场景 X,我建议..."。


Phase 2: 路径选择 — Guided vs Autonomous

评估完成后,向用户展示两条路径并说明差异。不替用户选——呈现事实后等用户决定。

路径 1: Guided — 猫指导文档重构

  • 适合:首次接触知识工程、团队缺文档规范、想建长期可维护的知识体系
  • 投入:3-7 天(猫指导结构 + 用户填充业务内容)
  • 产出:结构化文档体系 → 记忆引擎直接索引 → 高置信度记忆
  • 方法:三层知识注入(本 skill 核心,见下文)

路径 2: Autonomous — 猫自行扫描现有文档

  • 适合:已有一定文档基础、只想快速让猫理解项目、不需要文档改善建议
  • 当前能力:猫读取项目中已有的 docs/README.md、manifest 等文件,尽力理解项目。IndexBuilder 自动选择合适的扫描器:有 cat-cafe docs/ + frontmatter 结构(场景 A)用 CatCafeScanner;任意仓库结构用 GenericRepoScanner(F152 Phase A 已实现)
  • 限制:项目缺少结构化文档时,猫的理解深度和准确度受限于现有文档质量。如果扫描后发现理解不足,建议切换到 Guided 路径

向用户说明的要点

"两条路的核心区别:Guided 路径前期投入更多(需要你花几天时间和我一起整理文档),但产出是长期可维护的知识体系,我和其他猫未来每次进你的项目都能直接用。Autonomous 路径我会尽力读你现有的文档来理解项目,但如果文档不够,理解会比较浅——到时候我们可以再切到 Guided。"

用户选 Guided → 继续 Phase 3(三层知识注入)。 用户选 Autonomous → 猫读取现有文档尽力理解,如果理解不足建议后续补走 Guided。


Phase 3: 三层知识注入(Guided Path)

Read the full file on GitHub · 290 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 290 lines · 109 tokens per session scan A 51fe661fef05

Subscribe to this mod's changes

knowledge-engineering is a skill published in the GitHub repository zts212653/clowder-ai (2,854 stars, last pushed yesterday), licensed MIT. It adds 109 tokens to every session and 3,470 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.

obra/superpowers · 37 tokens

auto-perf-optimize

Run agent-driven VS Code performance or memory investigations. Use when asked to launch Code OSS, automate a VS Code scenario, run the Chat memory smoke runner, capture renderer heap snapshots, take workflow screenshots, compare run summaries, or drive a repeatable scenario before heap-snapshot analysis.

microsoft/vscode · 62 tokens

chat-perf

Run chat perf benchmarks and memory leak checks against the local dev build or any published VS Code version. Use when investigating chat rendering regressions, validating perf-sensitive changes to chat UI, or checking for memory leaks in the chat response pipeline.

microsoft/vscode · 51 tokens

chat-pet-sprite-creation

Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.

microsoft/vscode · 53 tokens

cpu-profile-analysis

Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…

microsoft/vscode · 71 tokens