# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

巴赫核心概念
=================

“代理人是其中的角色和以目标为导向的意图。
工作流程是执行的大脑。
技能、工具和服务是执行的工具。
它们共同构成了核心。”

四大支柱
----------------

```
┌──────────────────────────────────────────────────────────────────┐
│ 核心 │
├──────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┐──────────────┐ ┌────────────────────┐ │
│ │ 代理 │ │ 工作流程 │ │ 技能/工具/SVC │ │
│ │ │ │ │ │ │ │
│ │ 角色+ │────>│ 大脑 │────> 工具 │ │
│ │ 意图 │ │ 控制 │ │ 执行 │ │
│ │ │ │ │ │ │ │
│ │ 谁 + 为什么 │ │ 如何 │ │ 什么与什么 │ │
│ └──────────────┘ └──────────────┘ └────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────────────┘
```

代理 = 角色 + 目标导向的意图
---------------------------------------

- 我在这项任务中是谁？
- 我为什么要这样做？ （目标、动机）
- 定义观点和决策框架

示例：
  - 开发代理：编写代码、调试、测试
  - 个人助理：帮助用户处理日常生活
  - 研究专家：搜索和评估信息

存储位置：agents/*.txt

工作流程=执行大脑
---------------------------------

- 任务是如何执行的？
- 控制流程、顺序、决策
- 程序知识：分步说明

示例：
  - 错误修复工作流程：重现 -> 分析 -> 修复 -> 测试
  - 审核工作流程：阅读 -> 评分 -> 评论 -> 决定
  - 启动工作流程：检查 -> 加载 -> 初始化 -> 就绪

存储位置：skills/workflows/*.md

工作流程是核心，因为：
  1.您接管实际控制权
  2. 您协调技能、工具和服务
  3.它们是可测试的（用例测试）
  4. 它们是可重复使用的

技能/工具/服务=工具
-------------------------------------

- 任务是用什么来执行的？
- 具体技能和功能
- 由工作流程调用

|类型 |描述 |地点 |
|--------------------|--------------------------|--------------------------------|
|技能 |知识 + 说明 (.txt) |技能/*.txt |
|工具| Python 脚本 (.py) |工具/*.py |
|服务|外部服务|通过 API/CLI 

|互动
-------------

```
用户请求
     │
     v
┌────────────┐
│ 代理 │ “我是开发者，目标：修复 bug”
└──────────────┘
     │
     v
┌────────────┐
│ 工作流程 │ “1. 重现 2. 分析 3. 修复”
└──────────────┘
     │
     v
┌──────────────────────────────────────┐
│ 技能/工具/服务 │
│ - debugger.py（工具） │
│ - git-workflow.txt (技能) │
│ - 测试运行者（服务） │
└────────────────── ────────────────────┘
     │
     v
结果
``

LLM 意识
-------------------

操作LLM 必须知道：
1. 存在哪些代理（代理/）
2. 哪些工作流程可用（技能/工作流程/）
3. 有哪些技能/工具/服务（技能/、工具/）

这是通过以下方式实现的：
- 处理程序注册表 (system/core/registry.py) - 自动发现处理程序
- 工具自动发现 (tools/tool_auto_discovery.py) - 将工具扫描到数据库中
- 数据库条目（工具表、hierarchy_items）
- 启动概述显示会话上下文

请参阅：--help 启动、--help 工具

质量保证 (WORKFLOW-TUEV)
-----------------------------------

工作流程非常重要，必须进行检查：

1.用例测试
   - DB中测试用例的集合
   - 自动执行
   - 评级：非常好/良好/满意/足够/失败

2。 TUEV 程序
   - 工作流程有有效期
   - 到期时：自动创建维护任务
   - 检查后：设置新的到期日期

3。新组件清单
   [ ] 无需用户数据即可工作吗？
   [ ] CLI 命令可用吗？
   [ ] 可以从文件/文件夹输入吗？
   [ ] 结构化数据库中的输出？
   [ ] 扫描/导入可重复（幂等）？
   [ ] 没有硬编码路径？

请参阅：WF-TUEV 任务（正在开发中）

相关概念
------------------

- docs/help/memory.txt - 记忆作为一种认知模型
- docs/help/agents.txt - 代理系统详细信息
- docs/help/workflow.txt - 工作流程系统详细信息
- docs/help/skills.txt - 技能层次结构
- docs/help/tools.txt - 工具系统详细信息
- system/ARCHITECTURE.md - 总体架构

---
版本：1.0.1 |创建时间：2026-01-30 |更新日期：2026-02-08
（核心概念：代理/工作流程/技能/工具）
