Auto-sync: 2026-04-20 12:03

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

@@ -0,0 +1,47 @@
+---
+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 关注代码级可追溯性纪律。