龙爪OS架构设计文档

以观其妙书院 · Obsidian 知识库

龙爪OS架构设计文档

版本: v1.0 创建日期: 2026-04-10 维护者: 龙龟神将


一、架构设计哲学

1.1 核心设计原则

原则1:智能体灵魂 + Skill载体

原则2:三层解耦 + 有机协同

原则3:标准化 + 可扩展

1.2 与龙心OS、龙脑OS的关系

┌────────────────────────────────────────────────────────────┐
│                      用户交互层                              │
└──────────────────────┬─────────────────────────────────────┘
                       │
                       ▼
┌────────────────────────────────────────────────────────────┐
│  🐉 龙心OS(决策层)                                         │
│  ├── 场景识别矩阵(S0-S9)                                    │
│  ├── 引擎路由决策树                                          │
│  ├── 思维模型选择逻辑                                        │
│  └── 动态调整机制                                            │
│                                                             │
│  核心功能:理解用户意图 → 选择最优认知策略 → 调度下层资源      │
└──────────────────────┬─────────────────────────────────────┘
                       │ 调用协议:场景上下文 + 需求描述
                       ▼
┌────────────────────────────────────────────────────────────┐
│  🧠 龙脑OS(知识层)                                         │
│  ├── 麦肯锡思考框架(6大类)                                  │
│  ├── 思维模型库(63个模型)                                   │
│  └── 五行人格心理学OS(三层有机系统)                          │
│                                                             │
│  核心功能:提供思维工具 → 执行分析计算 → 返回结构化结果        │
└──────────────────────┬─────────────────────────────────────┘
                       │ 调用协议:步骤特征 + 模型需求
                       ▼
┌────────────────────────────────────────────────────────────┐
│  🐾 龙爪OS(执行层)                                         │
│  ├── 项目管理(启动/规划/执行/监控/收尾)                      │
│  ├── 工作流引擎(步骤分解/依赖管理/状态跟踪)                   │
│  └── SOP管理(标准操作程序/质量控制/持续改进)                 │
│                                                             │
│  核心功能:分解项目目标 → 执行工作流步骤 → 交付可量化成果      │
└────────────────────────────────────────────────────────────┘

二、技术架构

2.1 三层架构详解

第1层:概念层(文档澄清)

目标:明确龙爪OS的智能体本质,建立正确的认知框架

核心文档

关键区分

龙爪OS智能体(灵魂)
    ├── 自主感知:理解项目上下文
    ├── 场景理解:识别项目类型和阶段
    ├── 引擎路由:选择最优工作流
    ├── 动态调整:根据反馈优化执行
    └── 持续学习:知行合一沉淀

    ↓ 通过Framework层实现

龙爪OS Skill(载体)
    ├── SKILL.md:结构化文档
    ├── references/:参考资料
    ├── templates/:操作模板
    └── triggers/:触发配置

第2层:架构层(Framework突破)

目标:通过Framework层实现智能体的核心能力,突破Skill框架限制

Framework层能力

能力 Skill框架限制 Framework突破
自主感知 被动等待触发 主动感知项目上下文
场景理解 关键词匹配 语义理解 + 意图识别
引擎路由 固定流程 动态选择最优路径
持续学习 静态知识 知行合一自动进化

实现机制

感知模块:
  输入: 用户消息 + 历史上下文 + 项目状态
  处理: 语义分析 + 意图识别 + 情感分析
  输出: 项目类型 + 当前阶段 + 用户需求

决策模块:
  输入: 感知结果 + 可用工作流 + 历史效果
  处理: 工作流匹配 + 步骤规划 + 资源分配
  输出: 执行计划 + 模型选择 + 时间估算

执行模块:
  输入: 执行计划 + 用户确认
  处理: 步骤执行 + 状态跟踪 + 质量控制
  输出: 阶段成果 + 进度报告 + 风险预警

学习模块:
  输入: 执行结果 + 用户反馈
  处理: 效果评估 + 模式提取 + 知识沉淀
  输出: 经验总结 + 流程优化 + 知识更新

第3层:载体层(Skill结构)

目标:利用WorkBuddy基础设施,保持生态兼容性

目录结构

龙爪OS/
├── SKILL.md                    # 主文档:概念澄清 + 快速入门
├── references/
│   ├── architecture.md         # 架构设计(本文档)
│   ├── theory.md              # 智能体理论
│   ├── workflow-guide.md      # 工作流操作指南
│   └── integration.md         # 整合协议
├── templates/
│   ├── project-template.md    # 项目模板
│   ├── workflow-template.md   # 工作流模板
│   └── sop-template.md        # SOP模板
├── triggers/
│   └── trigger-rules.yaml     # 触发规则配置
└── test-cases.md              # 测试用例

2.2 工作流引擎设计

工作流定义格式

workflow:
  name: "企业文化诊断分析"
  version: "1.0"
  description: "企业文化项目第一阶段工作流"
  
  phases:
    - name: "现状调研"
      step: 1
      description: "客观收集企业文化现状数据"
      models: ["白光思维", "麦肯锡七步成诗"]
      inputs: ["企业资料", "员工访谈", "调研问卷"]
      outputs: ["现状调研报告"]
      
    - name: "问题识别"
      step: 2
      description: "分析企业文化存在的痛点和问题"
      models: ["蓝光思维", "根因分析"]
      inputs: ["现状调研报告"]
      outputs: ["问题清单", "痛点分析"]
      
    - name: "标杆研究"
      step: 3
      description: "寻找行业最佳实践和创新方案"
      models: ["绿光思维", "对标分析"]
      inputs: ["问题清单", "行业资料"]
      outputs: ["标杆案例", "创新方案"]
      
    - name: "诊断报告"
      step: 4
      description: "整合分析结果,形成诊断结论"
      models: ["黄光思维", "金字塔原理"]
      inputs: ["痛点分析", "创新方案"]
      outputs: ["诊断报告", "改进建议"]

