PM-Agents

Multi-agent R&D and test quality management platform · Open-source template

多 Agent 研发与测试质量管理平台 · 开源模板

Integrates Feishu Bitable · Feishu Wiki · Feishu Drive · Jira · CI/CD

English · 中文

English

Overview

PM-Agents is an open-source quality management template for software R&D teams. It integrates seven specialized Agents with mainstream collaboration tools, enabling automated workflows across requirements, development, testing, and quality.

Core principle: Tools are the means, closed loops are the goal. Every workflow has a clear start, executor, end condition, and next-step trigger — no dangling processes.

Applicable scenarios: Medium-to-large software R&D teams, especially in automotive electronics, consumer electronics, and other domains that manage physical resources (vehicles / benches / devices). Also adaptable for pure-software teams.

Core Capabilities

Capability	Description
7 Agent Roles	Requirement / Dev / Test / Quality / Resource / People / Knowledge — clear functional boundaries
Feishu Bitable	All structured data stored here, real-time multi-party collaboration
Feishu Wiki	SOP docs, case Wiki, debugging manuals, AI Q&A support
Feishu Drive	Bug evidence, build artifacts, test reports — centralized attachments
CI/CD Integration	Build results written back to data platform, auto-block on threshold breach
Feishu Bot Notifications	12 automated push categories, private-message query support

System Architecture

┌─────────────────────────────────────────────────────────────────────┐
│                       Master Agent (Dispatcher)                      │
│    Receive input → Route sub-Agents → Aggregate results →             │
│    Drive Dashboard / Robot                                            │
└──────┬───────┬───────┬───────┬───────┬───────┬───────────────────────┘
       │       │       │       │       │       │
  ┌────▼──┐ ┌──▼──┐ ┌──▼──┐ ┌─▼──┐ ┌──▼──┐ ┌─▼──┐ ┌──▼──┐
  │Reqt.  │ │ Dev │ │Test │ │Qual│ │Res. │ │Ppl.│ │Know.│
  │Mgmt   │ │Mgmt │ │Mgmt │ │Ctrl│ │Mgmt │ │Mgmt│ │Mgmt │
  └────┬──┘ └──┬──┘ └──┬──┘ └─┬──┘ └──┬──┘ └─┬──┘ └──┬──┘
       │       │       │      │       │      │       │
       └───────┴───────┴──────┴───────┴──────┴───────┘
                               │
        ┌──────────────────────┼──────────────────────┐
        ▼                      ▼                      ▼
  ┌──────────┐          ┌──────────┐          ┌──────────┐
  │ Feishu   │          │ Feishu   │          │ Feishu   │
  │ Bitable  │          │ Wiki     │          │ Drive    │
  │(struct.) │          │ (docs)   │          │ (files)  │
  └──────────┘          └──────────┘          └──────────┘
        │                                          │
        ▼                                          ▼
  ┌──────────┐
  │  Jira    │
  │ (Bug trk)│
  └──────────┘

Eight foundational entities: Feature · Build · TestCase · Bug · Version · Resource · Person · Knowledge

All processes, Agents, and tools are services built around these eight entities.

Tool Responsibilities

Tool	Stores	Used By
Feishu Bitable	Structured records for Feature / Build / TestCase / Bug / Version / Resource / Person	All Agents
Feishu Wiki	SOP docs, case Wiki, debugging manuals, templates	Knowledge Mgmt Agent
Feishu Drive	Bug evidence (screenshots/logs/recordings), build artifacts, milestone reports, release packages	Quality Ctrl + Dev Mgmt Agent
Jira	Bug detail tracking, two-way sync with Bitable	Quality Ctrl Agent
CI/CD Pipeline	Build triggers, smoke execution, result push	Dev Mgmt Agent
Feishu Bot	Notification push, private-message query	Master Agent

Project Structure

