AGENT SKILL

cypilot-sdlc

Artifacts: ADR, CODEBASE, DECOMPOSITION, DESIGN, FEATURE, PR-CODE-REVIEW-TEMPLATE, PR-REVIEW, PR-STATUS-REPORT-TEMPLATE, PRD; Workflows: migrate-openspec, pr-review, pr-status

License 许可
Apache-2.0
最近更新
2026-11-02
Stars
★ 3
Forks
3

01 前言 Front Matter

name
cypilot-sdlc
description
Artifacts: ADR, CODEBASE, DECOMPOSITION, DESIGN, FEATURE, PR-CODE-REVIEW-TEMPLATE, PR-REVIEW, PR-STATUS-REPORT-TEMPLATE, PRD; Workflows: migrate-openspec, pr-review, pr-status

02 资源文件 36

03 SKILL.md 正文

Cypilot Skill — Kit sdlc

Kit sdlc skill extensions.

ADR

ADR Commands

  • cypilot validate --artifact <ADR.md> — validate ADR structure and IDs
  • cypilot list-ids --kind adr — list all ADRs
  • cypilot where-defined --id <id> — find where an ADR ID is defined
  • cypilot where-used --id <id> — find where an ADR ID is referenced in DESIGN

ADR Workflows

  • Generate ADR: create a new ADR from template with guided prompts per section
  • Analyze ADR: validate structure (deterministic) then semantic quality (checklist-based)

CODEBASE

CODE Commands

  • cypilot validate --artifact <code-path> — validate code traceability and quality
  • cypilot where-defined --id <id> — find where an ID is defined in artifacts
  • cypilot where-used --id <id> — find where an ID is referenced in code via @cpt-* markers

CODE Workflows

  • Generate CODE: implement FEATURE design with optional @cpt-* traceability markers
  • Analyze CODE: validate implementation coverage, traceability, tests, and quality

DECOMPOSITION

DECOMPOSITION Commands

  • cypilot validate --artifact <DECOMPOSITION.md> — validate DECOMPOSITION structure and IDs
  • cypilot list-ids --kind feature — list all features
  • cypilot list-ids --kind status — list status indicators
  • cypilot where-defined --id <id> — find where a feature ID is defined
  • cypilot where-used --id <id> — find where a feature ID is referenced in FEATURE artifacts

DECOMPOSITION Workflows

  • Generate DECOMPOSITION: create feature manifest from DESIGN with guided prompts
  • Analyze DECOMPOSITION: validate structure (deterministic) then decomposition quality (checklist-based)

DESIGN

DESIGN Commands

  • cypilot validate --artifact <DESIGN.md> — validate DESIGN structure and IDs
  • cypilot list-ids --kind component — list all components
  • cypilot list-ids --kind principle — list all design principles
  • cypilot where-defined --id <id> — find where a DESIGN ID is defined
  • cypilot where-used --id <id> — find where a DESIGN ID is referenced downstream

DESIGN Workflows

  • Generate DESIGN: create a new DESIGN from template with guided prompts per section
  • Analyze DESIGN: validate structure (deterministic) then semantic quality (checklist-based)

FEATURE

FEATURE Commands

  • cypilot validate --artifact <FEATURE.md> — validate FEATURE structure and IDs
  • cypilot list-ids --kind flow — list all flows
  • cypilot list-ids --kind algo — list all algorithms
  • cypilot list-ids --kind state — list all state machines
  • cypilot list-ids --kind dod — list all definitions of done
  • cypilot where-defined --id <id> — find where a FEATURE ID is defined
  • cypilot where-used --id <id> — find where a FEATURE ID is referenced in code

FEATURE Workflows

  • Generate FEATURE: create a new FEATURE from template with guided CDSL prompts
  • Analyze FEATURE: validate structure (deterministic) then semantic quality (checklist-based)

PR-REVIEW

PR Review & Status (Shortcut Routing)

ALWAYS re-fetch and re-analyze from scratch WHEN a PR review or status request is detected — even if the same PR was reviewed earlier in this conversation. Previous results are stale the moment a new request arrives. NEVER skip fetch or reuse earlier analysis.

ALWAYS run python3 config/kits/sdlc/scripts/pr.py list WHEN user intent matches PR list patterns:

  • list PRs, list open PRs, cypilot list PRs
  • show PRs, show open PRs, what PRs are open
  • Any request to enumerate or browse open pull requests

AVOID use gh pr list directly — ALWAYS use pr.py list for listing PRs.

ALWAYS route to the cypilot-pr-review workflow WHEN user intent matches PR review patterns:

  • review PR {number}, review PR #{number}, review PR https://...
  • cypilot review PR {number}, PR review {number}
  • code review PR {number}, check PR {number}

ALWAYS route to the cypilot-pr-status workflow WHEN user intent matches PR status patterns:

  • PR status {number}, cypilot PR status {number}
  • status of PR {number}, check PR status {number}

PR List (Quick Command)

When routed to list PRs:

  1. Run python3 config/kits/sdlc/scripts/pr.py list
  2. Present the output to the user (respects .prs/config.yaml exclude list)
  3. No Protocol Guard or workflow loading required — this is a quick command

