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:
@@ -49,6 +49,35 @@ python skills/g3fo-commit-jira/scripts/upload_attachment.py --config "skills/g3f
|
||||
|
||||
---
|
||||
|
||||
## 无 MCP:`jira_cli.py`(查 Jira / 建单 / 评论)
|
||||
|
||||
在 **未安装 Atlassian MCP** 的环境(其它 IDE、终端)中,使用与上传附件**相同**的 `jira_upload.env`,通过 `scripts/jira_cli.py` 调用 Jira REST API v3:
|
||||
|
||||
| 子命令 | 作用 |
|
||||
|--------|------|
|
||||
| `myself` | 当前用户 accountId / 邮箱 |
|
||||
| `search` | JQL 搜索(默认:G3SF 进行中且指派给当前用户) |
|
||||
| `issue <KEY>` | 查看单条 Issue |
|
||||
| `create` | 创建 Issue(默认 G3SF + Task,经办人为 Token 用户) |
|
||||
| `comment` | 添加评论 |
|
||||
|
||||
依赖:`pip install -r scripts/requirements.txt`(仅需 `requests`)。
|
||||
|
||||
```powershell
|
||||
# 搜索(与技能 Step 3 默认 JQL 一致)
|
||||
python skills/g3fo-commit-jira/scripts/jira_cli.py --config "skills/g3fo-commit-jira/jira_upload.env" search --limit 5
|
||||
|
||||
# 新建(描述来自文件)
|
||||
python skills/g3fo-commit-jira/scripts/jira_cli.py --config "skills/g3fo-commit-jira/jira_upload.env" create --summary "[G3SF] 简述" --description-file "D:\tmp\impact.md"
|
||||
|
||||
# 评论
|
||||
python skills/g3fo-commit-jira/scripts/jira_cli.py --config "skills/g3fo-commit-jira/jira_upload.env" comment --issue G3SF-123 --body-file "D:\tmp\comment.md"
|
||||
```
|
||||
|
||||
配置文件查找顺序:当前工作目录、`scripts/` 下、`skills/g3fo-commit-jira/` 下的 `jira_upload.env`。详细参数见 `references/workflow.md`「无 MCP:jira_cli 速查」。
|
||||
|
||||
---
|
||||
|
||||
## 环境变量覆盖
|
||||
|
||||
若同时存在配置文件和环境变量,**环境变量优先**。
|
||||
|
||||
Reference in New Issue
Block a user