pm-agents/
│
├── README.md                          ← This file (bilingual project docs)
├── LICENSE                            ← MIT License
├── CONTRIBUTING.md                    ← Contribution guide
├── CHANGELOG.md                       ← Version changelog
├── .gitignore                         ← Ignores .env / __pycache__ / .DS_Store etc.
├── .env.example                       ← Environment variable template (no real credentials)
│
├── docs/                              ← All documentation
│   ├── architecture.md                ← System design
│   ├── quick-start.md                 ← 5-minute quickstart
│   ├── event-protocol.md              ← inter-Agent event protocol
│   ├── permission-matrix.md           ← Roles & permissions
│   └── integrations/                  ← Integration guides
│
├── agents/                            ← Agent definitions & knowledge dirs
│   ├── master/
│   ├── requirement/
│   ├── dev/
│   ├── test/
│   ├── quality/
│   ├── resource/
│   ├── people/
│   └── knowledge/
│
├── tools/                             ← Integration scripts
│   ├── feishu/                        ← Feishu API utilities
│   └── ci/                            ← CI/CD pipeline scripts
│
├── templates/                         ← Reusable templates
│   ├── feishu-tables/                 ← Feishu Bitable field templates
│   ├── test-cases/                    ← Gherkin test case templates
│   └── reports/                       ← Milestone test report templates
│
└── examples/                          ← Reference implementations
    ├── automotive/                    ← Automotive OEM scenario
    └── generic/                       ← Generic software team

Seven Agent Boundaries

Lifecycle Pipeline

Reqt. Mgmt  →  Dev Mgmt  →  Test Mgmt  →  Quality Ctrl
 (what to do)  (how to do)  (how to verify)(ship or not)
                                         ↑
                              External issues ─┘

Cross-cutting Support

Resource Mgmt   Vehicles / benches / physical devices, supporting Dev & Test
People Mgmt     Personnel matrix / gap analysis / certification, all phases
Knowledge Mgmt  Case accumulation / doc retrieval / AI Q&A, all phases

Feishu Trio分工

Feishu Bitable (Structured Data)

All statistical, filterable, auto-calculable records:

Feature master library, milestone execution details
TestCase three-layer library
Bug library (two-way sync with Jira)
Version ledger, build records
Vehicle/bench ledger, personnel matrix

Feishu Wiki (Documents & Knowledge)

Narrative and procedural content:

SOP docs for each Agent
Case Wiki (7-section structure, mandatory on Bug close)
Debugging manuals, module technical docs
New-hire required reading path

Feishu Drive (Files & Attachments)

Binary large objects:

Bug evidence: screenshots / logs / recordings (mandatory before Bug close)
Build artifacts: CI-generated installers / OTA diff packages
Milestone test reports (PDF, signed and archived)
Release packages (organized by version number)

Inter-Agent Event Protocol

All Agents communicate via Feishu bot Webhook or internal message queue with a unified format:

{
  "event_type": "feature.submitted",
  "source_agent": "requirement",
  "target_agent": ["dev", "test"],
  "entity_type": "Feature",
  "entity_id": "HMI_001_HVAC_AUTO",
  "payload": { ... },
  "timestamp": "2026-04-03T10:00:00+08:00",
  "priority": "normal"
}

Core Event List:

Event	Sender	Receiver	Trigger
`feature.submitted`	Reqt. Mgmt	Dev + Test Mgmt	Feature status → "ready for test"
`feature.milestone.delayed`	Reqt. Mgmt	Master	Milestone marked delayed
`build.succeeded`	Dev Mgmt	Test Mgmt	Build success, new version available
`build.failed`	Dev Mgmt	Master	Build/smoke failure
`build.blocked`	Dev Mgmt	Reqt. Mgmt + Quality Ctrl	Smoke pass rate below threshold
`testcase.result.updated`	Test Mgmt	Quality Ctrl	Execution record updated
`milestone.dippr.alert`	Test Mgmt	Master	DI/PI/PR below target by 15%
`bug.created`	Quality Ctrl	Dev + Reqt. Mgmt	New Bug entered
`bug.sla.exceeded`	Quality Ctrl	Master	Bug exceeds SLA
`bug.closed`	Quality Ctrl	Knowledge Mgmt	Bug closed, triggers knowledge accumulation
`version.released`	Quality Ctrl	Master + Reqt. Mgmt	Version officially released
`resource.shortage`	Resource Mgmt	Master	Vehicle/bench gap > 0
`person.uncertified`	People Mgmt	Knowledge Mgmt	New hire pending certification
`knowledge.stale`	Knowledge Mgmt	Master	Entry not updated for 90 days

