全栈Agent
协同开发

目录结构示意 Project Layout

一个工作区内同时挂载前后端工程，AI 可直接读取前后端代码作为上下文， 从而理解跨端调用关系、统一修改与联调。

workspace/
├── .codebuddy/                # 规约资产（rules / skills / agents）
├── saas-xproject-frontend/    # 前端工程（Vue 或 React）
└── saas-xproject-backend/     # 后端工程（Java/SpringBoot）

工作流 Workflow

Ardot 原型 → 前端实现 From Prototype to Front-end

以「日志管理」页面为例：左侧为 Ardot 原型设计，右侧为 MCP 驱动生成的前端页面（Vue 3 + Element Plus）。

组织过程资产 · Wiki 管理 Assets in TAPD Wiki

数据库设计文档与接口文档统一沉淀在 TAPD Wiki，作为组织过程资产集中管理、持续更新。

如何移植 How to Port

三步完成移植：复制 rules、skills → 复制 agents → 跑小需求迭代优化。

Skill 通用样板结构 Skill Asset Structure

Skill 复制到目标项目的 .codebuddy/skills/ 下，Agent 角色定义放在 .codebuddy/agents/ 根目录下，即可复用，内部结构如下。

.codebuddy/skills/
└── agent-team-single/
    ├── SKILL.md
    └── templates/          # 4 个产物模板
        ├── plan.md.template
        ├── task.md.template
        ├── checklist.md.template
        └── self-test-report.md.template

.codebuddy/
├── agents/                      # 7 个角色定义（根目录）
│   ├── pm.md
│   ├── requirement-analyst.md
│   ├── solution-architect.md
│   ├── developer.md
│   ├── code-reviewer.md
│   ├── qa-tester.md
│   ├── gate-reviewer.md
│   └── README.md              # 模型矩阵
└── skills/
    └── agent-team-multiple/
        ├── SKILL.md
        └── templates/          # 7 个产物模板
            ├── requirement-analysis.md.template
            ├── plan.md.template
            ├── task.md.template
            ├── checklist.md.template
            ├── code-review.md.template
            ├── gate-review.md.template
            └── self-test-report.md.template

输出归档 · 可审计 Output Archiving & Auditability

Agent 协同开发的每个阶段产物统一归档到任务池，一需求一目录， 需求分析、方案、任务、审查、门禁、自测、SQL 全链路留痕，可随时回溯审计。

# 过程资产沉淀，一需求一目录
.codebuddy/Agent协同/任务池/需求/
└── {yyyMMdd}-{序号}/
    ├── spec-kit/
    │   ├── requirement-analysis.md   # 需求分析
    │   ├── plan.md / task.md          # 方案 / 任务
    │   ├── checklist.md               # 自测清单
    │   ├── code-review.md             # 代码审查
    │   ├── gate-review.md             # 发布门禁
    │   └── *.sql                    # 数据库变更（唯一归档）
    └── {需求ID}.md               # 自测报告

应用场景 When to Use Which

单、多模式应根据情景灵活选用 —— 只有按需匹配，才能同时达到高效率与低成本的效果。

7 角色交接链 Handoff Chain

7 角色岗位职责 Roles & Responsibilities

模型成本矩阵 Cost-aware Model Routing

不同 Agent 角色绑定不同模型 —— 轻量编排用轻量模型，编码用强编码模型，推理用强推理模型，从而节省成本。

7 角色职责与产物 Roles & Artifacts

8 阶段工作流 8-Stage Workflow