AgentSkillsCN

issue-audit

深入了解团队在 Linear 中的工作组织方式，帮助新入职的 PM 快速熟悉团队规范、借鉴优秀案例，并掌握提问的关键要点。

SKILL.md
--- frontmatter
name: issue-audit
description: Understand how a team organizes work in Linear. Helps PMs onboarding to new teams learn conventions, see examples, and know what questions to ask.

Issue Audit

Understand how a team organizes and writes issues in Linear. Helps PMs onboarding to new teams learn conventions, see examples, and know what questions to ask.

Prerequisites

  • •Linear MCP must be configured

Entry Point

When this skill is invoked, start with:

code
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ISSUE AUDIT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Learn how a team organizes work in Linear.
Helps you onboard faster and follow team conventions.

Which team do you want to analyze?

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Usage

code
/issue-audit [team name]

Examples:

  • •/issue-audit Customer Experience
  • •/issue-audit Platform
  • •/issue-audit "Data Engineering"

What Happens

  1. •Invokes the team-organization-analyzer agent with your team name
  2. •Agent fetches team structure: workflow states, labels, cycles
  3. •Samples 9 issues (3 active, 3 completed, 3 backlog)
  4. •Analyzes patterns and infers conventions

What You'll Learn

  • •Workflow: How issues flow through states (Triage -> Done)
  • •Labels: What taxonomy the team uses (Type, Area, Priority)
  • •Cycles: Whether they use sprints and cadence
  • •Patterns: How they write issues (descriptions, titles, hierarchy)
  • •Conventions: What a new PM should follow

Sample Size Philosophy

9 issues is intentional - enough to observe patterns without overwhelming. The agent:

  • •Won't apologize for limited data
  • •Reports specific observations ("5 of 9 have descriptions")
  • •Infers conventions from patterns
  • •Offers concrete drill-down prompts

After the Report

Explore further:

  • •"Show me issue [ID]" - Full details on any sample
  • •"Show me 3 parent issues" - See epic structure
  • •"Show me issues labeled [X]" - Filter by label
  • •"Run /issue-audit on [other team]" - Compare patterns

Relationship to Other Commands

code
/linear-calibrate        → Workspace-wide health (30,000 ft view)
         ↓
    ┌────┴────┐
    ↓         ↓
/project-health       /issue-audit
[project]             [team]
(execution health)    (organization patterns) ← THIS COMMAND
  • •/linear-calibrate flags workspace-level issues
  • •/project-health checks if a specific project is on track
  • •/issue-audit helps PM understand how a team works

Part of PM Thought Partner Linear analysis suite