Permission Matrix

Role Definitions

Role	Description
`admin`	System administrator, full access
`project-manager`	Project manager, read-all, approve changes/releases
`domain-lead`	Domain lead, manages domain Features/Bugs
`test-engineer`	Test engineer, executes cases, submits Bugs
`dev-engineer`	Dev engineer, updates Bug fix status, submits Builds
`resource-admin`	Resource admin, manages vehicle/bench ledger
`readonly`	Read-only, for partner progress viewing

Feishu Bitable Permissions

Table	PM	domain-lead	test-eng	dev-eng	readonly
Feature Master	RW	Domain RW	RO	RO	RO
TestCase Library	RW	Domain RW	RW	RO	RO
Bug Library	RW	RW	Create+Update	Update fix status	RO
Version Ledger	RW	RO	RO	RO	RO
Vehicle/Bench Ledger	RW	RO	RO	RO	RO
Personnel Matrix	RW	Domain RO	RO	RO	Denied

Complete Closed-Loop Checklist (15 Items)

#	Scenario	Closed-loop Design	Responsible Agent
1	Requirement change	Freeze change → notify stakeholders → mandatory confirmation	Reqt. Mgmt
2	Spread verification	Each vehicle model confirms, all must complete to close	Quality Ctrl
3	Bug experience沉淀	Blocker/Critical must link knowledge entry before close	Quality + Knowledge Mgmt
4	Bug evidence archiving	Must upload evidence to Drive before Bug close (screenshot/log/recording)	Quality Ctrl + Drive
5	Material shortage to fulfillment	Gap → purchase order → receipt confirmation → zero out	Resource Mgmt
6	Bench gap to replenishment	Gap calc → purchase task → replenish and close	Resource Mgmt
7	Onboarding certification	No system access without certification	People + Knowledge Mgmt
8	Performance regression	CI/CT auto-compares baseline, threshold breach blocks	Dev + Quality Ctrl
9	Version release archiving	Multi-party signing + PDF report archived to Drive	Quality Ctrl
10	Vehicle fault to recovery	Repair complete → notify wait queue	Resource Mgmt
11	Case review & admission	New cases require test lead approval	Test Mgmt
12	Bug root cause to prevention	Prevention mandatory + knowledge entry	Quality + Knowledge Mgmt
13	CI/CD anomaly to Bug	Visual/log anomaly → auto capture + upload → create Bug	Test Mgmt + CI/CD
14	Build artifact archiving	Each successful build → CI auto-uploads artifacts to Drive	Dev Mgmt + Drive
15	Unresponsive event monitoring	Key event unacknowledged after 30 min → Master alerts	Master

Implementation Roadmap

Phase 1 — Data Foundation (Week 1–4)

Feishu Bitable: Create 8 core tables
Feishu Drive: Create directory structure (bugs/ builds/ reports/ releases/)
Feishu Wiki: Upload all Agent knowledge docs
.env.example configuration, tool API credentials ready
Shared vehicle reservation process live
CI build results → Feishu Bitable write-back

Phase 2 — Processes & Closed Loops (Week 5–12)

Phase 3 — Intelligence (Week 13–24)

Test Mgmt: AI test case generation (Feature description → Gherkin)
Quality Ctrl: AI log attribution (App → FW → HAL → CAN full chain)
Knowledge Mgmt: LLM integration, natural language knowledge retrieval
Dev Mgmt: OTA gray push automation
Dashboard full version (DORA metrics + DI/PI/PR trends + external issue KPI)
Robot full version: Dialog query + milestone weekly report + entry update reminder

Quick Start

# 1. Clone the repo
git clone https://github.com/your-org/pm-agents.git
cd pm-agents

