# timus_agentic_app_apaf

**Repository Path**: timuspace/timus_agentic_app_apaf

## Basic Information

- **Project Name**: timus_agentic_app_apaf
- **Description**: APAF（Agentic Project Agile Framework）是面向AI时代的敏捷项目管理框架。与传统PMI以"过程组"驱动不同，APAF以"项目集"驱动，更适合多项目并行、资源协同的企业级项目管理场景。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-14
- **Last Updated**: 2026-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agentic Project Agile Framework（APAF）

> **定位**：AI时代的敏捷项目管理框架，以项目集驱动资源协同与现金流管理。


---


## 目录结构


```
timus_agentic_app_apaf/
├── Portfolio/                        # 项目集管理模块
│   ├── Dify/                         # Dify工作流配置
│   │   ├── TIMUS.A.1-PMO.yml        # Agent: 项目集经理
│   │   ├── TIMUS.A.2-FINS.yml       # Agent: 财务经理
│   │   ├── TIMUS.S.1-PROGRAM.yml    # Skill: 项目集数据表
│   │   ├── TIMUS.S.2-PROJECT.yml    # Skill: 项目数据表
│   │   ├── TIMUS.S.3-INCOME_FLOW.yml # Skill: 应收流水
│   │   └── TIMUS.S.4-PAYMENT_FLOW.yml # Skill: 应付流水
│   ├── Lark/                         # 飞书多维表格配置
│   │   └── TIMUS.APAF.PROGRAM.base  # 项目集管理表格
│   └── schema.yaml                   # 数据表结构定义
│
├── Project/                          # 项目管理模块
│   ├── Dify/                         # Dify工作流配置
│   │   ├── TIMUS.A.PM.yml           # Agent: 项目经理
│   │   ├── TIMUS.S.PROJECT.yml      # Skill: 项目数据表
│   │   ├── TIMUS.S.MILESTONE.yml    # Skill: 里程碑数据表
│   │   └── TIMUS.S.WBS.yml          # Skill: WBS数据表
│   ├── Lark/                         # 飞书多维表格配置
│   │   └── TIMUS.APAF.PROJECT.base  # 项目管理表格
│   └── schema.yaml                   # 数据表结构定义
│
└── README.md                         # 项目说明文档
```


### 文件命名规则


| 前缀 | 含义 | 说明 |
|------|------|------|
| `TIMUS.A` | Agent | 智能体的本体，定义角色和指令 |
| `TIMUS.S` | Skill | 智能体的技能，定义数据表和工作流 |


**示例：**
- `TIMUS.A.1-PMO.yml`：项目集经理Agent（智能体本体）
- `TIMUS.S.1-PROGRAM.yml`：项目集数据表（智能体技能）


### 目录说明


| 目录 | 说明 |
|------|------|
| `Portfolio/` | 项目集管理模块，包含项目集经理（Agent）和财务经理（Agent）及其技能（Skill） |
| `Project/` | 项目管理模块，包含项目经理（Agent）及其技能（Skill） |
| `Dify/` | Dify工作流配置文件（.yml格式），包含Agent和Skill定义 |
| `Lark/` | 飞书多维表格配置文件（.base格式），定义数据展示和协作 |
| `schema.yaml` | 数据表结构定义，包含字段名、类型、标签 |


### Agent与Skill对应关系


| Agent（智能体本体） | Skill（智能体技能） | 说明 |
|---------------------|---------------------|------|
| TIMUS.A.1-PMO | TIMUS.S.1-PROGRAM, TIMUS.S.2-PROJECT | 项目集经理管理项目集和项目 |
| TIMUS.A.1-PMO | TIMUS.S.3-INCOME_FLOW, TIMUS.S.4-PAYMENT_FLOW | 项目集经理管理应收应付 |
| TIMUS.A.2-FINS | TIMUS.S.3-INCOME_FLOW, TIMUS.S.4-PAYMENT_FLOW | 财务经理管理实收实付 |
| TIMUS.A.PM | TIMUS.S.PROJECT, TIMUS.S.MILESTONE, TIMUS.S.WBS | 项目经理管理项目、里程碑和WBS |


---


## 使用方式


### 前置条件


