kgent 架构

运行时总览

kgent run
  -> load config
  -> create sandbox
  -> recall relevant memory
  -> discover skill index
  -> build Pydantic AI agent
  -> run task
  -> record events
  -> write deliverables
  -> archive session
  -> distill candidate memory and skills

主要组件

CLI
  -> Config Loader
  -> Sandbox Workspace
  -> Agent Runtime
      -> Pydantic AI Agent
      -> Filesystem Toolset
      -> Skill Toolset
      -> Memory Toolset
      -> Web Toolset
  -> Run Recorder
  -> Deliverable Validator
  -> Session Archiver

建议源码结构

src/kgent/
  cli.py
  config.py
  runtime.py
  sandbox.py
  recorder.py
  prompts.py

  tools/
    filesystem.py
    skills.py
    memory.py
    web.py

  skills/
    registry.py
    distiller.py
    promoter.py

  memory/
    client.py
    types.py

  archive/
    session.py

docs/
  vision.md
  architecture.md
  agents.md
  skills.md
  memory.md
  sandbox.md
  cli.md
  roadmap.md

Pydantic AI 边界

Pydantic AI 是执行引擎，而不是整个产品。

它应负责：

• model adapter usage
• tool invocation
• typed tool schemas
• typed final outputs
• toolset composition

kgent 应负责：

• profiles
• skill discovery and loading
• memory policy
• sandbox layout
• run recording
• deliverable contracts
• workflow stages
• skill promotion governance

运行时对象

Profile
  定义角色、职责、风格和约束。

Skill
  定义专业能力、工作流、参考资料、模板和可选脚本。

Tool
  定义 agent 可使用的可执行动作。

Memory
  定义外部长期上下文的读取和写回。

Workspace
  定义一次运行的沙箱文件系统。

Deliverable
  定义预期输出文件和验收标准。

Run
  定义一次可审计任务执行。