convez.ai
Agente
fisHarly0

vibe-coding-workflow

fisHarly0/vibe-coding-workflow

Ver no GitHub
InicialPluginScore · de 0 a 100

个人级 Agentic Workflow 方法论:多 Agent 协作 + 长链记忆持久化 + 自我迭代闭环。基于 Claude Code 的可运行实践。

Instalação

$npx convez-ai fisHarly0/vibe-coding-workflow

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 semanas
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

vibe-coding-workflow

一套面向个人开发者的 AI-native 工程化协作方法论 —— 多 Agent 角色化分工 + 长链记忆持久化 + Plan-Act-Observe 闭环验证。

这是什么

本仓库记录了一套围绕 Claude Code 构建的个人级 Agentic Workflow 方法论与可复用模板。它不是一个工具或代码库,而是一套已经在多个生产级项目中验证过的 "AI 接续型工程" 协作范式。

核心目标:让独立开发者在并行推进多个异构项目时,AI 不只是写代码片段的助手,而是承担架构决策、跨会话接续、跨项目调度的真实数字劳动力。

解决的核心痛点

痛点本方案
会话间上下文断裂 —— 每次新对话从零开始HANDOFF.md + MEMORY.md 跨会话记忆持久化
多技术栈认知漂移 —— Web/游戏/Python 频繁切换角色化 Sub-Agent 分工,主对话只做决策
片段级响应不够 —— 需要架构级协同思考Plan-Act-Observe 闭环 + 多 Agent 评审

功能特性

  • 一键自举:把 BOOTSTRAP.md 发给全新电脑上的 AI,它自己生成全部记忆文档并按流程走
  • 三层架构:编排层(Supervisor)+ 执行层(Sub-Agent)+ 持久化记忆层
  • 跨会话接续:轻量 HANDOFF.md 起步,中长线升级为项目档案五件套(30+ 轮接续不失真)
  • 跨项目经验流动:独立经验仓 + 回送四件套闸门(磁盘/索引/体检/自描述),沉淀不腐烂
  • 自我迭代系统:六步闭环让 Agent 从反思中持续改善自身行为
  • 11 类 AI 协作约束:从真实踩坑中冷凝出的工程止损线
  • 完整 SOP 体系:从开新会话到收尾沉淀的标准化操作流程
  • 零依赖:纯 Markdown 文件,不需要安装任何框架或运行时

技术栈

  • 语言:纯 Markdown(无代码)
  • 工具:git(唯一技术依赖)
  • 运行时:无。所有内容是指导性 SOP 和可复用模板,不是可执行程序

快速开始

零配置路径(推荐):让 AI 自己装好这套工作流

把 BOOTSTRAP.md 作为第一条消息发给 Claude Code(任何机器、包括全新电脑),它会自检环境 → 访谈你一轮 → 自己生成 MEMORY.md / CLAUDE.md / 项目档案,然后按本仓库的流程走。你不需要记住任何规则。

下面是手动路径:

第一步:了解架构(5 分钟)

阅读 docs/01-架构总览.md,理解三层架构和多 Agent 角色分工。

第二步:复制模板到你的项目(2 分钟)

从 templates/ 目录复制以下文件到你的项目根目录:

# 复制项目级行为约定
cp templates/CLAUDE.md <你的项目根目录>/CLAUDE.md

# 复制跨会话接续骨架
cp templates/HANDOFF.md <你的项目根目录>/HANDOFF.md

# 复制用户级记忆索引(放到 Claude Code 全局目录)
cp templates/MEMORY.md ~/.claude/MEMORY.md

然后按占位符说明裁剪 CLAUDE.md,填入你的项目信息。

第三步:开第一个会话(1 分钟)

按 sops/03-new-session-onboarding.md 的 A/B/C 决策树选择场景,发送对应的第一条消息。

项目结构

vibe-coding-workflow/
├── BOOTSTRAP.md               # 给 AI 读的自举协议(全新电脑一份文件起步)
├── AI-CONSTRAINTS.md          # 11 类 AI 协作约束总集(最核心文件)
├── README.md                  # 本文件
├── LICENSE                    # MIT 许可证
├── docs/                      # 方法论文档(讲"为什么")
│   ├── 01-架构总览.md         #   三层架构设计
│   ├── 02-长链记忆体系.md     #   MEMORY + 项目档案 + 经验仓 三层记忆
│   ├── 03-工作流闭环.md       #   Plan-Act-Observe 循环
│   ├── 04-工具与具身化.md     #   工具链与 Sub-Agent
│   ├── 05-实践案例.md         #   3 个真实落地案例
│   └── 06-自我迭代机制.md     #   跨会话 Recursive Self-Improvement
├── sops/                      # 可执行 SOP(讲"怎么做")
│   ├── README.md              #   SOP 索引与使用指南
│   ├── 01-context-and-plan-rules.md
│   ├── 02-five-phase-lifecycle.md
│   ├── 03-new-session-onboarding.md
│   ├── 04-multi-agent-collaboration.md
│   ├── 05-modular-localization.md
│   ├── 06-no-test-framework-self-test.md
│   ├── 07-project-archive-five-piece.md
│   └── 08-experience-repo-and-writeback.md
├── templates/                 # 可复用模板
│   ├── CLAUDE.md              #   项目级行为约定模板
│   ├── HANDOFF.md             #   跨会话接续骨架模板
│   └── MEMORY.md              #   用户级记忆索引模板
├── examples/                  # 脱敏示例
│   ├── handoff-godot-sample.md
│   └── memory-sample.md
└── self-iteration/            # 自我迭代系统(六步闭环)
    ├── README.md
    ├── protocol.md            #   Agent 应遵循的指令集
    ├── reflection-log.md      #   任务反思日志
    ├── patterns.md            #   提炼出的模式
    └── pending-updates.md     #   待批准的更新提案

