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 格式以获得更好的渲染效果

skills/g3fo-commit-jira/references/agent_execution_checklist.md

@@ -0,0 +1,73 @@
+# AI 执行检查清单（g3fo-commit-jira）
+
+执行本技能时建议 **边做边勾**（ mentally 或写在回复里），避免跳步、顺序颠倒或误用工具。
+
+---
+
+## 开始前（Step 0）
+
+- [ ] 用户已提供 **git 修订号**（如 `HEAD` 或完整/短 hash）
+- [ ] 在 **目标业务仓库根目录** 执行 git（`git rev-parse --is-inside-work-tree` 为真）
+- [ ] 已执行 `git rev-parse <hash>`，修订号存在
+- [ ] 若要对提交做 amend：已确认 `git rev-parse HEAD` **等于** `git rev-parse <hash>`（否则停止，提示用户）
+
+---
+
+## Step 1 — 获取提交内容
+
+- [ ] 已运行 `git show <hash>`（或等效）并理解改动范围
+- [ ] 已记录原始 commit message（供 Step 5）
+
+**未完成 Step 0～1 前：禁止** 写 Jira、生成报告、amend。
+
+---
+
+## Step 2 — 任务类型与文档
+
+- [ ] 已阅读并对照 `references/jira_commit_docs_policy.md`（或 SKILL 中的条件表）
+- [ ] 已明确写出：**任务类型** + **开发计划 / 影响分析 / 任务摘要** 各是否需要（✅/❌）
+- [ ] 若需要文档：已按 `workflow.md` 模板准备内容（可先草稿，**真实 Jira Key 出来后再按名落盘**）
+
+**禁止**：未判定类型就上传三份或一份都不写却写长评论（应与政策一致）。
+
+---
+
+## Step 3 — Jira Key
+
+- [ ] 已有 **真实 Issue Key**（如 `G3SF-123`）：来自用户直给、用户从列表选择、或 `create` 成功返回
+- [ ] 若走列表：已 **等用户选 1～N 或 0**，未擅自替用户绑定
+
+**未取得真实 Key 前：禁止** 使用 `<JIRA-ID>_*.md` 落盘上传（禁止占位符 Key）。
+
+---
+
+## Step 4 — 写入 Jira
+
+- [ ] 需要附件时：文件名为 `<KEY>_Dev_Plan.md` / `_Impact_Analysis.md` / `_Task_Summary.md`（仅实际上传需要的）
+- [ ] 附件 **仅** 通过 `scripts/upload_attachment.py` + `jira_upload.env`（不用 MCP 冒充上传）
+- [ ] 需要影响分析进评论时：MCP `jira_add_comment` 或 `jira_cli.py comment`（与政策一致）
+- [ ] 新建 Issue 时：Summary 带 `[G3SF]`，类型 Task，描述/评论与内容一致
+
+---
+
+## Step 5 — Git amend
+
+- [ ] 仅 `git commit --amend`，**未** `git push`
+- [ ] Windows 已按 SKILL 处理 UTF-8 / `--cleanup=verbatim`（如适用）
+- [ ] 若 message 已含 `**** Jira`，未重复追加
+
+---
+
+## 走偏速查
+
+| 现象 | 纠正 |
+|------|------|
+| 先写 Jira 再去看 diff | 回到 Step 1 |
+| 没有 Key 就上传 | 先完成 Step 3 |
+| 用 MCP 上传 md | 改用 `upload_attachment.py` |
+| 简单拼写改却写三份文档 | 重读政策表，按类型裁剪 |
+| 执行了 push | 违反技能范围，后续勿再 push |
+
+---
+
+**原则**：顺序 = 1 → 2 → 3 → 4 → 5；每步通过后再进入下一步；不确定时重读 `SKILL.md` 本节与 `workflow.md` 错误处理表。

skills/g3fo-commit-jira/references/env_config.md

@@ -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 速查」。
+
+---
+
 ## 环境变量覆盖
 
 若同时存在配置文件和环境变量，**环境变量优先**。

skills/g3fo-commit-jira/references/workflow.md

@@ -1,6 +1,7 @@
 # G3FO Commit Jira — 详细工作流参考
 
 ## 目录
