产品基线
本文档是 kgent 当前目标和关键特性的硬基线。
当产品方向变化时，应有意识地更新本文档。后续特性实现设计应以本文档作为 source of truth。
产品定位
kgent 是一个基于 Pydantic AI 的技能驱动、记忆增强、沙箱优先的专业智能体运行时。
kgent 应允许用户配置专业智能体，使其能够完成需求访谈、旅行规划、课程设计、视频节目设计、研究、Coding 和审查等真实工作。
核心目标
kgent 的最小成功运行不是一次聊天回答。
它是一场可审计的专业任务执行，并且：
- 使用已配置的专业身份。
- 应用相关技能。
- 通过显式工具行动。
- 在有用时使用记忆。
- 在沙箱中工作。
- 产出持久化交付物。
- 记录过程证据。
产品目标
| Objective | 定义 | 成功信号 |
|---|---|---|
| Professional work execution | kgent 完成真实专业任务，而不仅是生成对话回答。 | 一次运行在 deliverables/ 下产出符合领域的交付物。 |
| Domain extensibility | kgent 能在不修改运行时核心的情况下变成不同专业员工。 | 新领域可通过 profiles、skills、tools 添加。 |
| Context continuity | kgent 能使用长期用户、项目、组织和会话上下文。 | 运行可以召回相关上下文并产出候选记忆。 |
| Auditable delivery | kgent 的工作在运行后可以被检查。 | 运行保存 prompt、config、events、transcript、logs 和 deliverables。 |
| Group-ready operation | kgent 未来能支持多个专业智能体协作。 | intake、coordination、worker、reviewer 和 handoff 概念有稳定契约。 |
| Professional reliability | kgent 应具备显式质量和安全控制。 | 必需输出、工具权限、记录和审查路径可执行。 |
关键特性
| Key Feature | Priority | 产品含义 | 首个成功信号 |
|---|---|---|---|
| Configurable Professional Identity | P0 | 将 kgent 配置成不同专业员工。 | profile 可以在不改代码的情况下改变角色、职责、风格和边界。 |
| Skill-Driven Capability System | P0 | 通过可复用技能包扩展专业能力。 | kgent 能发现技能，并仅在需要时加载选中的技能。 |
| Tool-Mediated Action System | P0 | 通过显式、可观测、 受权限控制的工具行动。 | 文件、记忆和可选网络动作以工具形式暴露并被记录。 |
| Memory-Aware Context System | P0 | 使用长期上下文，但不绑定具体记忆实现。 | kgent 能通过稳定契约调用外部 recall/write memory tools。 |
| Sandbox-First Work Execution | P0 | 在持久、可审计的工作区中完成任务。 | 每次运行创建包含记录、工作文件和交付物的沙箱。 |
| Quality and Governance System | P1 | 确保输出、工具、技能、记忆和交接物满足质量与安全标准。 | Phase 1 具备必需交付物检查、安全工具默认值和显式运行记录。 |
| Professional Workflow Orchestration | P1 | 支持 intake、planning、execution 和 review。 | Intake、Coordinator、Worker、Reviewer 可交换结构化 artifacts。 |
| Learning and Capability Evolution | P2 | 通过审查后的候选技能、记忆和模式持续改进。 | 运行能归档摘要，并生成候选技能或记忆供审查。 |
目标覆盖
| Objective | 支撑关键特性 | 覆盖度 |
|---|---|---|
| Professional work execution | Configurable Professional Identity, Skill-Driven Capability System, Tool-Mediated Action System, Sandbox-First Work Execution, Quality and Governance System | 强 |
| Domain extensibility | Configurable Professional Identity, Skill-Driven Capability System, Tool-Mediated Action System | 强 |
| Context continuity | Memory-Aware Context System, Sandbox-First Work Execution, Learning and Capability Evolution | 强 |
| Auditable delivery | Sandbox-First Work Execution, Tool-Mediated Action System, Quality and Governance System | 强 |
| Group-ready operation | Professional Workflow Orchestration, Configurable Professional Identity, Sandbox-First Work Execution, Skill-Driven Capability System | 中强 |
| Professional reliability | Quality and Governance System, Tool-Mediated Action System, Skill-Driven Capability System, Memory-Aware Context System | 中强 |
非目标
kgent 当前不试图成为：
- 通用聊天应用
- 只做 Coding 的 agent
- 重型 workflow engine
- 不受限制的桌面自动化 agent
- 隐藏执行记录的黑盒 agent 框架
- 记忆数据库
- 技能市场
Phase 1 范围
Phase 1 应证明 P0 关键特性，并包含最小治理基线。
包含：
- CLI run command
- YAML config
- profile 和 system prompt composition
- sandbox run directory
- Pydantic AI agent runtime
- filesystem tools
- skill discovery
- skill loading
- external memory tool contract
- run event records
- transcript records
- required deliverable checks
- safe tool permission defaults
不包含：
- 完整多智能体编排
- 自动技能提升
- 复杂 workflow graph
- 不受限制的 shell 执行
- GUI
- 完整评测体系
- 生产级记忆治理流程
Phase 1 验收标准
Phase 1 实现可接受的条件：
- 能用 config 和 prompt 运行
kgent run。 - 创建 run sandbox。
- 基于 profile 构建 effective system prompt。
- 发现可用技能。
- 将选中技能加载到 agent context。
- 暴露沙箱化 filesystem tools。
- 通过稳定接口暴露 memory recall/write tools。
- 保存 run metadata、events、transcript 和 logs。
- 在
deliverables/下产出必需文件。 - 对缺失必需交付物进行拒绝或报告。
- 对工具使用安全默认权限。
下一步设计冻结边界
下一步进入特性实现设计。
以下边界视为基线：
- Pydantic AI 是执行引擎。
- kgent 负责 profiles、skills、memory policy、sandbox、run records、deliverables 和 governance。
- Skills 是专业工作包，不只是工具函数。
- Memory 是外部系统，通过显式契约接入。
- 每次 run 都是 sandbox-first、artifact-based。
- Quality and Governance 是一等关键特性，Phase 1 做最小实现。