CLI 设计

kgent 应以 CLI-first 的方式构建。

核心命令

kgent run --config kgent.yaml --prompt "Design a 3-day trip to Kyoto" --sandbox ./runs/kyoto-001

kgent run --config kgent.yaml --prompt-file task.md --sandbox ./runs/task-001

kgent inspect ./runs/task-001

kgent skill list

kgent skill promote ./runs/task-001/archive/candidate-skill ./skills/new-skill

配置示例

kgent:
  name: professional-worker

profile:
  role: senior travel planner
  responsibilities:
    - clarify travel constraints
    - research destinations
    - design practical itineraries
    - estimate budget
    - identify risks
  style:
    - concise
    - practical
    - evidence-aware

model:
  provider: openai
  name: gpt-4.1-mini

skills:
  paths:
    - ./skills
  enabled:
    - travel-planning
    - web-research
    - budget-estimation

tools:
  filesystem:
    enabled: true
  web:
    enabled: true
  shell:
    enabled: false

memory:
  provider: external
  scopes:
    - user
    - project
    - organization

workspace:
  sandbox: ./runs/kyoto-001

deliverables:
  required:
    - deliverables/final.md
    - deliverables/itinerary.md
    - deliverables/budget.md
    - deliverables/risk-checklist.md

CLI 输出

Stdout 应展示简洁进度。

持久化信息应写入 run 目录：

• event log
• transcript
• tool log
• final deliverables
• archive artifacts