# Claude Template：面向 AI 协作开发的工作流模板仓库

> 这是一个用于快速初始化 Claude Code 工作流的模板仓库，提供了一套面向 AI 协作开发的流程、技能与文档治理结构，强调将临时执行状态和长期知识沉淀分开管理。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-28T08:45:58.000Z
- 最近活动: 2026-05-28T08:59:59.200Z
- 热度: 157.8
- 关键词: Claude Code, AI 协作开发, 工作流模板, 项目管理, 知识沉淀, TypeScript, 开发工具
- 页面链接: https://www.zingnex.cn/forum/thread/claude-template-ai
- Canonical: https://www.zingnex.cn/forum/thread/claude-template-ai
- Markdown 来源: ingested_event

---

## 原作者与来源

- **原作者/维护者**：BanKnight
- **来源平台**：GitHub
- **原始标题**：agents-remote（基于 claude-template）
- **原始链接**：https://github.com/BanKnight/agents-remote
- **发布时间**：2026-05-28

---

## 背景与动机

随着 AI 辅助开发工具的普及，越来越多的团队开始探索如何与 AI 进行高效的协作开发。然而，许多团队在实践中遇到了一些共同的问题：

1. **缺乏标准化流程**：每个项目都有自己的一套与 AI 交互的方式，难以复用
2. **临时状态与长期知识混杂**：运行中的任务状态和历史文档混在一起，难以维护
3. **协作链路不清晰**：从需求到实现再到验证，缺乏明确的阶段划分
4. **技能复用困难**：在一个项目中开发的工作流技能难以迁移到其他项目

Claude Template 正是为了解决这些问题而设计的。它提供了一套预组织好的面向 AI 协作开发的流程、技能和文档治理结构，适合作为新项目的起点。

---

## 核心设计理念

### 双区分离

模板最核心的设计理念是将运行态材料与长期文档分开管理：

- **.workflow/**：保存运行态材料，如当前意图池、路线图、活跃变更、验证证据和归档
- **docs/**：保存长期文档，如项目认知、规格说明、设计方案、架构文档和操作手册

这种分离确保了临时执行状态不会混入长期知识库，让需求、设计、实现、验证和归档都有明确的位置。

### 完整的工作流链路

模板定义了从意图到归档的完整工作流链路：

```
Intent → Roadmap → Specify → Design → Build → Verify → Distill → Archive
```

每个阶段都有对应的 Skill 支持，形成固定的协作链路。

---

## 工作流阶段详解

| 阶段 | Skill | 作用 |
|------|-------|------|
| 帮助入口 | help-workflow | 说明工作流能力并推荐下一步 |
| 项目初始化 | setup-workflow | 初始化或更新 .workflow/ 与 docs/ 双区结构 |
| 项目认知 | describe-project | 渐进式补全 docs/project.md |
| 意图澄清 | clarify-intents | 记录尚未进入 roadmap 的原始意图 |
| 路线规划 | plan-roadmap | 编排 versions / changes，并创建 change 骨架 |
| 行为规格 | specify-change | 产出可验证的 WHAT |
| 方案设计 | design-change | 产出 HOW，包括产品、前端、架构、API、数据等子域 |
| 实施计划 | plan-change | 拆解实现计划与任务清单 |
| 实现执行 | implement-change | 按任务实施变更并更新任务状态 |
| 验证验收 | verify-change | 核对实现与 spec / design / tasks 的一致性 |
| 知识沉淀 | distill-change | 将已验证结论沉淀到长期 docs |
| 版本归档 | archive-version | 以 version 为单位冻结并归档上下文 |

---

## 目录结构

```
.
├── .claude/skills/      # Claude Code workflow skills
├── .workflow/             # 运行态：意图池、roadmap、活跃 changes、验证证据和归档
├── docs/                  # 长期文档：项目认知、spec、design、architecture、runbooks
├── CLAUDE.md              # Claude Code 项目入口指令
├── AGENTS.md              # Agent 协作说明
└── GUIDLINES.md           # 项目行为规范
```

---

## 适用场景

这个模板特别适合以下场景：

1. **新项目启动**：需要一套可复制的 Claude Code 协作流程
2. **团队协作**：希望把需求、路线图、设计、实现任务和验证证据串成固定链路
3. **知识管理**：需要区分运行态材料与长期文档，避免临时过程混入长期知识库
4. **技能复用**：想在多个仓库中复用同一套 workflow skills 和治理规则

---

## 技术架构

模板项目包含以下主要组件：

- **api/**：API 相关代码
- **web/**：Web 前端代码
- **e2e/**：端到端测试
- **packages/shared/**：共享包
- **scripts/**：脚本工具
- **docs/**：文档目录
- **.workflow/**：工作流运行态目录
- **.claude/skills/**：Claude Code 技能定义

项目使用 TypeScript 开发，配置了完整的开发工具链：
- oxlint 用于代码检查
- oxfmt 用于代码格式化
- Playwright 用于端到端测试

---

## 使用方式

### 初始化项目

1. 基于模板创建新仓库
2. 运行初始化命令设置工作流结构
3. 根据项目需求定制 workflow skills

### 日常工作流

1. 使用 `clarify-intents` 记录新的想法和需求
2. 通过 `plan-roadmap` 规划版本和变更
3. 使用 `specify-change` 定义具体变更的规格
4. 通过 `design-change` 进行详细设计
5. 使用 `implement-change` 执行实现
6. 通过 `verify-change` 验证实现
7. 使用 `distill-change` 沉淀知识到长期文档
8. 最后通过 `archive-version` 归档版本

---

## 总结与启示

Claude Template 展示了一种系统化的 AI 协作开发方法。它的核心价值在于：

1. **标准化**：提供了一套可复用的工作流标准
2. **结构化**：通过双区分离和阶段划分，让项目管理更加清晰
3. **可扩展**：模块化的 Skill 设计便于根据项目需求定制
4. **可持续性**：强调知识沉淀，确保项目经验能够长期保存和复用

对于正在探索 AI 辅助开发的团队来说，这个模板提供了一个经过深思熟虑的起点，避免了从零开始设计工作流的痛苦。