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
- 参考文档AGENTS.md2.0 KB
- 参考文档artifacts/ADR/checklist.md26.6 KB
- 参考文档artifacts/ADR/examples/example.md3.0 KB
- 参考文档artifacts/ADR/rules.md18.0 KB
- 参考文档artifacts/ADR/template.md2.1 KB
- 参考文档artifacts/DECOMPOSITION/checklist.md20.3 KB
- 参考文档artifacts/DECOMPOSITION/examples/example.md3.6 KB
- 参考文档artifacts/DECOMPOSITION/rules.md13.0 KB
- 参考文档artifacts/DECOMPOSITION/template.md3.8 KB
- 参考文档artifacts/DESIGN/checklist.md34.7 KB
- 参考文档artifacts/DESIGN/examples/example.md7.2 KB
- 参考文档artifacts/DESIGN/rules.md15.8 KB
- 参考文档artifacts/DESIGN/template.md6.8 KB
- 参考文档artifacts/FEATURE/checklist.md32.7 KB
- 参考文档artifacts/FEATURE/examples/example.md5.1 KB
- 参考文档artifacts/FEATURE/rules.md18.8 KB
- 参考文档artifacts/FEATURE/template.md3.8 KB
- 参考文档artifacts/PR-CODE-REVIEW-TEMPLATE/template.md3.3 KB
- 参考文档artifacts/PR-STATUS-REPORT-TEMPLATE/template.md2.6 KB
- 参考文档artifacts/PRD/checklist.md36.8 KB
- 参考文档artifacts/PRD/examples/example.md6.8 KB
- 参考文档artifacts/PRD/rules.md15.6 KB
- 参考文档artifacts/PRD/template.md5.3 KB
- 参考文档codebase/checklist.md4.2 KB
- 参考文档codebase/rules.md16.6 KB
- 其他conf.toml1.6 KB
- 其他constraints.toml29.0 KB
- 脚本scripts/pr-review.toml1.7 KB
- 脚本scripts/pr.py31.1 KB
- 脚本scripts/prompts/pr/adr-review.md608 B
- 脚本scripts/prompts/pr/code-review.md464 B
- 脚本scripts/prompts/pr/design-review.md660 B
- 脚本scripts/prompts/pr/prd-review.md688 B
- 参考文档workflows/migrate-openspec.md47.5 KB
- 参考文档workflows/pr-review.md6.6 KB
- 参考文档workflows/pr-status.md5.5 KB
03 SKILL.md 正文
Cypilot Skill — Kit sdlc
Kit sdlc skill extensions.
ADR
ADR Commands
cypilot validate --artifact <ADR.md>— validate ADR structure and IDscypilot list-ids --kind adr— list all ADRscypilot where-defined --id <id>— find where an ADR ID is definedcypilot 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 qualitycypilot where-defined --id <id>— find where an ID is defined in artifactscypilot 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 IDscypilot list-ids --kind feature— list all featurescypilot list-ids --kind status— list status indicatorscypilot where-defined --id <id>— find where a feature ID is definedcypilot 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 IDscypilot list-ids --kind component— list all componentscypilot list-ids --kind principle— list all design principlescypilot where-defined --id <id>— find where a DESIGN ID is definedcypilot 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 IDscypilot list-ids --kind flow— list all flowscypilot list-ids --kind algo— list all algorithmscypilot list-ids --kind state— list all state machinescypilot list-ids --kind dod— list all definitions of donecypilot where-defined --id <id>— find where a FEATURE ID is definedcypilot 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 PRsshow 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:
- Run
python3 config/kits/sdlc/scripts/pr.py list - Present the output to the user (respects
.prs/config.yamlexclude list) - No Protocol Guard or workflow loading required — this is a quick command
PR Review Workflow
When routed to PR review:
- ALWAYS fetch fresh data first — run
pr.py fetcheven if data exists from a prior run - Read
config/kits/sdlc/workflows/pr-review.mdand follow its steps - Use
python3 config/kits/sdlc/scripts/pr.pyas the script - When target is
ALLor no PR number given, runpr.py listfirst to show available PRs - Select prompt and checklist from
{cypilot_path}/config/pr-review.toml→prompts - Load prompt from
prompt_fileand checklist fromchecklistin matched entry - Use templates from
config/kits/sdlc/artifacts/PR-CODE-REVIEW-TEMPLATE/template.mdandconfig/kits/sdlc/artifacts/PR-STATUS-REPORT-TEMPLATE/template.md
PR Status Workflow
When routed to PR status:
- ALWAYS fetch fresh data first —
pr.py statusauto-fetches, but never assume prior data is current - Read
config/kits/sdlc/workflows/pr-status.mdand follow its steps - Use
python3 config/kits/sdlc/scripts/pr.pyas the script - When target is
ALLor no PR number given, runpr.py listfirst 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 openspeccypilot migrate-openspec,openspec to cypilot- Any request to convert OpenSpec artifacts to Cypilot SDLC format
When routed to OpenSpec migration:
- Read
config/kits/sdlc/workflows/migrate-openspec.mdand follow its steps - The workflow handles all configuration discovery and user interaction
PRD
PRD Commands
cypilot validate --artifact <PRD.md>— validate PRD structure and IDscypilot list-ids --kind fr— list all functional requirementscypilot list-ids --kind actor— list all actorscypilot where-defined --id <id>— find where a PRD ID is definedcypilot 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
config
暂无简介
.gen
暂无简介
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).
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.
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.
cypilot-workspace
Multi-repo workspace setup — discover repos, configure sources, generate workspace config, validate