跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
效率与协作

jira-collaboration

Collaborate on issues: add/edit comments, share attachments, notify users, track activity. For team communication and coordination on JIRA issues.

jira-assistant-skills · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add grandcamel/JIRA-Assistant-Skills --skill jira-collaboration

技能说明


name: "jira-collaboration" description: | Collaborate on issues: add/edit comments, share attachments, notify users, track activity. For team communication and coordination on JIRA issues. version: "1.0.0" author: "jira-assistant-skills" license: "MIT" allowed-tools: ["Bash", "Read", "Glob", "Grep"] keywords:

  • comments
  • attachments
  • notifications
  • watchers
  • activity history use_when:
  • "starting work on an issue (add comment)"
  • "sharing screenshots or error logs (upload attachment)"
  • "progress is blocked and needs escalation (comment + notify)"
  • "handing off work to teammate (comment + reassign + notify)"
  • "reviewing what changed on an issue (get activity)"
  • "need to add team visibility (manage watchers)"

jira-collaborate

Collaboration features for JIRA issues - comments, attachments, watchers, and notifications.

Risk Levels

OperationRiskNotes
List comments/attachments-Read-only
List watchers-Read-only
View activity history-Read-only
Add comment-Easily reversible (can delete)
Upload attachment-Easily reversible (can delete)
Add watcher-Can remove watcher
Send notification-Cannot unsend but harmless
Update comment!Previous text lost
Update custom fields!Can be undone via edit
Remove watcher!Can re-add
Delete comment!!Comment text lost
Delete attachment!!File lost, must re-upload

Risk Legend: - Safe, read-only | ! Caution, modifiable | !! Warning, destructive but recoverable | !!! Danger, irreversible

When to use this skill

Use this skill when you need to:

  • Add, update, or delete comments on issues
  • Upload or download attachments
  • Manage watchers (add/remove)
  • Send notifications to users or groups
  • View issue activity and changelog

What this skill does

IMPORTANT: Always use the jira-as CLI. Never run Python scripts directly.

  1. Comments: Add/edit/delete comments with rich text support
  2. Attachments: Upload and download files
  3. Watchers: Manage who tracks the issue
  4. Notifications: Send targeted notifications
  5. Activity History: View issue changelog
  6. Custom Fields: Update custom field values

Available Commands

Comments

CommandDescription
jira-as collaborate comment addAdd comment with visibility controls
jira-as collaborate comment updateUpdate existing comment
jira-as collaborate comment deleteDelete comment (with confirmation)
jira-as collaborate comment listList and search comments

Attachments

CommandDescription
jira-as collaborate attachment listList attachments on issue
jira-as collaborate attachment uploadUpload file to issue
jira-as collaborate attachment downloadDownload attachments

Notifications & Activity

CommandDescription
jira-as collaborate notifySend notifications to users/groups
jira-as collaborate activityView issue changelog

Watchers & Fields

CommandDescription
jira-as collaborate watchersAdd/remove/list watchers
jira-as collaborate update-fieldsUpdate custom fields

All commands support --help for full documentation.

Quick Start Examples

# Add a comment
jira-as collaborate comment add PROJ-123 --body "Starting work on this now"

# Rich text comment (-f/--format supports: text, markdown, adf)
jira-as collaborate comment add PROJ-123 --body "**Bold** text" --format markdown

# Internal comment (role-restricted)
jira-as collaborate comment add PROJ-123 --body "Internal note" --visibility-role Administrators

# Internal comment (group-restricted)
jira-as collaborate comment add PROJ-123 --body "Team only" --visibility-group jira-developers

# List comments (supports --order asc or desc)
jira-as collaborate comment list PROJ-123
jira-as collaborate comment list PROJ-123 -l 10 --order desc

# Get specific comment by ID
jira-as collaborate comment list PROJ-123 --id 10001

# List comments with pagination
jira-as collaborate comment list PROJ-123 -l 10 --offset 20

# Update a comment (requires comment ID)
jira-as collaborate comment update PROJ-123 --id 10001 --body "Updated text"

# Delete a comment (preview first)
jira-as collaborate comment delete PROJ-123 --id 10001 --dry-run

# Delete a comment (confirmed)
jira-as collaborate comment delete PROJ-123 --id 10001 --yes

# Upload attachment (-f is short for --file)
jira-as collaborate attachment upload PROJ-123 -f screenshot.png
jira-as collaborate attachment upload PROJ-123 --file screenshot.png

# Upload attachment with custom name (-n is short for --name)
jira-as collaborate attachment upload PROJ-123 -f screenshot.png -n evidence-2024.png

# List attachments on issue
jira-as collaborate attachment list PROJ-123

# Download attachment by ID (-o is short for --output-dir)
jira-as collaborate attachment download PROJ-123 --id 12345 -o ./downloads/

# Download attachment by filename
jira-as collaborate attachment download PROJ-123 --name error.log -o ./downloads/

# Download all attachments from issue
jira-as collaborate attachment download PROJ-123 --all -o ./backups/

# List watchers (-l is short for --list)
jira-as collaborate watchers PROJ-123 -l
jira-as collaborate watchers PROJ-123 --list

# Add watcher (-a is short for --add)
jira-as collaborate watchers PROJ-123 -a user@example.com

# Remove watcher (-r is short for --remove)
jira-as collaborate watchers PROJ-123 -r user@example.com

# Send notification to watchers
jira-as collaborate notify PROJ-123 --watchers --subject "Update" --body "Issue resolved"

# Send notification to voters
jira-as collaborate notify PROJ-123 --voters --subject "Vote counted"

# Send notification to a group
jira-as collaborate notify P
阅读完整来源 ↗