Skip to content

Issue #1: 【Doc】明确 Tool / Skill / Agent Core 抽象定义#17

Open
alijiujiu123 wants to merge 1 commit intomainfrom
issue/1-doc-tool-skill-agent-core
Open

Issue #1: 【Doc】明确 Tool / Skill / Agent Core 抽象定义#17
alijiujiu123 wants to merge 1 commit intomainfrom
issue/1-doc-tool-skill-agent-core

Conversation

@alijiujiu123
Copy link
Copy Markdown
Owner

Fixes #1

主要更改

在 中添加了 3 个完整的实际使用场景示例,满足 issue #1 的验收标准。

新增内容

  1. 场景 1: 自动化代码审查流程

    • Tool 层:GitHub API Tool、LLM Tool
    • Skill 层:CodeReviewSkill(获取 diff、LLM 分析、发布评论)
    • Agent Core 层:调度、风控检查、执行、反思
  2. 场景 2: 生产环境日志分析与告警

    • Tool 层:LogQueryTool、AlertTool
    • Skill 层:AnomalyDetectionSkill(查询日志、LLM 分析、触发告警)
    • Agent Core 层:定期监控、故障转移、效果监控
  3. 场景 3: 文档自动生成与维护

    • Tool 层:FileTool、GitTool
    • Skill 层:APIDocGeneratorSkill(分析变更、生成文档、写入文件)
    • Agent Core 层:事件驱动、条件触发、自动创建 PR

验收标准完成情况

  • ✅ 文档清晰区分三者的职责边界
  • ✅ 有具体的 TypeScript interface 定义
  • ✅ 包含至少 3 个实际使用场景示例

现有内容(已存在)

文档原本已包含:

  • Tool 的定义和 TypeScript 接口
  • Skill 的定义和 TypeScript 接口
  • Agent Core 的定义和模块组成
  • 三者关系图(Mermaid)
  • 代码示例

本次补充了 3 个完整的端到端场景,展示了三者如何协作完成实际任务。

- 场景 1: 自动化代码审查流程(Tool: GitHub/LLM, Skill: CodeReviewSkill)
- 场景 2: 生产环境日志分析与告警(Tool: LogQuery/Alert, Skill: AnomalyDetection)
- 场景 3: 文档自动生成与维护(Tool: File/Git, Skill: APIDocGenerator)

每个场景完整展示了 Tool、Skill、Agent Core 三层的协作关系,
满足 issue #1 的验收标准。

Fixes #1
@github-actions github-actions Bot added documentation Improvements or additions to documentation v2 v2 架构相关 agent: core Agent Core 模块 labels Feb 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agent: core Agent Core 模块 documentation Improvements or additions to documentation v2 v2 架构相关

Projects

None yet

Development

Successfully merging this pull request may close these issues.

【Doc】明确 Tool / Skill / Agent Core 抽象定义

1 participant