netresearch/jira-skill / skills/jira-communication
jira-communication
FlaggedUse when handling Jira issues, sprints, boards, links, fields, worklogs, attachments, or users, or on any Jira intent without a key ("create/find a ticket", "pick a project"). Auto-triggers on Jira URLs and issue keys (PROJ-123). Also use when MCP Atlassian tools fail or are unavailable for Jira Server/DC.
AGENTS.md
View on GitHub<!-- Managed by agent: keep sections & order; edit content, not structure. Last updated: 2025-12-12 -->
<!-- SPDX-License-Identifier: CC-BY-SA-4.0 -->
<!-- SPDX-FileCopyrightText: Netresearch DTT GmbH -->
# AGENTS.md — jira-communication
Development guide for maintaining and extending the Jira communication scripts.
## Overview
Python CLI scripts using `uv run`. Each script is standalone with PEP 723 inline dependencies.
## Setup & environment
Development requires Python 3.11+ and `uv`. No virtual environment needed - `uv run` handles dependencies.
## Build & tests
```bash
# Test a script works
uv run scripts/core/jira-validate.py --help
# Test against real Jira (need ~/.env.jira configured)
uv run scripts/core/jira-validate.py --verbose
```
## Code style & conventions
**Script structure:**
- Use argparse with subcommands
- Import shared lib: `from lib.client import get_jira_client`
- PEP 723 header for inline dependencies
- PYTHONPATH manipulation at top (copy from existing scripts)
**Output formats:** Every script must support `--json`, `--quiet`, and default table output via `lib/output.py`.
**Write operations:** Destructive operations (delete, move) must include `--dry-run` flag.
## Security & safety
- Never hardcode credentials
- Use `lib/config.py` for env loading
- Test `--dry-run` before actual writes
- `AuthenticationError` from `lib/errors.py` (raised by the client's response hook on 401/403) subclasses `Exception`, not `requests.RequestException`. A function whose contract is "any read failure means unknown" must name it in its `except` clause, or a 403 aborts the command instead of falling back. (jira-move's scheme read, review on #325.)
## PR/commit checklist
- [ ] Script follows existing structure (copy from similar script)
- [ ] All three output formats work (`--json`, `--quiet`, table)
- [ ] `--dry-run` for any write operation
- [ ] `--help` is descriptive
- [ ] Update SKILL.md with new script docs
## Good vs. bad examples
**Adding a new script:**
```python
# ✓ Copy structure from existing script
# ✓ Use lib/ imports
# ✓ Support all output formats
# ✗ Write from scratch without looking at patterns
# ✗ Hardcode auth or skip --dry-run
```
## When stuck
- Copy structure from `scripts/core/jira-issue.py` (good reference)
- Check `lib/` for shared utilities
- Run `--help` on similar scripts
## House rules
- Don't read SKILL.md for development - it's user docs
- Test against real Jira before PR
---
**Maintaining this file:** See root `AGENTS.md` for convention reference.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |