跳至主要内容

Cognitive Modules

可验证的结构化 AI 任务规范

Cognitive Modules 是一套用于 结构化、可验证、可审计 AI 任务的规范与运行时。

v2.2 亮点​

特性说明
控制/数据分离meta 控制面 + data 业务面
模块分层exec / decision / exploration
可恢复溢出extensions.insights 保存额外洞察
可扩展枚举支持自定义值且不破坏类型安全
修复通道自动修复常见 envelope 格式问题

快速开始​

# 配置 Provider（以 OpenAI 为例）
export OPENAI_API_KEY=sk-xxx

# 5 分钟路径：从 stdin 运行单文件 Core 模块（输出 v2.2 envelope）
cat <<'EOF' | npx cogn@2.2.12 core run --stdin --args "hello" --pretty
请返回一个合法的 v2.2 envelope（meta + data）。把答案放在 data.result。
EOF

如果你希望“协议化”，但只在需要时才引入复杂度：

核心特性​

  • 强类型契约 - JSON Schema 校验
  • 可解释输出 - meta.explain + data.rationale
  • 模块分层 - exec | decision | exploration
  • 子代理编排 - @call:module
  • 组合执行 - 顺序/并行/条件/迭代
  • HTTP API & MCP - 一线集成能力

v2.2 响应格式​

{
  "ok": true,
  "meta": {
    "confidence": 0.92,
    "risk": "low",
    "explain": "用于快速路由的简短摘要（≤280 字）"
  },
  "data": {
    "...业务字段...",
    "rationale": "详细推理过程",
    "extensions": {
      "insights": [
        {
          "text": "额外洞察",
          "suggested_mapping": "建议加入 schema 的字段"
        }
      ]
    }
  }
}

内置模块（仓库内）​

模块层级功能示例
code-reviewerdecision代码审查npx cogn@2.2.12 run code-reviewer --args "your code"
code-simplifierdecision代码简化npx cogn@2.2.12 run code-simplifier --args "complex code"
task-prioritizerdecision任务优先级排序npx cogn@2.2.12 run task-prioritizer --args "task1,task2"
api-designerdecisionREST API 设计npx cogn@2.2.12 run api-designer --args "order system"
ui-spec-generatorexplorationUI 规范生成npx cogn@2.2.12 run ui-spec-generator --args "e-commerce homepage"
ui-component-generatorexplorationUI 组件规范npx cogn@2.2.12 run ui-component-generator --args "button component"

下一步​