nexus/wiki/sources/project-management-jira-workflow-steward.md

title, type, tags, date, source_file, last_updated

title	type	tags	date	source_file	last_updated
Jira Workflow Steward	source	agent project-management git-workflow jira traceability devops	2026-04-20	raw/Agent/agency-agents/project-management/project-management-jira-workflow-steward.md	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 为官方目录，新增 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 关注代码级可追溯性纪律。