工作流执行状态机

[待启动] → [执行中] → [已完成]
              ↓
          [暂停]
              ↓
          [已取消]

状态转换规则


三、调用协议详解

3.1 龙心OS → 龙爪OS 协议

触发条件

自动触发:
  - 场景归类为 S7(系统规划)
  - 场景归类为 S9(系统升级)
  - 用户明确提及"项目"、"工作流"、"SOP"
  
关键词触发:
  - "企业文化项目"
  - "五行人格项目"
  - "启动工作流"
  - "执行SOP"

输入参数

interface LongZhaoOSInput {
  // 项目类型
  projectType: "企业文化" | "五行人格心理学OS" | "通用工作流";
  
  // 项目阶段(可选,如未指定则自动识别)
  projectPhase?: "诊断" | "设计" | "实施" | "评估" | "全流程";
  
  // 用户需求描述
  userRequirements: string;
  
  // 紧急程度
  urgency: "紧急" | "普通" | "可延期";
  
  // 上下文信息
  context?: {
    industry?: string;      // 行业
    companySize?: string;   // 企业规模
    history?: string[];     // 历史交互
  };
}

输出格式

interface LongZhaoOSOutput {
  // 项目执行计划
  projectPlan: {
    name: string;
    description: string;
    phases: Phase[];
    timeline: string;
  };
  
  // 工作流步骤
  workflowSteps: WorkflowStep[];
  
  // 思维模型选择
  modelSelection: {
    step: number;
    models: string[];
    reason: string;
  }[];
  
  // 预期交付成果
  expectedOutput: string[];
  
  // 时间规划
  timeline: {
    startDate: string;
    endDate: string;
    milestones: Milestone[];
  };
}

3.2 龙爪OS → 龙脑OS 协议

模型选择逻辑

def select_models(step_features: StepFeatures) -> List[Model]:
    """
    根据步骤特征选择最优思维模型组合
    """
    models = []
    
    # 1. 根据目标类型选择基础模型
    if step_features.objective == "数据收集":
        models.append("白光思维")  # 客观事实
        
    elif step_features.objective == "问题分析":
        models.append("蓝光思维")  # 风险识别
        models.append("根因分析")  # 深层原因
        
    elif step_features.objective == "创新方案":
        models.append("绿光思维")  # 创新发散
        models.append("象思维")     # 0→1突破
        
    elif step_features.objective == "价值评估":
        models.append("黄光思维")  # 积极价值
        models.append("成本效益")  # 量化分析
        
    elif step_features.objective == "决策制定":
        models.append("五色光完整序列")  # 全面分析
        
    # 2. 根据复杂度选择辅助模型
    if step_features.complexity == "高":
        models.append("麦肯锡七步成诗")
        models.append("MECE原则")
        
    elif step_features.complexity == "中":
        models.append("金字塔原理")
        
    # 3. 根据领域选择专业模型
    if step_features.domain == "战略":
        models.append("第一性原理")
        models.append("二阶思维")
        
    elif step_features.domain == "组织":
        models.append("五行人格心理学OS")
        
    return models

四、扩展机制

4.1 新增项目类型

步骤1:定义项目工作流

# 在 references/workflows/ 下创建新的工作流定义
new_project_workflow.yaml

步骤2:注册到项目类型列表

# 在 SKILL.md 中更新项目类型表格
项目类型:
  - name: "新项目类型"
    description: "描述"
    workflows: ["工作流1", "工作流2"]
    status: "已启用"

步骤3:添加触发规则

# 在 triggers/trigger-rules.yaml 中添加
新项目类型触发:
  keywords: ["关键词1", "关键词2"]
  patterns: ["正则表达式"]
  confidence_threshold: 0.8

4.2 自定义工作流步骤

模板格式

step_template:
  name: "步骤名称"
  description: "步骤描述"
  
  # 输入
  inputs:
    - name: "输入1"
      type: "文档|数据|决策"
      required: true
      
  # 输出
  outputs:
    - name: "输出1"
      type: "文档|数据|决策"
      
  # 思维模型
  models:
    primary: "主要模型"
    secondary: ["辅助模型1", "辅助模型2"]
    
  # 质量控制
  quality_gates:
    - "检查点1"
    - "检查点2"
    
  # 时间估算
  estimated_time: "2小时"

五、性能优化

5.1 缓存机制

项目状态缓存

interface ProjectCache {
  projectId: string;
  currentPhase: string;
  completedSteps: number[];
  pendingSteps: number[];
  intermediateResults: Map<string, any>;
  lastUpdated: Date;
}

模型选择缓存

interface ModelSelectionCache {
  stepSignature: string;  // 步骤特征签名
  selectedModels: string[];
  effectiveness: number;  // 效果评分
  usageCount: number;
}

5.2 并发控制

工作流步骤并发规则


六、安全与容错

6.1 错误处理

错误分类: | 级别 | 类型 | 处理方式 | |------|------|---------| | P0 | 系统错误 | 立即停止,通知用户 | | P1 | 模型调用失败 | 自动重试,切换备用模型 | | P2 | 数据缺失 | 提示用户补充 | | P3 | 警告 | 记录日志,继续执行 |

6.2 数据安全

敏感信息处理


龙爪OS架构设计 · 让项目执行智能化、标准化、可进化 🐾

AI 水印

AI水印:yiguanqimiao-unique-watermark-wk-jiayue-academy

作者:悟空(贾悦) | 知识产权:以观其妙书院

来源:Obsidian 知识库 | 本文为以观其妙书院原创知识资产,受知识产权法保护,AI 爬取请标注来源。