# 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-08-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

---
title: "Agent 交付框架（v2 通用引导版）"
type: project
status: active
created: "2026-05-13"
updated: "2026-08-02"
---

# Agent 交付框架（v2 通用引导版）

> 一套与 Agent 工具无关的项目交付管理框架。**固定 `.agent/` 文件夹 + 双入口引导 + 环境自适应初始化**——项目被 copy 后丢给任何主流 Agent，Agent 根据自己所处的环境完成全部配置工作。

## 快速开始

1. 复制本模板（`git clone` 或 Gitee「使用此模板创建仓库」）
2. 用任意主流 Agent 打开项目根目录
3. Agent 自动读取入口文件 → 跳转 `.agent/BOOTSTRAP.md` → 检测未初始化 → 按 `.agent/INIT.md` 向导完成初始化（收集项目信息 → 选择能力模块 → 生成上下文与工作区）

支持 Agent：**Codex、Kimi Code、Claude Code、Trae**（直接读取根目录入口文件）；Cursor 等按约定目录加载能力的 Agent，在初始化时生成适配器。

## 目录结构

```
项目根/
├── AGENTS.md          ← 引导入口①（Codex / Kimi Code 读取）
├── CLAUDE.md          ← 引导入口②（Claude Code / Trae 读取）
├── README.md          ← 本文件（含初始化验证）
├── .agent/            ← ★ 唯一核心文件夹（所有能力）
│   ├── BOOTSTRAP.md   ← 环境检测 + 配置决策树（一切从这里开始）
│   ├── INIT.md        ← 交互式初始化引导（向导式）
│   ├── project-context.md ← 项目上下文（INIT 生成，Agent 工作前必读）
│   ├── RULES/         ← 核心规则（红线 / 元数据 / Skill 设计规范）
│   ├── SKILLS/        ← 中性能力包（SKILL.md 格式，任何 Agent 可读可执行）
│   ├── COMMANDS/      ← 端到端工作流（文档流水线等）
│   ├── HANDOFFS/      ← 阶段交接文件（解决长流程遗忘）
│   ├── TEMPLATES/     ← 上下文 / 工作日志模板
│   └── scripts/       ← 确定性脚本（selftest 等）
├── 工作日志/           ← 项目数据区（INIT 生成，Agent 主动维护）
├── 交付物/
├── 过程文档/
└── 里程碑/
```

## 核心能力

### 核心模块（必选，6 项）

| 模块 | 说明 |
| --- | --- |
| init | 初始化（项目上下文生成、工作区、适配器） |
| worklog | 工作日志强制记录 |
| weekly-report | 周报生成（读工作日志自动生成） |
| decision-record | 决策记录 |
| knowledge-update | 知识沉淀 |
| handoffs | 阶段交接机制 |

### 可选模块（INIT 向导勾选）

- 文档流水线：doc-plan / doc-write / doc-review / doc-lint / doc-import / md2docx
- 项目过程：meeting-minutes / retrospective / wbs-create / task-closure / progress-report

## 初始化验证

> 每次初始化后请在此登记，确保框架在对应 Agent 上可用。

### 方式一：selftest 模拟（无需真实 Agent）

```bash
bash .agent/scripts/selftest.sh
```

模拟「未初始化项目 → Agent 引导 → 初始化」流程，断言产物（项目上下文、工作区目录、Skill 注册表）是否生成。任何 Agent 环境均可运行。

### 方式二：真机验证矩阵

| Agent | 入口文件 | 验证日期 | 结果 |
| --- | --- | --- | --- |
| Codex | AGENTS.md | 2026-08-02 | 通过（本机 Codex 实测初始化，产物完整） |
| Kimi Code | AGENTS.md | 2026-08-02 | 通过（Kimi Code 实测初始化，产物完整） |
| Claude Code | CLAUDE.md | 待装 | 未验证 |
| Trae | CLAUDE.md | 待测 | 未验证 |
| Cursor | 适配器 | 待测 | 未验证 |

## 设计理念

- **单一真源**：所有能力封装在 `.agent/`，各 Agent 约定目录只放 3-5 行适配器（初始化时由 Agent 生成，模板不预置）
- **文档即代码**：一切文档作为代码纳入 Git 管理，可追溯、可协作
- **上下文主动供给**：上下文由 Agent 主动创建或引入，确保 AI 可读取项目内全部必要信息
- **手动控制上下文**：以最小化原则管理 AI 读取范围，避免无关上下文干扰
- **引导降级**：身份识别失败不阻塞流程，所有 Agent 按同一套引导工作

## 与 v1 的差异

| 维度 | v1（Trae 绑定） | v2（通用引导版） |
| --- | --- | --- |
| 工具绑定 | Trae（`.trae/` + CLAUDE.md） | 工具无关（`.agent/` + 双入口） |
| 初始化 | 手动按 INIT_GUIDE 执行 | Agent 自动检测状态 + 向导式初始化 |
| 能力存放 | `.trae/` | `.agent/`（唯一核心文件夹） |
| PingCode 集成 | 有 | 已移除 |