- Dify账号（https://dify.ai）
- 飞书账号（https://www.feishu.cn）
- Timus平台访问权限（https://timus.chat）


### 安装步骤


#### 步骤1：安装Dify和飞书文件


1. 登录Dify平台
2. 导入工作流配置文件：
   - `Portfolio/Dify/TIMUS.A.1-PMO.yml`（项目集经理Agent）
   - `Portfolio/Dify/TIMUS.A.2-FINS.yml`（财务经理Agent）
   - `Project/Dify/TIMUS.A.PM.yml`（项目经理Agent）
3. 导入数据表配置文件：
   - `Portfolio/Dify/TIMUS.S.1-PROGRAM.yml`
   - `Portfolio/Dify/TIMUS.S.2-PROJECT.yml`
   - `Portfolio/Dify/TIMUS.S.3-INCOME_FLOW.yml`
   - `Portfolio/Dify/TIMUS.S.4-PAYMENT_FLOW.yml`
   - `Project/Dify/TIMUS.S.PROJECT.yml`
   - `Project/Dify/TIMUS.S.MILESTONE.yml`
   - `Project/Dify/TIMUS.S.WBS.yml`


#### 步骤2：配置Timus


1. 登录Timus平台
2. 按照操作手册配置数据源
3. 关联Dify工作流
4. 配置权限和角色


#### 步骤3：创建飞书机器人


创建3个飞书机器人，分别对应3个角色：


| 机器人名称 | 对应角色 | 功能说明 |
|------------|----------|----------|
| 项目集经理 | PMO | 创建项目集、项目、应收、应付 |
| 项目经理 | PM | 创建里程碑、WBS任务 |
| 财务经理 | Finance | 创建实收、实付 |


**创建步骤：**


1. 登录飞书开放平台（https://open.feishu.cn）
2. 创建企业自建应用
3. 配置机器人能力
4. 配置消息卡片模板
5. 配置事件订阅
6. 发布上线


---


## 技术架构


### 系统集成图


```mermaid
graph TB
    subgraph 用户层
        U1[项目集经理]
        U2[财务经理]
        U3[项目经理]
    end
    
    subgraph 飞书层
        B1[飞书机器人1]
        B2[飞书机器人2]
        B3[飞书机器人3]
        T[飞书多维表格]
    end
    
    subgraph Timus层
        TIMUS[Timus平台]
        A1[Agent: PMO]
        A2[Agent: FINS]
        A3[Agent: PM]
        S1[Skill: 数据表]
        S2[Skill: 工作流]
    end
    
    subgraph Dify层
        DIFY[Dify平台]
        W1[工作流配置]
        W2[AI模型]
    end
    
    U1 --> B1
    U2 --> B2
    U3 --> B3
    B1 --> TIMUS
    B2 --> TIMUS
    B3 --> TIMUS
    TIMUS --> A1
    TIMUS --> A2
    TIMUS --> A3
    A1 --> S1
    A2 --> S1
    A3 --> S1
    A1 --> S2
    A2 --> S2
    A3 --> S2
    S2 --> DIFY
    DIFY --> W1
    DIFY --> W2
    TIMUS --> T
```


### 数据流转图


```mermaid
flowchart LR
    A[客户签约] --> B[项目集立项]
    B --> C[项目立项]
    C --> D[里程碑规划]
    D --> E[WBS执行]
    E --> F[交付验收]
    F --> G[回款确认]
    
    subgraph 财务流
        H[应收生成] --> I[实收到账]
        J[应付生成] --> K[实付出账]
    end
    
    B --> H
    F --> I
    C --> J
    E --> K
```


### 权限模型


```mermaid
graph TB
    subgraph 项目集经理权限
        A1[创建项目集]
        A2[创建项目]
        A3[创建应收]
        A4[创建应付]
        A5[查看利润报表]
    end
    
    subgraph 财务经理权限
        B1[创建实收]
        B2[创建实付]
        B3[查看现金流报表]
    end
    
    subgraph 项目经理权限
        C1[创建里程碑]
        C2[创建WBS]
        C3[批量创建WBS]
        C4[查看项目进度]
    end
```


### 角色协作关系图


