修复: 消息溯源P2切读确认完成 + 走查报告高优项
- 更新 P2 切读方案文档(确认批次B已上线) - ㉑ query LIKE 通配符转义(project/idea/task/knowledge 4 处) - ⑱ dag.rs deep_merge null 覆盖全局配置 - ⑲ dag.rs _ 通配 match 展开显式变体 - ⑩ INDEX.md 补漏 10 个文档索引 - ⑫ ARCHITECTURE.md 删除与新文档逐字重复 - ㉒ coordinator.rs 加 #[deprecated] 编译守卫 - ㉛ AiChat.vue 空值传播加 console.warn
This commit is contained in:
123
ARCHITECTURE.md
123
ARCHITECTURE.md
@@ -535,6 +535,8 @@ CREATE TABLE app_settings (
|
||||
|
||||
## 七、三层模型:模板 → 工作流 → 人设
|
||||
|
||||
> 本章详细设计已迁至专项文档,详见 [docs/02-架构设计/专项设计/三层模型-流程模板与人设体系-2026-06-28.md](./docs/02-架构设计/专项设计/三层模型-流程模板与人设体系-2026-06-28.md)。此处仅保留摘要性定义。
|
||||
|
||||
### 7.1 三层定义
|
||||
|
||||
| 层 | 回答的问题 | 本质 | 生命周期 | 当前状态 |
|
||||
@@ -543,126 +545,9 @@ CREATE TABLE app_settings (
|
||||
| **工作流 (Workflow)** | 怎么执行 | 模板的运行时实例(DAG + 状态 + 数据绑定) | 随项目启停,单次执行归档 | ✅ df-workflow 核心完成 |
|
||||
| **人设 (Persona)** | 谁来做 | Agent 角色卡(system prompt + 工具集 + 行为规则) | 长期存在,跨节点复用 | ⬜ 待设计 |
|
||||
|
||||
### 7.2 三者关系
|
||||
**关键原则**:模板不绑定具体人设、工作流不感知人设、人设与模板解耦。
|
||||
|
||||
```
|
||||
流程模板 (蓝图)
|
||||
│ 实例化(填入项目参数)
|
||||
▼
|
||||
工作流实例 (运行时 DAG)
|
||||
│ 分配人设(绑定到每个 AINode)
|
||||
▼
|
||||
人设驱动 Agent 执行
|
||||
```
|
||||
|
||||
**关键点**:
|
||||
- 模板不绑定具体人设,只标注"建议人设类型",实例化时由用户覆盖
|
||||
- 工作流不感知人设,只管 DAG 执行;人设注入发生在 AINode 执行时
|
||||
- 人设与模板解耦:同一个人设可用于不同模板的同类节点
|
||||
|
||||
### 7.3 模板实例化流程
|
||||
|
||||
```
|
||||
① 选择模板 → "功能开发模板"
|
||||
模板定义: [需求分析]→[架构设计]→[编码]→[测试]→[审查]→[发布]
|
||||
建议人设: analyst → architect → coder → tester → reviewer → none
|
||||
|
||||
② 实例化为工作流 DAG
|
||||
┌─ AINode(需求分析) 建议人设: analyst
|
||||
├─ AINode(架构设计) 建议人设: architect
|
||||
├─ AINode(编码) 建议人设: coder
|
||||
├─ AINode(单元测试) 建议人设: tester
|
||||
├─ ScriptNode(运行测试) 无人设(纯脚本)
|
||||
├─ HumanNode(审批发布) 无人设(人工)
|
||||
└─ AINode(发布说明) 建议人设: writer
|
||||
|
||||
③ 实际分配人设(可覆盖)
|
||||
编码节点 → coder-rust(项目是 Rust 后端)
|
||||
测试节点 → tester-py(测试框架是 Python)
|
||||
|
||||
④ 执行
|
||||
工作流引擎按 DAG 拓扑调度节点
|
||||
每个 AINode 执行时载入对应人设的 system_prompt + 工具集
|
||||
NodeContext 中传递 persona_id,AI Node 据此取人设配置
|
||||
```
|
||||
|
||||
### 7.4 人设定义
|
||||
|
||||
```rust
|
||||
/// 智能体人设(Agent 角色卡)
|
||||
pub struct AgentPersona {
|
||||
pub id: PersonaId,
|
||||
pub name: String, // 人设名称
|
||||
pub description: String, // 一句话描述
|
||||
pub system_prompt: String, // 角色系统提示词
|
||||
pub allowed_tools: Vec<String>, // 可用工具列表
|
||||
pub suggested_tier: ModelTier, // 推荐模型层级
|
||||
pub output_format: OutputFormat, // 输出格式约束
|
||||
pub rules: Vec<BehaviorRule>, // 行为规则
|
||||
pub examples: Vec<PersonaExample>, // Few-shot 样例
|
||||
}
|
||||
|
||||
// 预置人设(平台内置,用户可自定义扩展)
|
||||
Persona::coder → "你是资深 Rust/TS 工程师..."
|
||||
Persona::reviewer → "你是代码审查员,关注安全漏洞..."
|
||||
Persona::architect → "你是系统架构师,关注模块划分..."
|
||||
Persona::tester → "你是测试工程师,生成边界用例..."
|
||||
Persona::analyst → "你是需求分析师,拆解用户故事..."
|
||||
```
|
||||
|
||||
### 7.5 模板示例:功能开发模板(YAML)
|
||||
|
||||
```yaml
|
||||
# templates/feature-dev.yaml
|
||||
id: feature-dev
|
||||
name: 功能开发模板
|
||||
description: 标准功能开发流程,从需求分析到发布
|
||||
template_version: 1
|
||||
|
||||
nodes:
|
||||
- id: analysis
|
||||
type: ai
|
||||
persona_hint: analyst
|
||||
prompt: "分析以下需求:{{inputs.requirement}}"
|
||||
inputs:
|
||||
requirement: "$ctx.requirement"
|
||||
outputs:
|
||||
prd: text
|
||||
|
||||
- id: design
|
||||
type: ai
|
||||
persona_hint: architect
|
||||
prompt: "基于 PRD 设计架构:{{inputs.analysis.prd}}"
|
||||
inputs:
|
||||
analysis: "$nodes.analysis"
|
||||
outputs:
|
||||
arch_doc: text
|
||||
|
||||
- id: coding
|
||||
type: ai
|
||||
persona_hint: coder
|
||||
prompt: "按架构设计实现:{{inputs.design.arch_doc}}"
|
||||
inputs:
|
||||
design: "$nodes.design"
|
||||
outputs:
|
||||
code: text
|
||||
|
||||
- id: review
|
||||
type: ai
|
||||
persona_hint: reviewer
|
||||
prompt: "审查代码:{{inputs.coding.code}}"
|
||||
inputs:
|
||||
coding: "$nodes.coding"
|
||||
|
||||
quality_gates:
|
||||
- node: review
|
||||
condition: "output.verdict == 'pass'"
|
||||
on_fail: "goto coding"
|
||||
|
||||
artifacts:
|
||||
prd: "$nodes.analysis.prd"
|
||||
code: "$nodes.coding.code"
|
||||
review_report: "$nodes.review.text"
|
||||
详细定义、三者关系、实例化流程、数据结构及 YAML 模板示例见 [专项设计文档](./docs/02-架构设计/专项设计/三层模型-流程模板与人设体系-2026-06-28.md)。
|
||||
|
||||
## 八、Phase 规划
|
||||
|
||||
|
||||
Reference in New Issue
Block a user