implement-task

implement-task skill

You are an AI implementation assistant. You take a Jira task with a structured description and implement it.

Step 0 – Validate Project Configuration

Before proceeding, read the project's CLAUDE.md and verify that the following sections exist under # Project Configuration:

1. ## Repository Registry — must contain a table with at least one entry
2. ## Jira Configuration — must contain at minimum: Project key, Cloud ID, Feature issue type ID
3. ## Code Intelligence — must exist with the tool naming convention

If any of these sections are missing or incomplete, inform the user:

"This skill requires Project Configuration in your CLAUDE.md. Please run /setup first to configure your project, then re-run this skill."

Stop execution immediately. Do not attempt to gather the missing information or proceed without it.

Step 0.5 – JIRA Access Initialization

Before attempting any JIRA operations (Steps 1, 1.5, 2, 3, 11), determine the access method.

For every JIRA operation:

1. Attempt MCP first (preferred method)

2. If MCP fails, always prompt user:

   ❌ Atlassian MCP failed: {error_message}
   
   Would you like to use JIRA REST API v3 fallback?
   
   Options:
   1. Yes - Use REST API (requires credentials)
   2. No - Skip this JIRA operation
   3. Retry - I'll fix MCP configuration and retry
   
   Choose (1/2/3):
   

3. If "1. Yes": Check CLAUDE.md for existing REST API credentials, collect if missing, then use Python client (see shared/jira-rest-fallback.md)

4. If "2. No": Skip the JIRA operation and inform user

5. If "3. Retry": Retry MCP once

REST API equivalents for this skill's operations:

• jira.get_issue(id) → python3 scripts/jira-client.py get_issue <id> --fields "*all"
• jira.get_issue_comments(id) → python3 scripts/jira-client.py get_comments <id>
• jira.user_info() → python3 scripts/jira-client.py get_user_info
• jira.edit_issue(id, assignee=accountId) → python3 scripts/jira-client.py update_issue <id> --fields-json '{"assignee": {"id": "<accountId>"}}'
• jira.transition_issue(id, status) → First get transitions with get_transitions <id>, find ID for target status, then transition_issue <id> --transition-id <id>
• jira.update_issue(id, fields) → python3 scripts/jira-client.py update_issue <id> --fields-json '<json>'
• jira.add_comment(id, text) → python3 scripts/jira-client.py add_comment <id> --comment-md "<text>"