文档索引

方法论(docs/)—— 讲"为什么这么设计"

文档主题
01 - 架构总览三层架构:编排 / 执行 / 持久化记忆
02 - 长链记忆体系三层记忆:MEMORY + 项目档案 + 经验仓
03 - 工作流闭环Plan-Act-Observe 循环
04 - 工具与具身化工具链与 Sub-Agent 角色
05 - 实践案例net-blog / Godot / TripStar 三个落地案例
06 - 自我迭代机制跨会话 Recursive Self-Improvement 雏形

可执行 SOP(sops/)—— 讲"怎么落到日常会话"

编号主题何时翻它
01Context 与 Plan 八条铁律每次新会话开场
02单模块开发五段式 lifecycle写一个具体模块时
03打开新会话的决策树(A/B/C)启会话第一条消息之前
04双 Agent A/B 协作模式中大型项目需要持续多 turn
05多板块项目局部接入项目大到要按板块切独立会话
06无测试框架时的 .mjs 自测项目没装 jest/vitest 但要测纯函数
07项目档案五件套(接续体系)项目进入中长线(10+ 次会话)
08经验沉淀仓与回送四件套并行多项目,经验要跨项目流动

AI 协作约束(顶层)—— 讲"哪些事 AI 不能做、为什么"

AI-CONSTRAINTS.md 是 11 类约束的总集:

编号主题一句话
1Context 与对话生命周期context 是稀缺资源,省着用
2决策边界不可逆/对外可见/预算变化前停下来
3报告诚信没 file@line 的结论 = 想象
4文件修改边界哪些文件只用户改
5可逆性没说就不要 --force
6文本一致性改数值/枚举/路径要 grep 全文
7验证/测试守则不只跑 tsc --noEmit,要全套 build
8沟通与文风不主动加 emoji
9沉淀与提醒义务可迁移经验必须主动提醒沉淀
10INVARIANT 注释体系钉死关键 trade-off 防 LLM 误删
11Secret / 凭据守则PAT/API key/DB 密码永不让用户贴进对话

已落地项目

项目状态验证的核心点详细案例
net-blogLIVE @ hlhaya.cn个人产品几乎从 0 到 1 全流程 AI 主导案例详情
app note Godot 重构版持续迭代HANDOFF.md 长链接续机制,30+ 轮跨会话接续案例详情
TripStar 本地化已部署开源项目深度补丁 + LLM 调用层韧性案例详情

使用说明

复用模板

模板用途使用方式
CLAUDE.md项目级行为约定复制到项目根目录,按占位符裁剪
HANDOFF.md跨会话接续骨架复制到项目根目录,每次会话结束前更新
MEMORY.md用户级记忆索引复制到 ~/.claude/MEMORY.md,长期积累

脱敏示例

自我迭代系统

self-iteration/ 目录包含一套可运行的自我迭代系统,让 Agent 从反思中持续改善自身行为。详见 self-iteration/README.md。

阅读路径

最快上手:把 BOOTSTRAP.md 直接发给你的 AI,剩下的它来做

第一次接触:README.md(本文件) → docs/01-架构总览.md → sops/03-new-session-onboarding.md

开始使用:复制 templates/ → 按 sops/03 的 A/B/C 场景开第一个会话

深入理解:按需阅读 docs/ 和 sops/ 中的文档

查阅约束:遇到边界问题查 AI-CONSTRAINTS.md

常见问题

Q: 这和 GitHub Copilot / Cursor 有什么区别?

Copilot / Cursor 是代码补全工具,每次对话独立。本工作流解决的是跨会话记忆接续、多 Agent 协作、架构级决策闭环的问题。两者可以并行使用。

Q: 必须用 Claude Code 吗?

本方法论围绕 Claude Code 设计(利用其 Sub-Agent、plan mode、compact 等原生能力),但核心思想(HANDOFF 接续、MEMORY 持久化、约束体系)可以适配其他 Agent 工具。

Q: 手里的项目已经写了一半,还能接入吗?

可以。按 sops/05-多板块项目局部接入 操作,不需要推倒重来。

Q: self-iteration 系统安全吗?

安全。第 5 步(Apply 到 CLAUDE.md / MEMORY.md)必须人类批准,Agent 不能跳过。详见 self-iteration/README.md 的安全护栏。

贡献指南

这是一个个人方法论仓库,欢迎参考和使用。如果你有改进建议:

  1. Fork 本仓库
  2. 创建你的特性分支
  3. 提交 Pull Request 并说明改进理由

由于这是方法论文档而非代码项目,请确保任何修改都有明确的实践依据。

许可证

MIT License - Copyright (c) 2026 Harly

Ver o original no GitHub

Bom para

Relacionados