knowledge-base-context

KnowledgeBase 任务上下文

概述

从用户当前任务出发，沿知识库语义、当前代码、数据模型、配置四条独立证据路径渐进读取，生成支持下游工作的最小任务上下文包。本 Skill 只接受 Manifest 4.0，是需求、Design、Plan、Coding、Testing、Review 或 Debug 的前置上下文阶段，不代替下游工作。

上下文准备完成后，调用方必须继续用户原始任务；只有用户明确只要求加载、整理或保存上下文时，才在上下文包处结束。

手动入口

• Claude Code 插件：/cadence-init:knowledge-base-context
• Codex：$knowledge-base-context

自动触发只由 Frontmatter description 决定。Manifest 在触发后提供 Schema、授权范围和证据基线，不参与 Skill 发现。

必读资源

• 执行渐进读取前读取 references/progressive-retrieval-guide.md。
• 识别主辅画像后读取 references/task-profiles.md 中对应画像。
• 需要核对完整输出形状时读取 references/demo.md。
• 只有用户明确要求保存任务上下文时，使用 assets/task-context-template.md。

强制边界

• 四条路径同等重要，必须分别记录来源、缺口和停止原因，不得把数据模型或配置并入“当前代码”。
• 每次任务都检查与逻辑表、数据源、配置组和配置键的直接关系。确认无直接关系后记录结论并停止该方向，不扫描全部数据模型或配置包。
• 只在 Manifest 4.0 的工程、数据模型和配置授权范围内读取；不得重新解释用户输入或自行扩大范围。
• 外部配置快照目录全程只读；不连接配置中心、数据库、中间件或远程环境，不执行部署、发布、启动或迁移脚本。
• 默认只把上下文返回当前会话，不创建任务文件。
• 不修改业务代码、KnowledgeBase、Manifest、变更包或下游交付物。
• 不复制完整源码、整篇知识库文档或配置快照，只保留摘要、稳定 ID、精确位置和必要短片段。
• 工作区未提交修改属于当前代码证据，不清理、不覆盖、不恢复。
• 敏感配置只返回配置键、用途、状态和绑定位置；值统一写为 <redacted>。
• 四条证据路径逐层执行：每层必须输出本层证据摘要（来源、精确位置、本层结论、停止原因）后才允许进入下一层；四条路径各自必须有证据或停止原因，禁止留白方向。
• 默认只扩展一跳；画像必需字段仍缺关键证据时才扩第二跳，扩跳必须记录触发理由。

工作流程

0. Schema 4.0 前置校验

1. 读取当前项目适用的 AGENTS.md、CLAUDE.md 和项目规则。
2. 定位 cadence/knowledge-base/manifest.yaml，只接受 schema_version: "4.0"。
3. 必读以下 Manifest 4.0 信息：
   • scope.projects、scope.data_models、scope.configurations。
   • evidence.data_model_sources 中的 DDL、迁移、Entity、Mapper、SQL 和人工资料状态。
   • evidence.configuration_snapshots.baseline 的快照标识、环境、外部目录、授权指纹、scope_summary、纳入文件数量或清单摘要、服务摘要、文件规则摘要和来源元数据。
   • update.last_change_package 与 update.processed_packages。
   • git.repositories 中的分支、baseline_commit 和仓库范围。
4. 获取当前分支、提交和工作区状态，只用于识别任务相关基线漂移。

Manifest 缺失、Schema 不是 4.0 或缺少任务所需授权范围时立即停止，报告缺失路径或版本，并引导执行 knowledge-base-bootstrap。不得兼容其他 Schema、自动迁移或回退为普通全仓分析。

1. 识别任务画像与种子

固定画像只有七类：需求澄清、Design、Plan、Coding、Testing、Review、Debug。选择一个主画像，可附加最多两个辅助画像。

从用户请求提取业务词，以及已知页面、API、服务、逻辑表、字段、数据源、配置组、配置键、文件、符号、错误信息、目标环境、MR 和变更包。用户明确点名对象优先于模糊业务词。