+0. [AI 执行顺序提醒](#ai-执行顺序提醒)
 1. [公司 Jira 附件文档政策](#公司-jira-附件文档政策)
 2. [Step 1: 获取并解析提交内容](#step-1-获取并解析提交内容)
 3. [Step 2: 任务类型判定与三文档模板](#step-2-任务类型判定与三文档模板)
@@ -12,6 +13,13 @@
 
 ---
 
+## AI 执行顺序提醒
+
+与 **`SKILL.md` 中「AI 执行契约」** 一致：必须 **Step 1 → 2 → 3 → 4 → 5**，不可跳步。附件仅通过 **`upload_attachment.py`**；**禁止 push**。  
+逐步打勾请用 **`references/agent_execution_checklist.md`**。
+
+---
+
 ## 公司 Jira 附件文档政策
 
 自 **2026年3月9日** 起，何时附加「开发计划」「影响分析」「任务摘要」以公司强制性指南为准。  
@@ -297,6 +305,26 @@ git log --oneline -1        # 查看 commit 摘要
 
 ---
 
+## 无 MCP：`jira_cli.py` 速查
+
+与 `upload_attachment.py` **共用** `jira_upload.env`（`JIRA_BASE_URL`、`JIRA_EMAIL`、`JIRA_API_TOKEN`）。从仓库根执行时建议 `--config` 指向技能目录下的配置文件。
+
+| 操作 | 命令示例 |
+|------|----------|
+| 当前用户（accountId） | `python .../jira_cli.py --config ".../jira_upload.env" myself` |
+| 默认 JQL 搜索（G3SF 进行中、指派给我） | `python .../jira_cli.py --config "..." search --limit 5` |
+| 自定义 JQL | `python .../jira_cli.py --config "..." search --jql "project = G3SF AND key = G3SF-1" --limit 10` |
+| 机器可读 | 上述命令加 `--format json` |
+| 单条 Issue | `python .../jira_cli.py --config "..." issue G3SF-123` |
+| 新建 Task | `python .../jira_cli.py --config "..." create --summary "[G3SF] 标题" --description-file report.md` |
+| 新建（内联描述） | `create --summary "..." --description "多段用\n\n分隔"` |
+| 添加评论 | `python .../jira_cli.py --config "..." comment --issue G3SF-123 --body-file impact.md` |
+| 不上传经办人 | `create ... --no-assign-self`（若站点禁止创建时指定经办人） |
+
+**说明**：`create` 默认 `project=G3SF`、`issuetype=Task`；描述与评论由脚本将 **Markdown** 转为 Jira Cloud **ADF**（`#` 标题、列表、`**粗体**`、代码块等会按富文本展示，不再出现 `###` 原文）。上传 MD 附件仍用 `upload_attachment.py`。
+
+---
+
 ## 错误处理表
 
 | 错误场景 | 检测方式 | 处理方式 |
@@ -304,13 +332,14 @@ git log --oneline -1        # 查看 commit 摘要
 | 修订号不存在 | `git rev-parse <hash>` 报错 | **停止**，提示用户提供正确的修订号。 |
 | 提交 hash 不是 HEAD | `git rev-parse HEAD` ≠ `git rev-parse <hash>` | 停止，提示用户确认 hash（只有 HEAD 才能 amend）。 |
 | 项目路径不正确 | `git rev-parse --is-inside-work-tree` 失败 | 提示用户在正确的 git 项目目录下操作。 |
-| Atlassian MCP 未鉴权 | `STATUS.md` 有提示 / 工具调用返回 401 | 调用 `mcp_auth`，等待用户完成授权。 |
-| Atlassian 插件未安装 | `tools/` 目录为空或 MCP 调用失败 | 引导用户在 Cursor Settings → MCP 安装 Atlassian 插件 |
-| Jira 项目 G3SF 不存在 | `jira_create_issue` 返回 404/400 | 提示用户确认 Jira 实例 URL 和项目 key |
+| 无 MCP 且未配置 jira_upload.env | 无法执行 jira_cli / 上传 | **必须**配置 `jira_upload.env` 或改用 Cursor + MCP。 |
+| Atlassian MCP 未鉴权 | `STATUS.md` 有提示 / 工具调用返回 401 | 调用 `mcp_auth`，或改用 `jira_cli.py`。 |
+| Atlassian 插件未安装 | `tools/` 目录为空或 MCP 调用失败 | 使用 `jira_cli.py` + `jira_upload.env`，或在 Cursor 安装 Atlassian 插件 |
+| Jira 项目 G3SF 不存在 | 创建/搜索返回 404/400 | 提示用户确认 `JIRA_BASE_URL`、项目 key；`create` 可用 `--project` |
 | 工作区有未提交变更 | `git status --porcelain` 有输出 | 警告：amend 会将未暂存变更排除在外，建议先 `git add` 或 stash |
 | commit message 中已有 Jira 行 | message 中包含 `**** Jira` | 跳过追加，提示用户该提交已绑定 |
 | Jira 搜索无结果 | 工具返回空列表 | 直接进入新建流程，无需用户确认 |
-| 未配置 jira_upload.env | 上传前检查配置不存在 | 跳过上传附件，仅通过 jira_add_comment 写入报告；提示用户可配置后使用脚本上传 |
+| 未配置 jira_upload.env | 上传前检查配置不存在 | **有 MCP**：跳过上传，仅评论。**无 MCP**：无法完成 Jira 操作，须配置 env 或使用 MCP。 |
 | 任务类型判定为「无需文档」 | 按政策表属简单漏洞/琐碎改动 | 不生成报告、不写评论、不上传附件；仍执行 Jira 绑定与 commit --amend，将 Jira 编号追加到 commit message |
 
 ---