# 2. Configure environment
cp .env.example .env
# Edit .env, fill in Feishu AppID/Secret, Jira Token, etc.

# 3. Install dependencies
pip install -r tools/feishu/requirements.txt

# 4. Create tables (Feishu Bitable)
python tools/feishu/setup_tables.py

# 5. See docs/quick-start.md for further configuration

Full deployment docs: docs/quick-start.md

Reference Implementation

This project is derived from a real-world automotive OEM R&D and test quality management scenario. See examples/automotive/ for industry-adapted configuration.

For generic software team configuration, see examples/generic/.

Contributing

Issues and Pull Requests are welcome. Please read CONTRIBUTING.md first.

License

Version: v1.0 Updated: 2026-04-03

中文

项目简介

PM-Agents 是一套面向软件研发团队的开源质量管理模板，将七个专责 Agent 与主流协作工具深度集成，让需求、研发、测试、质量全链路自动流转，实现研发测试全链路自动化。

核心理念：工具是手段，闭环是目的。每条工作流都有明确的起点、执行者、结束条件和下一步触发，不留悬空。

适用场景：中大型软件研发团队，尤其适合汽车电子、消费电子等需要管理实物资源（车/台架/设备）的场景，也可通用于纯软件团队。

核心能力一览

能力	说明
7 Agent 分工	需求/研发/测试/质量/资源/人力/知识，职能边界清晰
飞书多维表格	所有结构化数据存储于此，多方实时协作
飞书知识库	SOP 文档、案例Wiki、调试手册，支持 AI 问答
飞书云盘	Bug 证据、构建产物、测试报告，附件集中归档
Jira 双向同步	Bug 在飞书多维表格与 Jira 之间实时同步
CI/CD 集成	构建结果自动写回数据平台，超阈值自动 block
飞书机器人通知	12 类自动推送，支持私信对话查询

系统架构

┌─────────────────────────────────────────────────────────────────────┐
│                       Master Agent（总调度）                          │
│    接收输入 → 路由子 Agent → 汇聚结果 → 驱动 Dashboard / Robot        │
└──────┬───────┬───────┬───────┬───────┬───────┬───────────────────────┘
       │       │       │       │       │       │
  ┌────▼──┐ ┌──▼──┐ ┌──▼──┐ ┌─▼──┐ ┌──▼──┐ ┌─▼──┐ ┌──▼──┐
  │需求   │ │研发 │ │测试 │ │质量│ │资源 │ │人力│ │知识 │
  │管理   │ │管理 │ │管理 │ │管控│ │管理 │ │管理│ │管理 │
  └────┬──┘ └──┬──┘ └──┬──┘ └─┬──┘ └──┬──┘ └─┬──┘ └──┬──┘
       │       │       │      │       │      │       │
       └───────┴───────┴──────┴───────┴──────┴───────┘
                               │
        ┌──────────────────────┼──────────────────────┐
        ▼                      ▼                      ▼
  ┌──────────┐          ┌──────────┐          ┌──────────┐
  │ 飞书     │          │ 飞书     │          │ 飞书     │
  │ 多维表格 │          │ 知识库   │          │ 云盘     │
  │ (结构化) │          │ (文档)   │          │ (文件)   │
  └──────────┘          └──────────┘          └──────────┘
        │                                          │
        ▼                                          ▼
  ┌──────────┐                            ┌──────────────┐
  │  Jira    │
  │ (Bug追踪)│
  └──────────┘

八个底层实体：Feature · Build · TestCase · Bug · Version · Resource · Person · Knowledge

所有流程、Agent、工具都是围绕这八个实体建立的服务。

工具分工

工具	存什么	谁用
飞书多维表格	Feature / Build / TestCase / Bug / Version / Resource / Person 的结构化记录	所有 Agent
飞书知识库	SOP 文档、案例 Wiki、调试手册、模板文档	知识管理 Agent
飞书云盘	Bug 证据（截图/日志/录屏）、构建产物、里程碑报告、Release 包	质量管控 + 研发管理 Agent
Jira	Bug 详情跟踪，与多维表格双向同步	质量管控 Agent
CI/CD 流水线	构建触发、冒烟执行、结果推送	研发管理 Agent
飞书机器人	通知推送、私信查询	Master Agent