PR Review Workflow

When routed to PR review:

  1. ALWAYS fetch fresh data first — run pr.py fetch even if data exists from a prior run
  2. Read config/kits/sdlc/workflows/pr-review.md and follow its steps
  3. Use python3 config/kits/sdlc/scripts/pr.py as the script
  4. When target is ALL or no PR number given, run pr.py list first to show available PRs
  5. Select prompt and checklist from {cypilot_path}/config/pr-review.toml → prompts
  6. Load prompt from prompt_file and checklist from checklist in matched entry
  7. Use templates from config/kits/sdlc/artifacts/PR-CODE-REVIEW-TEMPLATE/template.md and config/kits/sdlc/artifacts/PR-STATUS-REPORT-TEMPLATE/template.md

PR Status Workflow

When routed to PR status:

  1. ALWAYS fetch fresh data first — pr.py status auto-fetches, but never assume prior data is current
  2. Read config/kits/sdlc/workflows/pr-status.md and follow its steps
  3. Use python3 config/kits/sdlc/scripts/pr.py as the script
  4. When target is ALL or no PR number given, run pr.py list first to show available PRs

MIGRATION

Migration Commands

  • cypilot migrate-openspec — migrate OpenSpec artifacts to Cypilot SDLC documents

Migration Workflows

ALWAYS route to the cypilot-migrate-openspec workflow WHEN user intent matches OpenSpec migration patterns:

  • migrate openspec, migrate from openspec, convert openspec
  • cypilot migrate-openspec, openspec to cypilot
  • Any request to convert OpenSpec artifacts to Cypilot SDLC format

When routed to OpenSpec migration:

  1. Read config/kits/sdlc/workflows/migrate-openspec.md and follow its steps
  2. The workflow handles all configuration discovery and user interaction

PRD

PRD Commands

  • cypilot validate --artifact <PRD.md> — validate PRD structure and IDs
  • cypilot list-ids --kind fr — list all functional requirements
  • cypilot list-ids --kind actor — list all actors
  • cypilot where-defined --id <id> — find where a PRD ID is defined
  • cypilot where-used --id <id> — find where a PRD ID is referenced downstream

PRD Workflows

  • Generate PRD: create a new PRD from template with guided prompts per section
  • Analyze PRD: validate structure (deterministic) then semantic quality (checklist-based)

04 同仓库更多 Skills

constructorfabric
constructorfabric/insight-front

config

暂无简介

★ 3
constructorfabric
constructorfabric/insight-front

.gen

暂无简介

★ 3
constructorfabric
constructorfabric/insight-front

cypilot

Invoke when user asks to do something with Cypilot, or wants to analyze/validate artifacts, or create/generate/implement anything using Cypilot workflows, or plan phased execution. Core capabilities: workflow routing (plan/analyze/generate/auto-config); deterministic validation (structure, cross-refs, traceability, TOC); code↔artifact traceability with @cpt-* markers; spec coverage measurement; ID search/navigation; init/bootstrap; adapter + registry discovery; auto-configuration of brownfield projects (scan conventions, generate rules); kit management (install/update with file-level diff); TOC generation; agent integrations (Windsurf, Cursor, Claude, Copilot, OpenAI).

★ 3
constructorfabric
constructorfabric/insight-front

tanstack-router

TanStack Router (v1+) reference for code-based routing, loaders, search params, navigation, link composition, route guards, and integration patterns. Use when working with files under src/ that import from '@tanstack/react-router', when creating or modifying routes/route trees, when designing data-loading via route loaders or beforeLoad, when adding type-safe Links/useNavigate/useParams/useSearch, when configuring RouterProvider or createRouter, or whenever the user mentions "tanstack router", "route loader", "useParams", "useNavigate", "search params", "beforeLoad", or "code-based routes". Also triggers for migration questions from react-router or other routers.

★ 3
constructorfabric
constructorfabric/insight-front

cypilot

Invoke when user asks to do something with Cypilot, or wants to analyze/validate artifacts, or create/generate/implement anything using Cypilot workflows, or plan phased execution. Core capabilities: workflow routing (plan/analyze/generate/auto-config); deterministic validation (structure, cross-refs, traceability, TOC); code↔artifact traceability with @cpt-* markers; spec coverage measurement; ID search/navigation; init/bootstrap; adapter + registry discovery; auto-configuration of brownfield projects (scan conventions, generate rules); kit management (install/update with file-level diff); TOC generation; agent integrations (Windsurf, Cursor, Claude, Copilot, OpenAI). Kit sdlc: Artifacts: ADR, CODEBASE, DECOMPOSITION, DESIGN, FEATURE, PR-CODE-REVIEW-TEMPLATE, PR-REVIEW, PR-STATUS-REPORT-TEMPLATE, PRD; Workflows: migrate-openspec, pr-review, pr-status.

★ 3
constructorfabric
constructorfabric/insight-front

cypilot-workspace

Multi-repo workspace setup — discover repos, configure sources, generate workspace config, validate

★ 3