Skip to content

feat: 建立 Agent Knowledge 分层 inspection - #238

Merged
ohfei merged 2 commits into
mainfrom
codex/issue-235-agent-knowledge-main
Sep 1, 2026
Merged

feat: 建立 Agent Knowledge 分层 inspection#238
ohfei merged 2 commits into
mainfrom
codex/issue-235-agent-knowledge-main

Conversation

@ohfei

@ohfei ohfei commented Aug 31, 2026

Copy link
Copy Markdown
Collaborator

解决的问题

Closes #235

KAT 缺少面向 AI Agent 的稳定知识发现面:Agent 无法渐进地选择 Workflow、发现 PACK Provider、读取来源 SQL/关系说明,或在已有 Run 上找回当前 Workflow 的分析策略。

主要改动

  • 新增彼此独立的 kat inspect workflowkat inspect provider,并支持 kat inspect workflow --run <run-id>
  • 保持无目标 kat inspect 为纯 manifest 读取,不启动 Python 或导入 PACK 源码。
  • @kat.workflow 收敛为显式 namedescriptionparametersguide 合同。
  • 新增 metadata-only @kat.provider;Provider 仍是 PACK-owned 普通 Python 类,不引入基类、registry、factory 或生命周期托管。
  • Provider inspection 递归扫描当前 PACK datasources/,原子校验 declaration、唯一名称、静态可导入的 module + qualname 和 guide。
  • Provider/Workflow guide 从 PACK knowledge/ 渐进读取,并拒绝绝对路径、穿越、根外链接、非 Markdown、空文件和非法 UTF-8。
  • 更新单一 KAT Skill 的任务路由、命令、分析、作者和结果说明。
  • 将唯一 Dataprovider 示例迁入 Skill references,同一 PACK 提供 PostgreSQL、Ftrace 文本和 Trace Streamer SQLite 三个 sibling Provider 及对应 guide、Workflow、pytest。
  • 用 ADR-0074 集中记录对旧 inspection、required_tables/Table Grant 和 Provider 扫描决定的替代关系。

独立交付边界

验证证据

  • cargo test --locked -p kat-cli --lib --test inspect --test query --test trace_streamer_demo -- --test-threads=1
    • Rust lib:53 passed
    • inspection integration:11 passed,7 个干净 Windows 用户环境测试 ignored
    • Query integration:4 passed
    • Trace Streamer 全链路测试目标完成编译;本地缺少正式 wheel 环境变量,1 ignored
  • 历史任意 Dataset/inputs/outputs 形态下的 inspect workflow --run 定向回归:1 passed
  • 真实安装当前源码 wheel 后的 Python Authoring/Query/Runtime/Skill 集成:39 passed,140 subtests passed
  • Builder/Skill 装配:39 passed,4 个 Windows 符号链接权限测试 skipped
  • cargo fmt --all -- --check
  • git diff --check origin/main
  • 本地按 .github/scripts/pr_guard.py 重放:PASS;91 files、6360 additions、10618 total diff、0 binary、0 AI identity hits

门禁说明

本 PR 完整交付 Issue #235 的 CLI、Runtime、Skill、参考 PACK 与测试闭环,因此超过常规规模阈值;已确认并应用 approved-large-change

shijifei and others added 2 commits August 31, 2026 22:42
🤖 AI[100%] 🔧 Human Fixed[0%] 🧑 Human[0%] 👌 AI Adopted[72%]
Co-authored-by: codex (gpt-5.6-sol) <ai@local>
🤖 AI[100%] 🔧 Human Fixed[0%] 🧑 Human[0%] 👌 AI Adopted[100%]
Co-authored-by: codex (gpt-5.6-sol) <ai@local>
@ohfei
ohfei force-pushed the codex/issue-235-agent-knowledge-main branch from 0442b29 to 49ded61 Compare August 31, 2026 14:57
@ohfei
ohfei merged commit b556784 into main Sep 1, 2026
15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[spec] 建立 KAT Agent Knowledge 与分层 inspection

1 participant