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

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

• 原作者/维护者：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 和治理规则

---