# agent-delivery-framework

**Repository Path**: clawme/agent-delivery-framework

## Basic Information

- **Project Name**: agent-delivery-framework
- **Description**: Agent 驱动交付项目管理框架 - 种子仓库，clone 后重命名为项目名即可使用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2026-05-13
- **Last Updated**: 2026-06-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

---
title: "Agent 交付框架"
type: template
status: active
created: "2026-05-13"
updated: "2026-05-25"
---

# Agent 交付框架

> 一套基于 AI Agent 的项目交付管理框架。开箱即用，Agent 驱动。

**前提条件**：TRAE IDE（推荐最新版本）、Git 2.0+

## 快速开始

### 方式一：使用模板仓库（推荐）

1. 访问 [Gitee 仓库页面](https://gitee.com/clawme/agent-delivery-framework)
2. 点击 **「使用此模板创建仓库」** 按钮
3. 填写新仓库信息，创建项目
4. 克隆新仓库到本地，用 TRAE 打开
5. Agent 自动检测到未初始化状态，引导你完成项目设置

### 方式二：直接克隆

```bash
git clone https://gitee.com/clawme/agent-delivery-framework.git 我的项目
```

克隆后进入项目目录，Agent 会自动引导初始化。

## 框架内容

```
.
├── CLAUDE.md              ← 项目上下文（Agent 入口）
├── README.md              ← 本文件：框架介绍（给人看）
├── KNOWLEDGE.md           ← 项目知识沉淀（由 `knowledge-update` Skill 维护）
├── .trae/                 ← Agent 约束体系
│   ├── rules/
│   │   ├── core-rules.md       ← Agent 行为红线
│   │   ├── metadata-standard.md ← 文档元数据规范
│   │   └── skill-command-guide.md ← Skill/Command 设计规范
│   ├── commands/          ← 工作流（项目经理可修改）
│   │   ├── _index.md           ← Command 注册表
│   │   └── doc-pipeline.md     ← 文档生成流水线
│   ├── skills/            ← 单元化 Skill（Agent 按需调用）
│   │   ├── _index.md           ← Skill 注册表
│   │   ├── _template/          ← Skill 创建模板
│   │   ├── doc-plan/
│   │   ├── doc-write/
│   │   ├── doc-review/
│   │   ├── doc-lint/           ← 文档客观检查
│   │   ├── doc-import/
│   │   ├── md2docx/
│   │   ├── weekly-report/
│   │   ├── pingcode-weekly-report/
│   │   ├── progress-report/
│   │   ├── wbs-create/
│   │   ├── task-closure/
│   │   ├── knowledge-update/
│   │   ├── meeting-minutes/
│   │   ├── decision-record/
│   │   └── retrospective/
│   ├── handoffs/          ← 阶段交接文件（解决长流程遗忘问题）
│   └── INIT_GUIDE.md      ← 初始化引导流程
├── 工作日志/              ← 每日工作记录
├── 交付物/                ← 最终成品
├── 过程文档/              ← 草稿、历史版本、输入材料
└── 里程碑/                ← 里程碑评审纪要
```

## 核心能力

| 能力 | 说明 | 触发方式 |
|------|------|----------|
| 文档管理 | 规划→图表→撰写→审查→归档全流程 | `/doc-pipeline` |
| 文档客观检查 | 元数据、链接、图片、表格、敏感信息自动检查 | `doc-lint` Skill |
| 文档导入 | 批量导入外部文档 | `doc-import` Skill |
| MD 转 Word | 按 Word 样式模板将 .md 转化为 .docx（自动适配任意样式名） | `md2docx` Skill |
| WBS 创建 | 生成项目工作分解结构 | `wbs-create` Skill |
| 周报生成 | 基于工作日志自动生成周报 | `weekly-report` Skill |
| PingCode 周报 | 从 PingCode API 获取工作项生成周报 | `pingcode-weekly-report` Skill |
| 进度报告 | 里程碑节点进度汇总 | `progress-report` Skill |
| 任务收尾 | 完成检查、日志更新、知识沉淀 | `task-closure` Skill |
| 知识沉淀 | 记录项目经验、决策和踩坑记录到 KNOWLEDGE.md | `knowledge-update` Skill |
| 决策记录 | 记录技术选型与方案决策 | `decision-record` Skill |
| 会议纪要 | 会议内容结构化整理 | `meeting-minutes` Skill |
| 复盘回顾 | 项目阶段总结与反思 | `retrospective` Skill |

## Skill 与 Command 边界

本框架将 Agent 能力拆为两层：

| 类型 | 职责边界 |
|------|----------|
| **Command** | 面向人的端到端工作流。从一条指令到最终交付，自动编排多步操作 |
| **Skill** | 面向 Command 的原子能力。封装单一专业操作，按需组合调用 |

> **详细规范**：创建或修改 Skill/Command 时，请阅读 `.trae/rules/skill-command-guide.md`。

## 设计理念

- **文档即代码**：一切文档作为代码纳入 Git 管理，随项目版本化、可追溯、可协作
- **上下文主动供给**：所有上下文由 Agent 主动创建或引入，确保 AI 可自由读取项目内的全部必要信息
- **手动控制上下文**：以最小化原则主动管理 AI 读取范围，只加载当前任务必要的信息，避免无关上下文干扰

## 与 PingCode 的分工

| 维度 | PingCode | 本框架 |
|------|----------|--------|
| 需求/任务/风险 | 录入、跟踪、管理 | 生成分析文档 |
| 里程碑 | 设定、更新状态 | 评审纪要 |
| 周报/进度报告 | — | 生成文档 |
| WBS | 工作项管理 | WBS 文档 |
| 知识沉淀 | — | KNOWLEDGE.md |