项目目录结构

pm-agents/
│
├── README.md                          ← 本文件（双语项目说明）
├── LICENSE                            ← MIT License
├── CONTRIBUTING.md                    ← 贡献指南
├── CHANGELOG.md                       ← 版本更新记录
├── .gitignore                         ← 忽略 .env / __pycache__ / .DS_Store 等
├── .env.example                       ← 环境变量模板（不含真实凭证）
│
├── docs/                              ← 所有文档
│   ├── architecture.md                ← 系统设计说明
│   ├── quick-start.md                 ← 5 分钟快速上手
│   ├── event-protocol.md              ← Agent 间事件通信协议
│   ├── permission-matrix.md           ← 角色与权限矩阵
│   ├── data-migration.md              ← 历史数据迁移指南
│   │
│   ├── agents/                        ← 各 Agent 详细 PRD
│   │   ├── master.md
│   │   ├── requirement.md
│   │   ├── dev.md
│   │   ├── test.md
│   │   ├── quality.md
│   │   ├── resource.md
│   │   ├── people.md
│   │   └── knowledge.md
│   │
│   └── integrations/                  ← 集成接入文档
│       ├── feishu-bitable.md          ← 飞书多维表格
│       ├── feishu-wiki.md             ← 飞书知识库
│       ├── feishu-drive.md            ← 飞书云盘
│       ├── jira.md                    ← Jira 双向同步
│       └── ci-cd.md                   ← CI/CD 流水线
│
├── agents/                            ← Agent 定义与知识目录
│   ├── master/
│   │   └── AGENT.md                   ← 路由规则、Dashboard 配置
│   │
│   ├── requirement/                   ← 需求管理 Agent
│   │   ├── AGENT.md
│   │   └── knowledge/
│   │       ├── feature-lifecycle.md   ← Feature 生命周期流程
│   │       ├── milestone-definition.md← 里程碑定义
│   │       ├── change-management.md   ← 变更管理规范
│   │       └── ota-schedule.md        ← OTA 节点管理规范
│   │
│   ├── dev/                           ← 研发管理 Agent
│   │   ├── AGENT.md
│   │   └── knowledge/
│   │       ├── branch-strategy.md     ← 分支管理策略
│   │       ├── ci-pipeline.md         ← CI/CT 流水线说明
│   │       ├── code-review-standard.md← Code Review 标准
│   │       ├── ota-release-ops.md     ← OTA 构建与推送操作
│   │       └── build-failure-faq.md   ← 常见构建失败排查
│   │
│   ├── test/                          ← 测试管理 Agent
│   │   ├── AGENT.md
│   │   └── knowledge/
│   │       ├── test-layer-definition.md  ← 测试分层标准
│   │       ├── di-pi-pr-guide.md         ← DI/PI/PR 评分指南
│   │       ├── milestone-gate.md         ← 里程碑准入准出
│   │       └── testcase-gherkin.md       ← 用例编写规范（Gherkin）
│   │
│   ├── quality/                       ← 质量管控 Agent
│   │   ├── AGENT.md
│   │   └── knowledge/
│   │       ├── bug-severity.md        ← 缺陷等级与 SLA 规定
│   │       ├── root-cause-template.md ← 根因分析模板（8D 精简版）
│   │       ├── release-checklist.md   ← 版本放行检查清单
│   │       ├── spread-fix-sop.md      ← 横展处理 SOP
│   │       └── external-issue-flow.md ← 外部问题单接收与处理
│   │
│   ├── resource/                      ← 资源管理 Agent
│   │   ├── AGENT.md
│   │   └── knowledge/
│   │       ├── vehicle-reservation.md ← 公用实车预约与归还 SOP
│   │       ├── bench-demand-calc.md   ← 台架需求计算模型
│   │       └── device-fault-flow.md   ← 设备故障上报与处理
│   │
│   ├── people/                        ← 人力管理 Agent
│   │   ├── AGENT.md
│   │   └── knowledge/
│   │       ├── onboarding-cert.md     ← 上岗认证标准
│   │       ├── role-definition.md     ← 岗位职责定义
│   │       └── partner-standard.md    ← 外部合作方接入评审
│   │
│   └── knowledge/                     ← 知识管理 Agent
│       ├── AGENT.md
│       └── knowledge/                 ← 知识库内容（行业模板）
│           ├── 00_新人入门路径.md
│           ├── 01_索引表/
│           ├── 02_模块责任矩阵/
│           ├── 03_案例库/
│           │   └── _案例Wiki模板.md
│           ├── 04_模块知识库/
│           ├── 05_专题页/
│           ├── 06_跨OS接口/
│           ├── 07_调试手册/
│           ├── 08_性能基准/
│           └── 09_合作规范/
│
├── tools/                             ← 集成脚本
│   ├── feishu/                        ← 飞书 API 工具集
│   │   ├── setup_tables.py            ← 一键建表（多维表格）
│   │   ├── migrate_cases.py           ← 历史用例迁移
│   │   ├── sync_jira.py               ← Jira 双向同步
│   │   ├── upload_to_wiki.py          ← 文档上传知识库
│   │   ├── upload_to_drive.py         ← 文件归档到云盘
│   │   ├── push_ci_results.py         ← CI 结果推送飞书
│   │   └── requirements.txt
│   │
│   └── ci/                            ← CI/CD 流水线脚本
│       ├── smoke_runner.py            ← 冒烟测试执行
│       └── perf_baseline_check.py     ← 性能基准对比
│
├── templates/                         ← 可复用模板
│   ├── feishu-tables/                 ← 飞书多维表格字段模板
│   │   └── 字段参考模板.xlsx
│   ├── test-cases/                    ← TestCase Gherkin 模板
│   ├── dashboards/                    ← FVP 看板配置
│   └── reports/                       ← 里程碑测试报告模板
│
└── examples/                          ← 参考实现
    ├── automotive/                    ← 汽车 OEM 场景（本项目原型）
    │   ├── config.yaml
    │   └── README.md
    └── generic/                       ← 通用软件团队
        ├── config.yaml
        └── README.md

