agent-skills/skills/g3fo-commit-jira/references/jira_commit_docs_policy.md

Jira 工单附件文档政策（公司强制性指南）

自 2026年3月9日 起，以下为将 开发计划、影响分析、任务摘要 附加到 Jira 工单的强制性指南，用于跟踪设计决策、评估风险、为未来参考提供背景及项目间协作。

---

一般规则（经验法则）

场景	需要附加的文档
漏洞修复	仅包括 影响分析（若修复有非简单副作用）
新功能 / 重大核心变更	全部三个文件：开发计划、影响分析、任务摘要
琐碎 / 小改动	无需文件

---

详细条件（按任务类型）

任务类型	开发计划	影响分析	任务摘要
漏洞修复——简单（如拼写错误、界面对齐）	❌	❌	❌
漏洞修复——中等（如范围有限的逻辑错误）	❌	✅	❌
漏洞修复——复杂/高风险（如并发、核心模块）	✅	✅	✅
小幅度增强（如添加小效用方法）	❌	✅	❌
新功能/模块	✅	✅	✅
主要重构	✅	✅	✅
配置/基础设施变更	❌	✅	❌

---

文档含义说明

• 开发计划：概述步骤、设计方法和技术决策。
• 影响分析：列出受影响区域、风险、性能考虑因素及向后兼容性。
• 任务摘要：简要回顾所完成的工作，包括任何偏离计划的地方。

---

提交方式与命名规范

• 将文件（Markdown）直接放在工单的附件部分。
• 使用一致的命名规范：
  • <JIRA-ID>_Dev_Plan.md
  • <JIRA-ID>_Impact_Analysis.md
  • <JIRA-ID>_Task_Summary.md

示例：工单 G3SF-123 的三个附件命名为
G3SF-123_Dev_Plan.md、G3SF-123_Impact_Analysis.md、G3SF-123_Task_Summary.md。