以下为本文档的中文说明agent-project-board-sync 是一个将 AI 智能体集群Agent Swarm与 GitHub Projects 进行双向同步的技能实现可视化的任务管理、进度追踪和团队协作。它通过 ruv-swarm 命令工具将分布式 AI 智能体的工作状态和进度实时映射到 GitHub Projects 看板上让团队成员能够使用熟悉的项目管理界面来监控 AI 工作流的运行状态。使用场景包括当多个 AI 智能体协同处理复杂任务需要统一的任务看板来追踪进度时当团队希望将 AI 智能体的工作流与现有的 GitHub Projects 项目管理流程整合时当需要为智能体集群创建专属的状态视图、工作负载视图和优先级视图时当管理者需要直观地查看每个智能体的当前状态、已完成任务和阻塞项时当需要在项目周报中自动汇总智能体的工作进展时当需要在多智能体系统中进行任务分配和负载均衡时。核心特点包括一是双向同步模式既将智能体状态推送到 GitHub Projects也能从 Projects 中读取任务变更来影响智能体行为形成完整的闭环管理二是支持创建多维度视图包括集群状态视图、智能体工作负载视图和优先级视图提供全面的实时监控能力三是通过 gh CLI 实现与 GitHub 的深度集成利用原生 GitHub 认证和 API 机制安全性有充分保障无需额外凭证管理四是支持自定义字段映射如「集群状态」「智能体工作负载」「优先级」等项目管理字段灵活适配不同团队的工作流程和规范五是初始化配置简单快捷通过 npx ruv-swarm 命令行工具即可快速完成对接和设置降低使用门槛。这个技能将先进的 AI 智能体编排与传统项目管理工具无缝连接起来。Project Board Sync - GitHub Projects IntegrationOverviewSynchronize AI swarms with GitHub Projects for visual task management, progress tracking, and team coordination.Core Features1. Board Initialization# Connect swarm to GitHub Project using gh CLI# Get project detailsPROJECT_ID$(gh project list--ownerme--formatjson|\\jq-r.projects[] | select(.title Development Board) | .id)# Initialize swarm with projectnpx ruv-swarm github board-init\\--project-id$PROJECT_ID\\--sync-modebidirectional\\--create-viewsswarm-status,agent-workload,priority# Create project fields for swarm trackinggh project field-create$PROJECT_ID--ownerme\\--nameSwarm Status\\--data-typeSINGLE_SELECT\\--single-select-optionspending,in_progress,completed2. Task Synchronization# Sync swarm tasks with project cardsnpx ruv-swarm github board-sync\\--map-status{ todo: To Do, in_progress: In Progress, review: Review, done: Done }\\--auto-move-cards\\--update-metadata3. Real-time Updates# Enable real-time board updatesnpx ruv-swarm github board-realtime\\--webhook-endpointhttps:/$api.example.com$github-sync\\--update-frequencyimmediate\\--batch-updatesfalseConfigurationBoard Mapping Configuration# .github$board-sync.ymlversion:1project:name:AI Development Boardnumber:1mapping:# Map swarm task status to board columnsstatus:pending:Backlogassigned:Readyin_progress:In Progressreview:Reviewcompleted:Doneblocked:Blocked# Map agent types to labelsagents:coder: Developmenttester: Testinganalyst: Analysisdesigner: Designarchitect:️ Architecture# Map priority to project fieldspriority:critical: Criticalhigh: Highmedium: Mediumlow:⚪ Low# Custom fieldsfields:-name:Agent Counttype:numbersource:task.agents.length-name:Complexitytype:selectsource:task.complexity-name:ETAtype:datesource:task.estimatedCompletionView Configuration// Custom board views{views:[{name:Swarm Overview,type:board,groupBy:status,filters:[is:open],sort:priority:desc},{name:Agent Workload,type:table,groupBy:assignedAgent,columns:[title,status,priority,eta],sort:eta:asc},{name:Sprint Progress,type:roadmap,dateField:eta,groupBy:milestone}]}Automation Features1. Auto-Assignment# Automatically assign cards to agentsnpx ruv-swarm github board-auto-assign\\--strategyload-balanced\\--considerexpertise,workload,availability\\--update-cards2. Progress Tracking# Track and visualize progressnpx ruv-swarm github board-progress\\--showburndown,velocity,cycle-time\\--time-periodsprint\\--export-metrics3. Smart Card Movement# Intelligent card state transitionsnpx ruv-swarm github board-smart-move\\--rules{ auto-progress: when:all-subtasks-done, auto-review: when:tests-pass, auto-done: when:pr-merged }Board CommandsCreate Cards from Issues# Convert issues to project cards using gh CLI# List issues with labelISSUES$(gh issue list--labelenhancement--jsonnumber,title,body)# Add issues to projectecho$ISSUES|jq-r.[].number|whileread-rissue;dogh project item-add$PROJECT_ID--ownerme--urlhttps:/$github.com/$GITHUB_REPOSITORY$issues/$issuedone# Process with swarmnpx ruv-swarm github board-import-issues\\--issues$ISSUES\\--add-to-columnBacklog\\--parse-checklist\\--assign-agentsBulk Operations# Bulk card operationsnpx ruv-swarm github board-bulk\\--filterstatus:blocked\\--actionadd-label:needs-attention\\--notify-assigneesCard Templates# Create cards from templatesnpx ruv-swarm github board-template\\--templatefeature-development\\--variables{ feature: User Authentication, priority: high, agents: [architect, coder, tester] }\\--create-subtasksAdvanced Synchronization1. Multi-Board Sync# Sync across multiple boardsnpx ruv-swarm github multi-board-sync\\--boardsDevelopment,QA,Release\\--sync-rules{ Development-QA: when:ready-for-test, QA-Release: when:tests-pass }2. Cross-Organization Sync# Sync boards across organizationsnpx ruv-swarm github cross-org-sync\\--sourceorg1/Project-A\\--targetorg2/Project-B\\--field-mappingcustom\\--conflict-resolutionsource-wins3. External Tool Integration# Sync with external toolsnpx ruv-swarm github board-integrate\\--tooljira\\--mappingbidirectional\\--sync-frequency5m\\--transform-rulescustomVisualization ReportingBoard Analytics# Generate board analytics using gh CLI data# Fetch project dataPROJECT_DATA$(gh project item-list $PROJECT_ID--ownerme--formatjson)# Get issue metricsISSUE_METRICS$(echo$PROJECT_DATA|jq-r.items[] | select(.content.type Issue)|\\whileread-ritem;doISSUE_NUM$(echo$item|jq-r.content.number)gh issue view $ISSUE_NUM--jsoncreatedAt,closedAt,labels,assigneesdone)# Generate analytics with swarmnpx ruv-swarm github board-analytics\\--project-data$PROJECT_DATA\\--issue-metrics$ISSUE_METRICS\\--metricsthroughput,cycle-time,wip\\--group-byagent,priority,type\\--time-range30d\\--exportdashboardCustom Dashboards// Dashboard configuration{dashboard:{widgets:[{type:chart,title:Task Completion Rate,data:completed-per-day,visualization:line},{type:gauge,title:Sprint Progress,data:sprint-completion,target:100},{type:heatmap,title:Agent Activity,data:agent-tasks-per-day}]}}Reports# Generate reportsnpx ruv-swarm github board-report\\--typesprint-summary\\--formatmarkdown\\--includevelocity,burndown,blockers\\--distributeslack,emailWorkflow IntegrationSprint Management# Manage sprints with swarmsnpx ruv-swarm github sprint-manage\\--sprintSprint 23\\--auto-populate\\--capacity-planning\\--track-velocityMilestone Tracking# Track milestone progressnpx ruv-swarm github milestone-track\\--milestonev2.0 Release\\--update-board\\--show-dependencies\\--predict-completionRelease Planning# Plan releases using board datanpx ruv-swarm github release-plan-board\\--analyze-velocity\\--estimate-completion\\--identify-risks\\--optimize-scopeTeam CollaborationWork Distribution# Distribute work among teamnpx ruv-swarm github board-distribute\\--strategyskills-based\\--balance-workload\\--respect-preferences\\--notify-assignmentsStandup Automation# Generate standup reportsnpx ruv-swarm github standup-report\\--teamfrontend\\--includeyesterday,today,blockers\\--formatslack\\--scheduledaily-9amReview Coordination# Coordinate reviews via boardnpx ruv-swarm github review-coordinate\\--boardCode Review\\--assign-reviewers\\--track-feedback\\--ensure-coverageBest Practices1. Board OrganizationClear column definitionsConsistent labeling systemRegular board groomingAutomation rules2. Data IntegrityBidirectional sync validationConflict resolution strategiesAudit trailsRegular backups3. Team AdoptionTraining materialsClear workflowsRegular reviewsFeedback loopsTroubleshootingSync Issues# Diagnose sync problemsnpx ruv-swarm github board-diagnose\\--checkpermissions,webhooks,rate-limits\\--test-sync\\--show-conflictsPerformance# Optimize board performancenpx ruv-swarm github board-optimize\\--analyze-size\\--archive-completed\\--index-fields\\--cache-viewsData Recovery# Recover board datanpx ruv-swarm github board-recover\\--backup-id2024-01-15\\--restore-cards\\--preserve-current\\--merge-conflictsExamplesAgile Development Board# Setup agile boardnpx ruv-swarm github agile-board\\--methodologyscrum\\--sprint-length2w\\--ceremoniesplanning,review,retro\\--metricsvelocity,burndownKanban Flow Board# Setup kanban boardnpx ruv-swarm github kanban-board\\--wip-limits{ In Progress: 5, Review: 3 }\\--cycle-time-tracking\\--continuous-flowResearch Project Board# Setup research boardnpx ruv-swarm github research-board\\--phasesideation,research,experiment,analysis,publish\\--track-citations\\--collaborate-externalMetrics KPIsPerformance Metrics# Track board performancenpx ruv-swarm github board-kpis\\--metrics[ average-cycle-time, throughput-per-sprint, blocked-time-percentage, first-time-pass-rate ]\\--dashboard-urlTeam Metrics# Track team performancenpx ruv-swarm github team-metrics\\--boardDevelopment\\--per-member\\--includevelocity,quality,collaboration\\--anonymous-optionSee also: swarm-issue.md, multi-repo-swarm.md3e:[“ , ,,L41”,null,{“content”:“$42”,“frontMatter”:{“name”:“agent-project-board-sync”,“description”:“Agent skill for project-board-sync - invoke with $agent-project-board-sync”}}]3f:[“KaTeX parse error: Expected }, got EOF at end of input: …,children:[[”,“div”,null,{“className”:“flex items-center justify-between border-b border-border bg-muted/30 px-4 py-2.5”,“children”:[[“KaTeX parse error: Expected }, got EOF at end of input: …,children:[”,“span”,null,{“className”:“truncate text-xs font-medium text-muted-foreground”,“children”:“同仓库更多 Skills”}]}],[“KaTeX parse error: Expected EOF, got } at position 88: …ldren:同仓库}]]}̲],[”,“div”,null,{“className”:“p-4 sm:p-5”,“children”:[[“ , h 2 , n u l l , i d : r e l a t e d − s k i l l s − h e a d i n g , c l a s s N a m e : t e x t − 2 x l f o n t − s e m i b o l d t r a c k i n g − n o r m a l t e x t − f o r e g r o u n d , c h i l d r e n : 同仓库更多 S k i l l s ] , [ ,h2,null,{id:related-skills-heading,className:text-2xl font-semibold tracking-normal text-foreground,children:同仓库更多 Skills}],[,h2,null,id:related−skills−heading,className:text−2xlfont−semiboldtracking−normaltext−foreground,children:同仓库更多Skills],[”,“div”,null,{“className”:“mt-4 grid gap-3 sm:grid-cols-2”,“children”:[“L 43 , L43,L43,L44”,“L 45 , L45,L45,L46”,“L 47 , L47,L47,L48”]}]]}]]}]49:I[206516,[“/_next/static/chunks/051aanbhrv4br.js”,“/_next/static/chunks/0mizr60h7ayzt.js”,“/_next/static/chunks/0v9lm1dmbdoo-.js”,“/_next/static/chunks/0rxr1j1j3j-.r.js”,“/_next/static/chunks/02ftybezfvqjd.js”,“/_next/static/chunks/0.v9ksvnnj8ia.js”,“/_next/static/chunks/0bn6id96nx3k.js,“/_next/static/chunks/13ybnhn37c.tc.js”,“/_next/static/chunks/0_fnrdtruz8uf.js”,“/_next/static/chunks/0r6l15utt1mwb.js”,“/_next/static/chunks/0dm9a5into854.js”,/_next/static/chunks/07k6hqoibtcn.js”,“/next/static/chunks/0b4cao.4y…j.js”,“/_next/static/chunks/02i-n28z7kjd0.js”],“default”]