七个 Agent 职能边界

生命周期链路

需求管理  →  研发管理  →  测试管理  →  质量管控
（做什么）   （怎么做）   （怎么验证）  （能不能发）
                                         ↑
                              外部问题单 ─┘

横向支撑

资源管理   实车 / 台架 / 物理设备，支撑研发与测试
人力管理   人员矩阵 / 缺口分析 / 上岗认证，贯穿全阶段
知识管理   案例积累 / 文档检索 / AI 问答，贯穿全阶段

飞书三件套分工

飞书多维表格（结构化数据）

存放所有可统计、可过滤、可自动计算的记录：

Feature 主库、里程碑执行明细
TestCase 三层库
Bug 库（与 Jira 双向同步）
Version 台账、构建记录
实车/台架台账、人员矩阵

飞书知识库（文档与知识）

存放叙述性、流程性内容：

各 Agent 的 SOP 文档（知识目录中的 .md 文件）
案例 Wiki（7 段结构，Bug 关闭触发强制写入）
调试手册、模块技术文档
新人入职必读路径

飞书云盘（文件与附件）

存放二进制大文件：

Bug 证据：截图 / 日志 / 录屏（Bug 关闭前必须上传，否则卡点）
构建产物：CI 生成的安装包 / OTA 差分包
里程碑测试报告（PDF，多方签字后归档）
Release 版本包存档（按版本号目录组织）

云盘目录结构（建议）：

云盘根目录/
├── bugs/          ← {Bug_ID}/ 目录，存该 Bug 的所有证据
├── builds/        ← {版本号}/ 目录，存构建产物
├── reports/       ← {里程碑}_{日期}.pdf
└── releases/      ← {版本号}/（正式发布包长期归档）

Agent 间事件通信协议

所有 Agent 通过飞书机器人的 Webhook 或内部消息队列通信，事件格式统一：