```mermaid
graph TB
    PM[项目集经理] --> |分配项目| PM2[项目经理]
    PM --> |发起应收| FM[财务经理]
    FM --> |确认实收| PM
    PM2 --> |交付验收| PM
    PM2 --> |发起应付| FM
    FM --> |确认实付| PM2
```


---


## 框架概述


APAF（Agentic Project Agile Framework）是面向AI时代的敏捷项目管理框架。与传统PMI以"过程组"驱动不同，APAF以"项目集"驱动，更适合多项目并行、资源协同的企业级项目管理场景。

**核心理念**：项目集管钱（应收应付），项目管事（里程碑交付）。项目集是一对多的关系，一个项目集下辖多个项目。


### 适用场景


- **多项目并行**：企业同时运行多个项目，需要统一资源调度
- **资源紧张**：人力资源有限，需要精细化分配和跟踪
- **现金流敏感**：项目利润依赖回款节奏，需要实时监控应收应付
- **敏捷交付**：需要快速响应变化，缩短交付周期
- **AI赋能**：希望利用AI提升项目管理效率


### 核心优势


1. **钱事分离**：项目集管钱（应收应付），项目管事（交付），职责清晰
2. **一对多架构**：一个项目集下辖多个项目，灵活扩展
3. **现金流驱动**：以回款为目标驱动项目交付，确保利润
4. **AI原生**：内置AI Agent，自动化执行重复性任务
5. **轻量简洁**：3个核心角色、6条核心指令，快速上手


### 设计原则


| 原则 | 说明 |
|------|------|
| **钱事分离** | 项目集关注财务（应收应付），项目关注交付（里程碑） |
| **自动化优先** | 能自动化的不手动，减少人为错误 |
| **数据驱动** | 用数据说话，支持决策 |
| **渐进明细** | 从粗到细，逐步细化 |
| **角色最小化** | 减少角色数量，降低协作复杂度 |


---


## 两层架构


```mermaid
graph TB
    subgraph 项目集管理
        PM[项目集经理]
        FM[财务经理]
        PM --> |立项| Program[项目集]
        FM --> |收付款| Program
        Program --> |一对多| Project1[项目1]
        Program --> |一对多| Project2[项目2]
        Program --> |一对多| Project3[项目3]
    end
    
    subgraph 项目管理
        PM2[项目经理]
        Project1 --> |交付| PM2
        Project2 --> |交付| PM2
        Project3 --> |交付| PM2
        PM2 --> |里程碑| M[里程碑]
        PM2 --> |任务| W[WBS工作包]
    end
```


---


## 数据模型


### 核心数据表


| 数据表 | 说明 | 所属模块 |
|--------|------|----------|
| PROGRAM | 项目集表 | Portfolio |
| PROJECT | 项目表 | Portfolio/Project |
| INCOME_FLOW | 应收流水表 | Portfolio |
| PAYMENT_FLOW | 应付流水表 | Portfolio |
| MILESTONE | 里程碑表 | Project |
| WBS | 工作任务表 | Project |


### 数据关系图


```mermaid
erDiagram
    PROGRAM ||--o{ PROJECT : "1对多"
    PROGRAM ||--o{ INCOME_FLOW : "应收"
    PROGRAM ||--o{ PAYMENT_FLOW : "应付"
    PROJECT ||--o{ MILESTONE : "里程碑"
    PROJECT ||--o{ WBS : "工作任务"
    MILESTONE ||--o{ WBS : "包含"
```


---


## 公共指令

| 指令 | 说明 |
|------|------|
| `/clear` | 重置会话 |
| `/help` | 帮助 |


---


## 项目集管理（Program）


### 定义


项目集是多个相关项目的集合，统一管理资源、预算和现金流。


### 核心职责


| 职责           | 说明                       |
| -------------- | -------------------------- |
| **项目集立项** | 确定项目集目标、预算、资源 |
| **项目立项**   | 审批子项目立项，分配资源   |
| **应收管理**   | 管理客户应收款项           |
| **应付管理**   | 管理供应商/分包应付款项    |


---


### 项目集经理


**定义**：项目集经理对项目集整体利润负责，统筹管理多个子项目的资源、预算和现金流。


#### 指令目录

