Are you the author? Sign in to claim
Automated Jira daily digest via Claude Code CLI. Queries for Jira Self Hosted API, generates team activity reports (Done
English below
🤖 Claude Code skill để tạo báo cáo Jira tự động và gửi qua Telegram.
Chỉ hỗ trợ Jira Server/Data Center (Self-Hosted) với PAT authentication.
Đây là cách sử dụng chính và đơn giản nhất.
Sau khi cài đặt skill, bạn có thể hỏi Claude bất kỳ điều gì về Jira:
claude
> Tổng hợp task của team hôm qua
> Ai đang làm gì trong project PSV2?
> List các bug chưa fix?
Claude tự động sử dụng skill jira-self-hosted để query Jira. Không cần nhớ JQL syntax!
./install-skill.sh
nano ~/.claude/skills/jira-self-hosted/.env # Cấu hình Jira
claude
/jira-self-hosted
> Hỏi gì đó về Jira...
nano .env # Cấu hình Telegram
crontab -e # Thêm cron job (8 AM)
0 1 * * * /path/to/run-daily-report.sh
Xem docs/project-overview-pdr.md để biết chi tiết.
For detailed information, see the /docs directory:
| Document | Content |
|---|---|
| project-overview-pdr.md | Features, requirements, acceptance criteria |
| system-architecture.md | Architecture, data flow, integrations |
| code-standards.md | Coding conventions, code quality |
| codebase-summary.md | File inventory, component breakdown |
| development-roadmap.md | Phases, timeline, future features |
| project-changelog.md | Release history, changes, versioning |
| File | Used By | Variables |
|---|---|---|
.env | daily-report.mjs | TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID |
~/.claude/skills/jira-self-hosted/.env | Skill scripts | JIRA_DOMAIN, JIRA_PAT |
# 1. Install skill
./install-skill.sh
# 2. Configure Jira
nano ~/.claude/skills/jira-self-hosted/.env
# Add: JIRA_DOMAIN, JIRA_PAT
# 3. Test connection
~/.claude/skills/jira-self-hosted/scripts/jira-auth-test.sh
const JIRA_PROJECTS = ["PSV2", "DIC"]; // Projects to track
const MAIN_PROJECT = "PSV2"; // Team member source
const EXCLUDED_USERS = []; // Users to skip
const JIRA_STATUSES = { // Custom status names
done: "Done",
resolved: "Resolved",
testing: "Testing",
inProgress: "In Progress",
toDo: "To Do"
};
claude
> /jira-self-hosted
> Tổng hợp task hôm qua
Or simply ask without /jira-self-hosted:
> Ai đang làm gì trong PSV2?
> List các bug chưa fix
> Thống kê done tasks tuần này
See skills/jira-self-hosted/references/ for JQL syntax and API docs.
/newbot → copy token.env:
TELEGRAM_BOT_TOKEN=123456:ABC...
TELEGRAM_CHAT_ID=123456789 # For errors
TELEGRAM_GROUP_CHAT_ID=-100123456789 # For reports
crontab -e
# Add: 0 1 * * * /path/to/run-daily-report.sh
Run at 8 AM Vietnam time (1 AM UTC) daily.
# Test report locally
./run-daily-report.sh
# Check logs
tail -f daily-report.log
See project-overview-pdr.md for detailed setup.
| Feature | Interactive | Automation |
|---|---|---|
| Query Jira | ✅ Any time | ✅ Daily |
| JQL Syntax | Natural language | Configured |
| Output Format | Claude's choice | HTML/Telegram |
| Notifications | Console | Telegram |
| Problem | Solution |
|---|---|
| PAT invalid | Check token in ~/.claude/skills/jira-self-hosted/.env |
| Jira not found | Verify JIRA_DOMAIN (no trailing slash) |
| Script timeout | Check network, may need to increase TIMEOUT |
| Telegram error | Verify bot token and chat IDs in .env |
See system-architecture.md for detailed error handling.
skills/jira-self-hosted/SKILL.mdDAILY_PROMPT in daily-report.mjsJIRA_STATUSES in daily-report.mjsSee code-standards.md for conventions.
Báo cáo tự động phân loại bugs dựa trên changelog transitions:
| Pattern | Loại | Giải thích |
|---|---|---|
| Testing → Resolved/In Progress/To Do | QC Reject | QC trả về work state |
| Testing → Reopened | Reopen | QC mở lại issue |
| Resolved/Done → Reopened | Reopen | Bug mở lại từ done |
| In Progress → Resolved (Bug type) | Bug Fixed | Dev fix xong |
Chỉnh sửa trong daily-report.mjs (DAILY_PROMPT) hoặc skills/jira-self-hosted/SKILL.md.
MIT
🤖 Claude Code skill for automated Jira daily reports sent via Telegram.
Only supports Jira Server/Data Center (Self-Hosted) with PAT authentication.
./install-skill.sh
nano ~/.claude/skills/jira-self-hosted/.env # Configure Jira
claude
> Ask anything about Jira in natural language
nano .env # Configure Telegram
crontab -e # Add cron job (8 AM)
0 1 * * * /path/to/run-daily-report.sh
See docs/project-overview-pdr.md for details.
For detailed information, see the /docs directory:
| Document | Content |
|---|---|
| project-overview-pdr.md | Features, requirements, acceptance criteria |
| system-architecture.md | Architecture, data flow, integrations |
| code-standards.md | Coding conventions, code quality |
| codebase-summary.md | File inventory, component breakdown |
| development-roadmap.md | Phases, timeline, future features |
| project-changelog.md | Release history, changes, versioning |
| File | Used By | Variables |
|---|---|---|
.env | daily-report.mjs | TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID |
~/.claude/skills/jira-self-hosted/.env | Skill scripts | JIRA_DOMAIN, JIRA_PAT |
# 1. Install skill
./install-skill.sh
# 2. Configure Jira
nano ~/.claude/skills/jira-self-hosted/.env
# Add: JIRA_DOMAIN, JIRA_PAT
# 3. Test connection
~/.claude/skills/jira-self-hosted/scripts/jira-auth-test.sh
const JIRA_PROJECTS = ["PSV2", "DIC"]; // Projects to track
const MAIN_PROJECT = "PSV2"; // Team member source
const EXCLUDED_USERS = []; // Users to skip
const JIRA_STATUSES = { // Custom status names
done: "Done",
resolved: "Resolved",
testing: "Testing",
inProgress: "In Progress",
toDo: "To Do"
};
claude
> Ask anything about Jira in natural language
Or use skill explicitly:
> /jira-self-hosted
> Summarize yesterday's tasks
See skills/jira-self-hosted/references/ for JQL syntax and API docs.
/newbot → copy token.env:
TELEGRAM_BOT_TOKEN=123456:ABC...
TELEGRAM_CHAT_ID=123456789 # For errors
TELEGRAM_GROUP_CHAT_ID=-100123456789 # For reports
crontab -e
# Add: 0 1 * * * /path/to/run-daily-report.sh
Runs daily at 8 AM Vietnam time (1 AM UTC).
# Test report
./run-daily-report.sh
# Check logs
tail -f daily-report.log
See project-overview-pdr.md for detailed setup.
| Feature | Interactive | Automation |
|---|---|---|
| Query Jira | ✅ Anytime | ✅ Daily |
| Natural Language | ✅ Yes | Settings-based |
| Output Format | Claude's choice | HTML/Telegram |
| Notifications | Console | Telegram |
| Problem | Solution |
|---|---|
| PAT invalid | Check token in ~/.claude/skills/jira-self-hosted/.env |
| Jira not found | Verify JIRA_DOMAIN (no trailing slash) |
| Script timeout | Check network connectivity |
| Telegram error | Verify bot token and chat IDs in .env |
See system-architecture.md for detailed error handling.
skills/jira-self-hosted/SKILL.mdDAILY_PROMPT in daily-report.mjsJIRA_STATUSES in daily-report.mjsSee code-standards.md for conventions.
Auto-reports classify bugs based on changelog transitions:
| Pattern | Type | Description |
|---|---|---|
| Testing → Resolved/In Progress/To Do | QC Reject | QC returns to work state |
| Testing → Reopened | Reopen | QC reopens issue |
| Resolved/Done → Reopened | Reopen | Bug reopened from done |
| In Progress → Resolved (Bug type) | Bug Fixed | Dev completed fix |
Customize in daily-report.mjs (DAILY_PROMPT) or skills/jira-self-hosted/SKILL.md.
MIT
1000+ skills curated from Anthropic, Vercel, Stripe, and other engineering teams
Design enforcement with memory — keeps your UI consistent across a project
Detects 37 AI writing patterns and rewrites text with human rhythm across 5 voice profiles
WCAG accessibility audit — automated scanning, manual review, remediation