{
  "event_type": "feature.submitted",      // 事件类型
  "source_agent": "requirement",          // 发送方
  "target_agent": ["dev", "test"],        // 接收方（可多个）
  "entity_type": "Feature",              // 关联实体类型
  "entity_id": "HMI_001_HVAC_AUTO",      // 关联实体 ID
  "payload": { ... },                    // 事件携带的数据
  "timestamp": "2026-04-03T10:00:00+08:00",
  "priority": "normal"                   // normal / urgent
}

核心事件清单：

事件	发送方	接收方	触发条件
`feature.submitted`	需求管理	研发管理 + 测试管理	Feature 状态变为"提测"
`feature.milestone.delayed`	需求管理	Master	里程碑标记为延期
`build.succeeded`	研发管理	测试管理	构建成功，新版本可用
`build.failed`	研发管理	Master	构建/冒烟失败
`build.blocked`	研发管理	需求管理 + 质量管控	冒烟通过率低于阈值
`testcase.result.updated`	测试管理	质量管控	执行记录更新
`milestone.dippr.alert`	测试管理	Master	DI/PI/PR 低于目标 15%
`bug.created`	质量管控	研发管理 + 需求管理	新 Bug 录入
`bug.sla.exceeded`	质量管控	Master	Bug 超过 SLA
`bug.closed`	质量管控	知识管理	Bug 关闭，触发知识沉淀
`version.released`	质量管控	Master + 需求管理	版本正式发布
`resource.shortage`	资源管理	Master	实车/台架缺口 > 0
`person.uncertified`	人力管理	知识管理	新人待认证
`knowledge.stale`	知识管理	Master	词条超 90 天未更新

权限矩阵

角色定义

角色	说明
`admin`	系统管理员，全权限
`project-manager`	项目经理，可查看全域数据，可审批变更/放行
`domain-lead`	领域负责人，管理本领域 Feature/Bug
`test-engineer`	测试工程师，可执行用例、提交 Bug
`dev-engineer`	开发工程师，可更新 Bug 修复状态、提交 Build
`resource-admin`	资源管理员，管理实车/台架台账
`readonly`	只读，用于合作方查看进度

飞书多维表格权限

表	project-manager	domain-lead	test-engineer	dev-engineer	readonly
Feature 主库	读写	本领域读写	只读	只读	只读
TestCase 库	读写	本领域读写	读写	只读	只读
Bug 库	读写	读写	新建+更新	更新修复状态	只读
Version 台账	读写	只读	只读	只读	只读
实车/台架台账	读写	只读	只读	只读	只读
人员矩阵	读写	本领域只读	只读	只读	禁止

补全：完整闭环清单（15 条）

在 12 条基础上，补充了飞书云盘、CI/CD、Agent 通信三个维度的新闭环

#	场景	闭环设计	负责 Agent
1	需求变更通知	冻结变更 → 通知关联方 → 强制确认	需求管理
2	横展验证	各车型逐一确认，全部完成才闭环	质量管控
3	Bug 经验沉淀	Blocker/Critical 关闭前必须关联知识词条	质量管控 + 知识管理
4	Bug 证据归档	Bug 关闭前必须上传证据到飞书云盘（截图/日志/录屏），否则卡点	质量管控 + 飞书云盘
5	物料短缺到到货	缺口 → 采购单 → 到货确认 → 归零	资源管理
6	台架缺口到补齐	缺口计算 → 采购任务 → 补齐关闭	资源管理
7	上岗认证	认证未通过不开放系统权限	人力管理 + 知识管理
8	性能回归	CI/CT 自动对比基准库，超阈值 block	研发管理 + 质量管控
9	版本放行归档	多方签字 + 报告 PDF 归档到飞书云盘	质量管控
10	实车故障到恢复通知	维修完成 → 通知等待队列	资源管理
11	用例评审入库	新增用例须测试负责人审批	测试管理
12	Bug 根因到预防措施	预防措施必填 + 知识词条写入	质量管控 + 知识管理
13	CI/CD 异常到 Bug	视觉/日志异常 → CI/CD 自动截图+抓日志 → 上传云盘 → 创建 Bug	测试管理 + CI/CD
14	构建产物到云盘归档	每次成功构建 → CI 脚本自动上传产物到云盘 builds/{版本号}/	研发管理 + 飞书云盘
15	Agent 事件未响应监控	关键事件发出后超 30 分钟无回执 → Master 告警	Master

