48 lines
2.8 KiB
Markdown
48 lines
2.8 KiB
Markdown
---
|
||
title: "Jira Workflow Steward"
|
||
type: source
|
||
tags: [agent, project-management, git-workflow, jira, traceability, devops]
|
||
date: 2026-04-20
|
||
source_file: raw/Agent/agency-agents/project-management/project-management-jira-workflow-steward.md
|
||
last_updated: 2026-04-20
|
||
---
|
||
|
||
## Summary
|
||
|
||
Jira Workflow Steward 是 The Agency 项目中的交付可追溯性治理智能体，专注于 Jira 关联的 Git 工作流执行——包括可追溯提交、结构化 Pull Request、发布安全的分支策略和 Gitmoji 提交规范。其核心信念是"如果一个变更无法从 Jira 追踪到分支→提交→Pull Request→发布，工作流就是不完整的"。
|
||
|
||
## Key Claims
|
||
|
||
- 每个实现分支、提交和 PR 必须映射到一个已确认的 Jira 任务（Jira Gate）
|
||
- 提交消息必须遵循 `<gitmoji> JIRA-ID: short description` 单行格式
|
||
- 分支命名遵循 `feature/JIRA-ID-description`、`bugfix/JIRA-ID-description`、`hotfix/JIRA-ID-description` 模式
|
||
- `main` 保持生产就绪，`develop` 是集成分支；`feature/*` 和 `bugfix/*` 从 `develop` 分支，`hotfix/*` 从 `main` 分支
|
||
- Gitmoji 选择以 [gitmoji.dev](https://gitmoji.dev/) 为官方目录，新增 Agent 用 ✨ 而非 📚
|
||
- 提交保持原子化、聚焦和易于回滚
|
||
- 安全审查对认证、授权、基础设施、密钥和数据处理变更是强制的
|
||
- Pull Request 对合并到 `main`、`release/*`、大型重构和关键基础设施变更是强制的
|
||
- 绝不在分支名、提交消息、PR 标题或描述中放置密钥、凭证、令牌或客户数据
|
||
- 成功指标：100% 分支 Jira 映射、≥98% 提交命名合规、审计追溯 <10 分钟重建
|
||
|
||
## Key Quotes
|
||
|
||
> "If a change cannot be traced from Jira to branch to commit to pull request to release, you treat the workflow as incomplete." — 核心身份定义
|
||
|
||
> "Jira-linked commits improve review speed, release notes, auditability, and incident reconstruction." — Jira 关联提交的价值
|
||
|
||
> "The commit message should say what changed, not that you 'fixed stuff'." — 提交消息规范
|
||
|
||
## Connections
|
||
|
||
- [[TheAgency]] — The Agency 项目的 Project Management Division 成员
|
||
- [[ProjectShepherd]] — 同属项目管理部门的智能体，互补关系（Project Shepherd 管理项目整体交付，Jira Workflow Steward 管理代码交付纪律）
|
||
- [[StudioProducer]] — 同属项目管理部门，从战略层面编排项目
|
||
- [[GitWorkflow]] — 核心概念，Jira 关联的 Git 分支、提交和 PR 工作流
|
||
- [[CommitHygiene]] — 核心概念，原子化提交和 Gitmoji 规范
|
||
- [[BranchStrategy]] — 核心概念，功能/修复/热修复/发布分支策略
|
||
- [[Gitmoji]] — 提交消息的 emoji 标准化规范
|
||
|
||
## Contradictions
|
||
|
||
- 无直接矛盾。与 [[ProjectShepherd]] 的工作范围互补而非重叠：Project Shepherd 关注项目级交付协调，Jira Workflow Steward 关注代码级可追溯性纪律。
|