| 指令 | 说明 |
|------|------|
| `/create_program` | 创建项目集 |
| `/create_project` | 创建项目 |
| `/create_receivable` | 创建应收 |
| `/create_payable` | 创建应付 |


#### 1.1 项目集立项（/create_program）


**输入参数：**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| program_code | string | 是 | 项目集代号 |


**立项流程：**


```
进入项目集立项 → 输入项目集代号 → 确认提交
```



#### 1.2 项目立项（/create_project）


**输入参数：**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| program_id | string | 是 | 项目集ID |
| project_type | string | 是 | 业务类型 |
| team | string | 是 | 交付团队 |
| project_name | string | 是 | 项目名称 |


**立项流程：**


```
进入项目集立项 → 选择项目集 → 选择业务类型 → 选择交付团队 → 填写项目名称 → 确认提交
```


#### 1.3 应收应付流水


**输入参数：**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| program_id | string | 是 | 项目集ID |
| point | number | 是 | 点数 |
| type | string | 是 | 类型（应收/应付） |


**流水记录：**


```
进入应收\应付 → 选择项目集 → 填写应收\应付点数 → 确认提交
```


---


### 财务经理


**定义**：财务经理负责项目集的实收实付管理，确保资金流转准确。


#### 指令目录

| 指令 | 说明 |
|------|------|
| `/create_paid_in` | 创建实收 |
| `/create_paid_out` | 创建实付 |


#### 1.4 实收实付流水


**输入参数：**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| program_id | string | 是 | 项目集ID |
| point | number | 是 | 点数 |
| type | string | 是 | 类型（实收/实付） |


**流水记录：**


```
进入实收\实付 → 选择项目集 → 填写实收\实付点数 → 确认提交
```



---


## 项目管理（Project）


### 定义


项目是项目集下的独立交付单元，项目经理对项目交付负责。


### 核心职责


| 职责           | 说明                 | 关键指标         |
| -------------- | -------------------- | ---------------- |
| **接收项目**   | 接收项目集分配的项目 | 项目启动及时率   |
| **里程碑管理** | 管理项目关键里程碑   | 里程碑按时完成率 |
| **WBS管理**    | 管理工作分解结构     | 任务完成率       |
| **应收实收**   | 管理项目级现金流     | 回款率           |



---


### 项目经理


**定义**：项目经理对项目交付负责，管理里程碑和工作任务。


#### 指令目录

| 指令 | 说明 |
|------|------|
| `/create_milestone` | 创建里程碑 |
| `/create_wbs` | 创建任务 |
| `/create_wbs_batch` | 批量创建任务 |


---


#### 2.1 接收项目


**接收流程：**


```
项目集分配的时候，会自动化接收分配的项目
```



#### 2.2 里程碑（/create_milestone）


**输入参数：**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| project_id | string | 是 | 项目ID |
| milestone_name | string | 是 | 里程碑名称 |


**创建里程碑：**

创建里程碑有两种方式：一种是手动创建，另一种在批量创建工作任务的时候，会顺带创建里程碑



**创建里程碑流程：**


```
进入创建里程碑 → 选择项目 → 填写里程碑名称（并展示当前历次里程碑） → 确认提交
```




#### 2.3 批量创建WBS（/create_wbs_batch）

适用于基于已有模板的创建过程。

**输入参数：**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| project_id | string | 是 | 项目ID |
| template_id | string | 是 | 模板ID |


**创建流程：**

```
进入批量创建WBS → 选择项目 → 选择模板 → 自动创建成功
```



#### 2.4 创建WBS（/create_wbs）

适用于逐个创建的过程。

**输入参数：**

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| project_id | string | 是 | 项目ID |
| wbs_name | string | 是 | 工作任务名称 |


**创建流程：**

```
进入创建WBS → 选择项目 → 输入工作任务（自动关联当前里程碑） → 确认创建（自动进入下一个循环）
```



#### 2.5 应收实收流水

项目集会自动分配应收款项，在WBS中定义估点，就可以知道实际支出款项支出情况。


---


## 最佳实践


### 典型使用场景


#### 场景1：新项目集启动