实施路线图

Phase 1　数据底座（第 1–4 周）

飞书多维表格：8 张核心表建表（Feature / Build / TestCase / Bug / Version / Resource / Person / Knowledge）
飞书云盘：目录结构创建（bugs/ builds/ reports/ releases/）
飞书知识库：各 Agent 的 knowledge/ 文档上传
.env.example 填写，各工具 API 凭证配置就绪
公用实车预约流程上线
CI 构建结果 → 飞书多维表格写入

Phase 2　流程与闭环（第 5–12 周）

Phase 3　智能化（第 13–24 周）

测试管理：AI 用例生成（基于 Feature 描述 → Gherkin）
质量管控：AI 日志归因（App → FW → HAL → CAN 全链路）
知识管理：大模型接入，自然语言检索知识库
研发管理：OTA 灰度推送自动化
Dashboard 完整版（DORA 指标 + DI/PI/PR 趋势 + 外部问题单 KPI）
Robot 完整版：对话查询 + 里程碑周报 + 词条更新提醒

快速开始

# 1. 克隆项目
git clone https://github.com/your-org/pm-agents.git
cd pm-agents

# 2. 配置环境变量
cp .env.example .env
# 编辑 .env，填入飞书 AppID/Secret、Jira Token 等

# 3. 安装依赖
pip install -r tools/feishu/requirements.txt

# 4. 一键建表（飞书多维表格）
python tools/feishu/setup_tables.py

# 5. 参考 docs/quick-start.md 完成后续配置

详细部署文档见 docs/quick-start.md

参考实现

本项目由某汽车 OEM 研发与测试质量管理真实场景提炼而来，具体行业适配配置见 examples/automotive/。

通用软件团队适配配置见 examples/generic/。

贡献

欢迎提交 Issue 和 Pull Request，请先阅读 CONTRIBUTING.md。

License

版本：v1.0　　更新：2026-04-03

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
agents		agents
docs		docs
examples		examples
templates		templates
tools		tools
.env.example		.env.example
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
PRD.md		PRD.md
README.md		README.md
TODOLIST.md		TODOLIST.md

Folders and files

Latest commit

History

Repository files navigation

PM-Agents

English

Overview

Core Capabilities

System Architecture

Tool Responsibilities

Project Structure

Seven Agent Boundaries

Lifecycle Pipeline

Cross-cutting Support

Feishu Trio分工

Feishu Bitable (Structured Data)

Feishu Wiki (Documents & Knowledge)

Feishu Drive (Files & Attachments)

Inter-Agent Event Protocol

Permission Matrix

Role Definitions

Feishu Bitable Permissions

Complete Closed-Loop Checklist (15 Items)

Implementation Roadmap

Phase 1 — Data Foundation (Week 1–4)

Phase 2 — Processes & Closed Loops (Week 5–12)

Phase 3 — Intelligence (Week 13–24)

Quick Start

Reference Implementation

Contributing

License

中文

项目简介

核心能力一览

系统架构

工具分工

项目目录结构

七个 Agent 职能边界

生命周期链路

横向支撑

飞书三件套分工

飞书多维表格（结构化数据）

飞书知识库（文档与知识）

飞书云盘（文件与附件）

Agent 间事件通信协议

权限矩阵

角色定义

飞书多维表格权限

补全：完整闭环清单（15 条）

实施路线图

Phase 1 数据底座（第 1–4 周）

Phase 2 流程与闭环（第 5–12 周）

Phase 3 智能化（第 13–24 周）

快速开始

参考实现

贡献

License

About

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Phase 1　数据底座（第 1–4 周）

Phase 2　流程与闭环（第 5–12 周）

Phase 3　智能化（第 13–24 周）