第一章 协作规范总体框架
本章定义《Jira与Confluence协作规范》的适用边界、核心角色、工具职责划分及规范性文件结构，为后续SOP章节建立统一认知基础。所有团队在接入本规范前，必须对齐本章内容。
1.1 适用场景
本规范适用于以下三类协作场景：
- 需求-开发-测试全流程跟踪：使用Jira管理任务生命期，Confluence承载需求说明、设计文档、测试用例。
- 跨职能同步与知识沉淀：Confluence作为唯一知识库，Jira作为执行状态源，避免信息碎片化。
- 审计与复盘：通过工具间链接（Jira issue ↔ Confluence page）实现追溯，满足合规要求。
推荐：如果团队仅使用Jira进行简单看板管理，或Confluence仅做个人笔记，建议先按本规范建立基础结构，再进行深度集成。
1.2 前置条件
| 条件项 | 要求说明 |
|---|---|
| Jira实例 | Jira Software / Jira Work Management，版本≥8.0 或 Cloud |
| Confluence实例 | Confluence Server / Data Center 7.0+ 或 Cloud |
| 用户账户 | 所有参与者拥有Jira与Confluence的登录权限，并至少分配为“项目用户”角色 |
| 应用连接器（可选） | Jira Confluence Connector 或 Team Calendars for Confluence 以增强双向链接 |
1.3 核心角色定义
本规范划分四个核心角色，职责如下：
| 角色 | 定义 | Jira权限 | Confluence权限 |
|---|---|---|---|
| 项目管理员（PA） | 负责规范推广、工作流配置、权限模板维护 | 项目管理员 / 系统管理员 | 空间管理员 |
| 需求负责人（PM/BA） | 编写需求页面，创建对应Jira Epic/Story，维护优先级 | 创建/编辑 issue，管理冲刺 | 编辑页面，发布评论 |
| 开发/测试人员（DEV/QA） | 在任务中记录工时、更新状态，将代码/用例链接到Confluence | 编辑 issue，记录时间 | 创建页面（模板），评论 |
| 干系人（Stakeholder） | 查阅进度与文档，仅需浏览权限 | 浏览 issue | 浏览页面 |
关键原则：每个角色在Jira和Confluence中遵循最小必要权限；PA需定期审计权限列表。
1.4 工具职责边界
Jira与Confluence的分工遵循“执行记录”与“知识管理”分离原则：
- Jira：负责动态工作流（任务创建、状态流转、工时、燃尽图）；每个可追踪的工作项（需求、缺陷、子任务）必须作为Jira Issue存在。
- Confluence：负责静态文档与协作内容（需求规格、设计决策、会议记录、修订历史）；所有需多人反复查看的长篇内容必须放置在Confluence页面中，并在Jira Issue描述或评论中通过链接引用。
两者之间的数据流：
- Jira Issue → Confluence页面：通过宏插入“Jira Issues”或“Issue List”显示实时状态。
- Confluence页面 → Jira Issue：在页面使用“Create Jira Issue”宏直接创建任务，或在页面内嵌“Jira Portlet”展示关联任务。
1.5 规范性文件结构
本规范所有文件（SOP、模板、指南）按以下目录结构存放于Confluence的“工程协作规范”空间下：
工程协作规范空间
├── 1_总体框架 ← 本章所在位置
│ ├── 适用场景与角色定义
│ ├── 工具职责边界
│ └── 规范文件结构说明
├── 2_Jira操作SOP
│ ├── 需求创建与优先级设定
│ ├── 快速看板配置
│ ├── 工作流自定义指南
│ └── 工时与进度跟踪
├── 3_Confluence操作SOP
│ ├── 页面创建与模板使用
│ ├── 需求文档与评审
│ ├── 会议记录与决策日志
│ └── 空间权限管理
├── 4_集成与联动
│ ├── Jira ↔ Confluence双向链接配置
│ ├── 宏与自动化规则
│ └── 常见集成失败处理
├── 5_审计与治理
│ ├── 规范符合度检查清单
│ ├── 月度报告模板
│ └── 异常处理流程
└── 6_附录
├── 术语表
├── 角色权限矩阵
└── 变更记录
每个SOP章节内部按“适用场景 → 前置条件 → 操作步骤 → 输入输出物 → 责任边界 → 记录材料 → 异常处理 → 验收标准”编排，确保可执行可审计。
1.6 操作步骤（本章级）
团队接入本规范的总流程分为三步：
- 初始化：PA创建Confluence空间，导入本规范模板；PA在Jira中创建项目并配置基础工作流。
- 角色映射：根据团队实际人员分配角色权限，并通过Confluence页面向全员宣贯角色定义。
- 试点运行：选取一个中型迭代（2~4周），在试点中验证适用场景，调整异常处理规则后推广。
1.7 输入输出物
| 输入 | 输出 |
|---|---|
| 团队组织结构与项目清单 | 已配置的Confluence空间与Jira项目 |
| 现有工作习惯调研 | 角色权限矩阵（存储于附录） |
| 管理者对协作合规的要求 | 规范性文件结构目录 |
1.8 责任边界
- PA：负责搭建规范框架，监控规范遵守情况，每年至少复审一次文件结构。
- PM/BA：确保每个需求在Jira有独立Issue，并在Confluence链接对应的需求文档。
- DEV/QA：不得在Jira评论中粘贴大段代码或文档；必须将技术设计或测试用例写成Confluence页面并引用。
- 干系人：仅在Confluence上取阅，不应绕过PA直接修改Jira工作流或Confluence空间结构。
1.9 记录材料
本章不做操作执行，无需专用记录材料。但PA需保留：
- 角色权限分配表（Confluence表格或Excel）
- 规范导入的批准邮件或会议纪要
1.10 异常处理
| 异常场景 | 处理方式 |
|---|---|
| 新成员加入未接受规范培训 | PA安排15分钟定向会，并发送本章链接 |
| Jira与Confluence应用连接器异常 | 检查插件许可证、网络白名单；降级为手动粘贴链接 |
| 团队抗拒分层（觉得Jira够用） | PA选取一个文档混乱的案例，演示Confluence链接如何减少沟通成本 |
1.11 验收标准
- Confluence空间中已建立“工程协作规范”目录结构（至少包含1~6主目录）。
- Jira项目中至少存在一个示例Issue，其描述中包含到Confluence页面的链接。
- 所有角色（PA、PM/BA、DEV/QA、干系人）均已知晓自己的职责边界，并在Confluence角色说明页上签字确认。