issue-spec-apply

Coordinates issue-spec implementation workflows with delegated workers and managed PROCESS packages.

9.3k|1.3k|Updated Oct 27, 2022
One-click install
npx skills add https://github.com/alibaba/higress --skill issue-spec-apply
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-spec-apply
Source: https://github.com/alibaba/higress/tree/main/.agents/skills/issue-spec-apply
Command: npx skills add https://github.com/alibaba/higress --skill issue-spec-apply

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Implementing changes tracked in issue-spec requires strict coordination rules: typed ID allocation, worker delegation, review loops, and rationale publication. This Skill enforces that protocol so Coordinators and workers execute implementations without violating ownership, sequencing, or review constraints.

Core Features & Use Cases

  • Execution Mode Selection: Choose between direct implementation, delegated workers, or managed PROCESS packages with one non-Coordinator owner per change-bearing package.
  • Typed ID Management: Allocate IDs in the <TYPE>-<issue><three-digit sequence> format (e.g., QUESTION-1001) scoped to the target issue.
  • Review and Repair Loop: Dispatch independent read-only reviewers, route P0/P1 findings back to the original writer, and publish P2 findings as non-blocking comments.
  • Use Case: When implementing a design tracked in a higress issue, the Coordinator seals an implementation assignment, dispatches a worker with the role packet, integrates the exact result commit, and publishes line-rationale drafts before human handoff.

Quick Start

Ask the agent to apply the issue-spec workflow to implement the design from a specific issue in the higress-group/higress repository.

Frequently Asked Questions about issue-spec-apply

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement an issue-spec design with delegated workers?

Select the delegated path and dispatch exactly one real non-Coordinator worker in the chosen checkout. The worker owns the package code, focused tests, and the exact result commit, while the Coordinator handles integration and validation.

What is the typed ID format for issue-spec artifacts?

Every new typed ID uses the format <TYPE>-<issue><three-digit sequence>, such as QUESTION-1001 for Issue 1. Sequences 001-999 are allocated only within the target issue and type, and legacy IDs are never renumbered.

When should I use a managed PROCESS instead of direct implementation?

Use PROCESS only for concrete managed coordination needs, not for file count, child use, or human handoff. Each change-bearing package gets one real non-Coordinator owner, and proven-independent packages may run concurrently.

Does issue-spec-apply require the issue-spec CLI?

Yes, the Skill requires the issue-spec CLI as stated in its compatibility metadata. Workers use commands like issue-spec read issue to load the complete design body from the source issue.

How does the review and repair loop work before handoff?

An independent read-only reviewer inspects the exact base and head, returning P0/P1/P2 findings. P0/P1 findings route back to the original writer for repair and recheck until zero remain, while P2 findings publish as non-blocking comments.