Claude Code
CO(认知编排)适用于任何专业领域:研究、金融、教育、合规、治理。本快速入门聚焦 COC,即面向代码生成的应用。若你从事其他领域,请参阅 CO 领域应用(英文)以及用于构建自有应用的 CO 模板(英文)。
使用泰睿基金会软件进行构建的最快方式是 COC(面向代码生成的认知编排),一种以 Claude Code 作为实施伙伴的 AI 辅助开发方法论。你描述想要构建的内容,COC 负责调研、规划、实现、测试与部署,而你在每一个决策点仍掌握主动权。
COC 不是简单的封装或聊天机器人,而是一套完整的开发环境:30 多个专业代理、框架感知技能、自动化代码评审、测试驱动实现,以及将项目从构想推进到生产的阶段化工作流。
COC 入门
Section titled “COC 入门”1. 安装 Claude Code
Section titled “1. 安装 Claude Code”COC 与 Anthropic 的命令行开发工具 Claude Code(英文)配合使用效果最佳。
npm install -g @anthropic-ai/claude-code你需要一个 Anthropic API key,或一个 Claude Pro/Team 订阅。具体配置步骤见 Claude Code 文档(英文)。
2. 基于 COC 模板创建项目
Section titled “2. 基于 COC 模板创建项目”COC 模板仓库已预置全部配置:代理、技能、规则、钩子以及阶段化工作流。这是任何新项目的起点。
git clone https://github.com/terrene-foundation/kailash-coc-claude-py.git my-projectcd my-project这就是全部配置过程。COC 模板仓库已按 CO 规范完成预配置:代理(意图层)、技能(上下文层)、规则(软性护栏)、钩子(硬性护栏)以及用于实现 CO 要求的结构化工作流的阶段化命令。无需额外配置。
你不需要克隆 kailash-py(SDK 源代码)。COC 模板就是你的项目模板;它会在需要时将 SDK 作为依赖引入。
3. 启动第一次会话
Section titled “3. 启动第一次会话”在仓库根目录下启动 Claude Code:
claude随后输入 /start。COC 将进行自我介绍、讲解工作流,并询问你想要构建的内容。
4. COC 工作流
Section titled “4. COC 工作流”COC 采用阶段化方法。每个阶段产出工件,且每次阶段切换都需要你的批准。未经你确认,流程不会继续。
| 阶段 | 命令 | 功能 |
|---|---|---|
/start | 入门说明。COC 介绍工作方式并询问项目信息。 | |
| 01 分析 | /analyze | 深度研究。COC 调研你的构想、识别失败点、参考既有模式,产出策略文档。 |
| 02 规划 | /todos | 路线图。COC 将策略拆解为有序的里程碑与任务,由你审阅、调整、批准。 |
| 03 执行 | /implement | 构建。COC 逐个处理任务,编写代码、测试与文档。可反复运行。 |
| 04 评审 | /redteam | 对抗性测试。COC 自我攻击项目、发现缺口,并产出最终交付物。 |
| 05 学习 | /codify | 知识沉淀。COC 将所学内容提取至 .claude/ 构件,令下一次会话起点更高。 |
| 06 交付 | /deploy | 上线。COC 引导完成部署准备、预发环境验证与正式发布。 |
两次会话之间运行 /wrapup 保存进度。下一次会话将恰好从中断之处继续。
5. COC 提供的能力
Section titled “5. COC 提供的能力”专业代理。 COC 拥有 30 多个按领域组织的代理。需要数据库操作时,由 dataflow-specialist 负责;需要 API 时,由 nexus-specialist 构建;需要 AI 代理逻辑时,由 kaizen-specialist 接手。你无需了解应调用哪个代理,COC 会基于任务需求自动路由。
框架优先开发。 在从零编写代码之前,COC 会先检查 Kailash SDK 是否已有现成方案。SDK 提供 140 多个工作流节点、零配置数据库操作、多通道 API 部署,以及完整的 AI 代理框架,COC 对这些均已掌握。
测试驱动实现。 每个功能先写测试、后写实现。tdd-implementer 代理先编写测试,再编写使其通过的代码;testing-specialist 管理三层测试策略:单元测试、基于真实基础设施的集成测试,以及端到端测试。
自动化评审。 每次变更之后,intermediate-reviewer 代理执行代码评审;每次提交之前,security-reviewer 代理检查漏洞、泄漏的凭据与注入风险。全过程自动进行,你无需额外请求。
会话连续性。 COC 能跨会话保留上下文。工作区状态、已完成任务、所学模式与会话备忘全部持久化。一个分十次会话完成的项目,在体验上像一次持续对话。
Kailash SDK 生态
Section titled “Kailash SDK 生态”COC 基于 Kailash SDK 栈构建。这是它所依赖的框架:
| 框架 | 功能 | 安装 |
|---|---|---|
| Kailash Core | 工作流编排,内置 140 多个节点、运行时执行、错误恢复与约束传播,是整个栈的基础。 | pip install kailash |
| DataFlow | 零配置数据库操作。定义一个模型即可自动获得 CRUD 节点,无需手写 SQL、ORM 配置或迁移脚本。 | pip install kailash-dataflow |
| Nexus | 基于单一定义,将任意工作流同时部署为 API 端点、CLI 命令与 MCP 工具。 | pip install kailash-nexus |
| Kaizen | AI 代理框架。签名、多代理协作、工具使用与结构化输出,全部构建于 Kailash 工作流引擎之上。 | pip install kailash-kaizen |
使用 COC 时,你很少需要手动安装这些包。COC 负责管理依赖、为每个任务选择合适的框架,并编写集成代码。
直接使用 SDK
Section titled “直接使用 SDK”如果你更倾向于不借助 COC 而直接使用 SDK,它可独立工作:
pip install kailashfrom kailash import LocalRuntime, WorkflowBuilder
workflow = WorkflowBuilder()workflow.add_node("NodeType", "my_node", {"param": "value"})
runtime = LocalRuntime()results, run_id = runtime.execute(workflow.build())SDK 本身文档齐备、可独立使用。但推荐的开发体验仍是 COC:它深入理解 SDK、处理样板代码、提前捕获错误,并显著快于纯手工开发。
- 立即试用 COC: 克隆 COC 模板(英文),运行
claude,输入/start。 - 浏览 SDK 源代码: github.com/terrene-foundation/kailash-py(英文)
- 阅读规范: CARE 规范(英文)、EATP 协议(英文)与 CO 方法论(英文),定义了上述软件所实现的思想体系。
- 参与其中: 在任一基金会仓库(英文)提交 issue,或发送邮件至 jack@terrene.foundation。