```
1. 项目集经理执行 /create_program 创建项目集
2. 项目集经理执行 /create_project 创建子项目
3. 项目经理执行 /create_milestone 创建里程碑
4. 项目经理执行 /create_wbs_batch 批量创建任务
5. 项目集经理执行 /create_receivable 创建应收
6. 财务经理执行 /create_paid_in 确认实收
```

#### 场景2：项目交付与回款

```
1. 项目经理完成里程碑，执行 /create_wbs 更新任务状态
2. 项目集经理查看应收状态，催促客户回款
3. 财务经理确认到账，执行 /create_paid_in
4. 项目集经理查看利润报表，分析项目集盈利情况
```

#### 场景3：分包商付款

```
1. 项目集经理执行 /create_payable 创建应付
2. 财务经理确认付款，执行 /create_paid_out
3. 项目集经理核对现金流，确保资金平衡
```


### 常见问题解答


**Q1：项目集和项目的关系是什么？**

A：项目集是一对多的关系，一个项目集下辖多个项目。项目集管钱（应收应付），项目管事（里程碑交付）。


**Q2：应收和实收有什么区别？**

A：应收是客户应该付的钱（合同约定），实收是客户实际到账的钱。应收管理由项目集经理负责，实收确认由财务经理负责。


**Q3：如何批量创建任务？**

A：使用 `/create_wbs_batch` 指令，选择项目和模板，系统会自动创建所有任务。


**Q4：里程碑和WBS的关系是什么？**

A：里程碑是项目的关键节点，WBS是具体的工作任务。一个里程碑下可以有多个WBS任务。


**Q5：如何查看项目集利润？**

A：项目集利润 = 实收总额 - 实付总额。系统会自动生成利润报表。


### 故障排除


| 问题 | 原因 | 解决方案 |
|------|------|----------|
| 机器人无响应 | 飞书机器人未启动 | 检查飞书机器人状态，重新发布 |
| 指令执行失败 | 权限不足 | 检查角色权限配置 |
| 数据不同步 | Dify工作流异常 | 检查Dify工作流状态 |
| 无法创建项目集 | 项目集代号重复 | 使用唯一的项目集代号 |
| 应收创建失败 | 项目集不存在 | 先创建项目集再创建应收 |


### 注意事项和限制


| 类别 | 说明 |
|------|------|
| **权限控制** | 每个角色只能执行自己的指令，不能越权操作 |
| **数据一致性** | 应收必须在实收之前创建，应付必须在实付之前创建 |
| **删除限制** | 已有流水记录的项目集不能删除，需先清理流水 |
| **并发控制** | 同一时间只能有一个用户操作同一个项目集 |
| **备份建议** | 定期导出数据，防止数据丢失 |
| **浏览器兼容** | 建议使用 Chrome、Firefox、Edge 最新版本 |


---


## 术语表


| 术语 | 说明 |
|------|------|
| **项目集（Program）** | 多个相关项目的集合，统一管理资源、预算和现金流 |
| **项目（Project）** | 项目集下的独立交付单元 |
| **里程碑（Milestone）** | 项目的关键节点，用于跟踪项目进度 |
| **WBS（Work Breakdown Structure）** | 工作分解结构，具体的工作任务 |
| **应收（Receivable）** | 客户应该付的钱（合同约定） |
| **实收（Paid In）** | 客户实际到账的钱 |
| **应付（Payable）** | 应该付给供应商/分包商的钱 |
| **实付（Paid Out）** | 实际付出的钱 |
| **PMO** | 项目集经理（Program Manager） |
| **FM** | 财务经理（Finance Manager） |
| **PM** | 项目经理（Project Manager） |
| **Agent** | 智能体本体，定义角色和指令 |
| **Skill** | 智能体技能，定义数据表和工作流 |


---


## 贡献指南


### 提交Issue


1. 访问 https://gitee.com/timuspace/timus_agentic_app_apaf/issues
2. 点击"新建Issue"
3. 填写问题描述、复现步骤、期望结果
4. 提交Issue


### 提交PR


1. Fork项目仓库
2. 创建功能分支（`git checkout -b feature/xxx`）
3. 提交更改（`git commit -m 'Add feature xxx'`）
4. 推送到分支（`git push origin feature/xxx`）
5. 创建Pull Request


### 代码规范


- 遵循YAML语法规范
- 添加必要的注释
- 保持文件命名一致性