openxiangshan/xiangshanlab/riscv-skill-pack

RISC-V Skill Pack

Meta-skill / entry point. This file is a dispatcher: it tells you which

sub-skill to load for a given task. The actual workflows live in the five

files under sub-skills/. Always load the relevant sub-skill before

executing — this file only routes.

概述 (Overview)

RISC-V 规范学习、Gap 分析、需求分析、治理跟进、遗留问题转化 的一站式 skill pack。

The pack routes to five specialized sub-skills from a single, role-aware entry point (originally four merged skills, since extended with newly distilled additions). Each sub-skill is self-contained and can be loaded independently. This file helps you pick the right one.

Design principles

• Evidence-first: every claim must carry a source tag ([T1-VERIFIED],

[T2-CROSS-CHECKED], or [UNVERIFIED]). No improvisation.

• Redacted by default: all sub-skills use generic placeholders

(MEMBER-XX-XXX, ORG-00, RVI-XXX). Replace them with your project's actual identifiers before use.

• Sequential where needed: gap-analysis Part 2 (slides) REQUIRES a

Part 1 doc as input — never re-derive evidence inside slides.

功能概览 (Feature Overview)

Loading convention: reference sub-skills by relative path from this

file, e.g. sub-skills/spec-learning.md. Do not hardcode absolute paths.

角色推荐 (Role Recommendations)

Cross-role note: spec-learning is the foundational skill — every role

benefits from loading it first to ground claims in tier-1 sources.

何时激活 (When to Activate)

Load this entry file when a task involves any of:

• Looking up or citing a RISC-V specification, extension, CSR, or instruction.
• Performing a feature gap analysis or producing a gap/review document.
• Building, refreshing, or querying a CPU requirement matrix.
• Tracking a Task Group's spec maturity or transmitting requirements to a partner.
• Translating architecture documents (CN ↔ EN) with consistent terminology.
• Converting previous-generation legacy issues (product risk register, gap

matrix, unclosed review items, member/internal feedback, delivery-doc gaps) into next-generation requirement candidates.

Then dispatch to the matching sub-skill using the Feature Overview table above. Do not execute the workflow from this file — load the sub-skill.

使用示例 (Usage Examples)

Example 1 — Query a RISC-V specification (→ spec-learning)

/skill spec-learning
请查询 RISC-V Privileged spec v1.12 中关于 page table (Sv39/Sv48/Sv57) 的定义，
并标注 ratification 状态和引用层级 (UDB / Normative / Ratified)。

Expected output: a citation block with layer tags, e.g. [Layer 3] Ratified: https://github.com/riscv/riscv-isa-manual/releases — Sv39 layout.

Example 2 — Gap analysis for a feature (→ gap-analysis)

/skill gap-analysis
基于 MEMBER-00-GP 的 MMIO Outstanding 需求 (REQ-XXX)，对比 RISC-V Privileged spec
v1.12 与 Arm Neoverse V2，生成 F{N} gap 分析文档（9 节结构），并在 §4 执行
XiangShan 仓库复核。

Expected output: _internal_Gap_Analysis_F{N}_MMIO_Outstanding.md saved to <delivery-dir>/04_专题/, with source-tag distribution (aim T1 > 90%) and 8-12 sub-requirement rows.

Example 3 — Requirement query (→ requirement-analysis)

/skill requirement-analysis
查询 MEMBER-00-GP 的虚拟化需求：列出所有 RAS / IOMMU / confidential-compute
相关条目，标注优先级 (P0/P1/P2) 和 V2R2 → V3R3 delta。

Expected output: a structured view of matching requirement rows, each with source tag, mapping type, and the V2R2/V3R3 carryover status.

Example 4 — Governance: TG tracking (→ governance)

/skill governance
IOPMP TG spec 当前版本 v0.8.2 (Draft)，我们的 R1 产品使用自研静态 I/O 隔离方案。
请评估：spec ratification 延后到 2027 H1 对 R2/R3 的交付风险，并给出 mitigation。

Expected output: a TG tracking matrix row + risk assessment (🟢/🟡/🔴) + self-developed fallback convergence plan.

Example 5 — Cross-skill: spec → gap → requirement

A realistic flow spans multiple sub-skills:

1. /skill spec-learning      → ground the feature definition in tier-1 sources
2. /skill requirement-analysis → find the matching requirement row & priority
3. /skill gap-analysis        → produce the F{N} gap doc + review slides

Always start with spec-learning to establish the evidence base, then fan out to the analytical sub-skills.

子文件参考路径 (Sub-skill Reference Paths)

All paths are relative to this file (SKILL.md):

riscv-skill-pack/
├── SKILL.md                          ← you are here
├── sub-skills/
│   ├── spec-learning.md              ← ISA spec navigation + Tier-1 mapping
│   ├── gap-analysis.md               ← Gap doc (Part 1) + review slides (Part 2)
│   ├── requirement-analysis.md       ← Requirement workflow + feature list + query
│   ├── governance.md                 ← TG tracking + partner comms + glossary
│   └── legacy-issues-requirements.md ← Legacy issues → next-gen requirement candidates
├── examples/                         ← (populated in later task)
├── README.md                         ← public-facing readme (populated in later task)
└── LICENSE                           ← Apache-2.0

脱敏与占位符约定 (Redaction & Placeholder Convention)

All sub-skills in this pack are redacted templates. Before use, replace the following placeholders with your project's actual identifiers:

Do not submit documents with placeholder names to external audiences.

The _internal_ file prefix marks docs that must never enter an external

release zip.

License

Apache-2.0 — see LICENSE.