feat(g3fo-commit-jira): 新增无 MCP 的 Jira CLI 并增强 AI 执行流程约束

- 新增 `jira_cli.py` 脚本,支持在不依赖 Atlassian MCP 的环境下通过同一 Jira Token 进行搜索、创建 Issue 和评论
- 新增共享配置模块 `jira_env.py`,统一加载 `jira_upload.env` 并支持在技能根目录查找配置文件
- 更新 `SKILL.md` 和参考文档,增加「AI 执行契约」和详细的前置条件说明,强制 Step 1→5 线性执行顺序
- 新增 `agent_execution_checklist.md` 检查清单,防止 AI 跳步、误用工具或未等用户确认就绑定 Issue
- 改进 `jira_cli.py` 的评论和描述生成,将常见 Markdown 语法转换为 Jira ADF 格式以获得更好的渲染效果
This commit is contained in:
2026-03-23 13:38:41 +08:00
parent cd6c8a0450
commit 57fca4e468
9 changed files with 1018 additions and 78 deletions
+32
View File
@@ -0,0 +1,32 @@
# 任务总结 — g3fo-commit-jira 增强
## 任务信息
- **任务**:无 Atlassian MCP 时仍可通过同一 Jira Token 查 Jira、建单、评论。
- **范围**:`skills/g3fo-commit-jira`。
## 改动说明
- 新增 `scripts/jira_cli.py`(search / issue / create / comment / myself)。
- 新增 `scripts/jira_env.py`,`upload_attachment.py` 复用配置加载;支持在技能目录放置 `jira_upload.env`。
- 更新 `SKILL.md`、`references/workflow.md`、`references/env_config.md`。
## 影响与风险
- 无破坏性变更;风险低。详见 `IMPACT_ANALYSIS.md`。
## 测试
- 本地语法与 CLI `--help` 已验证;连通性依赖用户 `jira_upload.env`。
## 后续
- 若需同步到全局技能目录,可使用项目内 `skill-sync` 流程。
---
## 任务总结 — AI 流程防走偏(文档增强)
- **目标**:减少 Agent 跳步、误上传、未等用户选 Issue 等偏离。
- **改动**:`SKILL.md` 增加「AI 执行契约」与各 Step 前置条件;新增 `references/agent_execution_checklist.md`;`workflow.md` 增加执行顺序提醒。
- **测试**:文档审阅;逻辑无代码变更。