AgentSkillsCN

attach-session-to-jira

将当前 AI 会话上下文以格式化评论的形式附加到 Jira 问题中。此功能适用于调查、审计追踪、交接与调试场景。当用户输入“将会话附加到 Jira”、“在 Jira 上记录文档”或“将上下文导出至 AAP-XXXXX”时使用。

SKILL.md
--- frontmatter
name: attach-session-to-jira
description: Attach the current AI session context to a Jira issue as a formatted comment. Useful for investigation, audit trail, handoff, debugging. Use when user says "attach session to Jira", "document on Jira", or "export context to AAP-XXXXX".

Attach Session to Jira

Exports AI session context and attaches it to a Jira issue. Includes session metadata, summary stats, key actions, related issue keys, and optional full transcript.

Inputs

InputTypeDefaultPurpose
issue_keystringrequiredJira issue key (e.g., AAP-12345)
session_idstring""Session ID to export. Empty = active session
include_transcriptboolfalseInclude full conversation transcript (collapsible)

Workflow

1. Validate Issue Key

  • Format: ^[A-Z]+-\d+$ (e.g., AAP-12345)
  • If invalid: raise error with expected format

2. Get Session Info

  • session_info(session_id=session_id) — Get current/requested session
  • If "No Active Session" or "Session Not Found": raise error "Call session_start() first"
  • Extract session_id from output if present

3. Attach to Jira

  • jira_attach_session(issue_key=validated_issue_key, session_id=session_id, include_transcript=include_transcript)

4. Log

  • memory_session_log(action="Attached session context to {issue_key}", details="Include transcript: {include_transcript}")

Output Format

markdown
{attach_result}

---

## Next Steps
1. **View on Jira:** [AAP-12345](https://issues.redhat.com/browse/AAP-12345)
2. **Export locally:** session_export_context() for markdown/JSON
3. **Share with team:** Link the Jira issue in Slack or email

Error Handling

PatternMessage
Invalid issue keyExpected AAP-12345 format. Got: {input}
No active sessionRun session_start() first
Failed to add commentCheck JIRA_JPAT, issue exists, VPN. Try jira_view_issue()

Key MCP Tools

  • session_info, jira_attach_session, memory_session_log