mcpField
R
rs-shared

rs-shared

github.com/rootspec开发057 次安装27 周前更新
代码仓库

关于 rs-shared

rs-shared 是供 RootSpec skills 共用的资源包，不应直接调用。它包含项目与规格扫描、验证、初始化、实现和测试支持脚本，以及框架文件和参考片段。

主要功能

  1. 01项目与规格扫描脚本
  2. 02包含六项检查的规格验证
  3. 03初始化与升级支持
  4. 04实现及 Cypress 测试辅助工具
  5. 05共享框架文件与指导片段

适用场景

  1. 01扫描项目的框架和配置详情
  2. 02验证规格结构与覆盖情况
  3. 03准备项目初始化或框架升级
  4. 04生成并汇报 Cypress 测试结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rootspec/rootspec --skill rs-shared

安装后在 Claude Code 中输入/rs-shared确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

00.AXIOMS.md
00.FRAMEWORK.md
README.md
cypress/
rootspec-reporter.ts
fragments/
anti-patterns.md
conventions.md
framework-rules.md
interview-protocol.md
l5-test-dsl.md
l5-yaml-format.md
prerequisites.md
test-runner-contract.md
scripts/
assess.sh
bootstrap-init.sh
build-tests-status.sh
check-app-ready.sh
check-coverage.sh
check-duplicate-ids.sh
check-hierarchy.sh
check-numerics.sh
check-pillar-quality.sh
check-tradeoffs.sh
check-vacuous-assertions.sh
compare-test-runs.sh
compute-spec-hash.sh
detect-prerequisites.sh
detect-stack.sh
dev.sh
filter-stories.sh
gap-analysis.sh

详细介绍

此技能包含所有 RootSpec 技能共用的资源。请勿直接调用。

技能

技能用途模式
/rs-init初始化项目 — 目录、基础文件、先决条件交互式
/rs-spec创建或更新规范 — 访谈 + 验证循环交互式（可跳过）
/rs-impl根据规范实现 — 测试驱动、自主执行非交互式
/rs-validate运行测试并报告结果非交互式
/rs-update将项目升级到最新框架版本交互式

脚本

项目扫描
  • scripts/scan-spec.sh — 查找规范目录，列出已找到/缺失的文件，检测版本
  • scripts/scan-project.sh — 检测框架、源代码目录、配置文件
规范验证
  • scripts/validate-spec.sh — 一次调用运行全部 6 项验证检查（层级、数值、重复 ID、支柱质量、权衡、覆盖率）
  • scripts/check-hierarchy.sh — 查找各规范层级之间向下引用的内容
  • scripts/check-numerics.sh — 查找 L1-L4 中的硬编码数字
  • scripts/check-duplicate-ids.sh — 查找 L5 中重复的故事 ID
  • scripts/check-pillar-quality.sh — 检查 L1 支柱数量和格式
  • scripts/check-tradeoffs.sh — 检查 L2 中是否有明确的权衡说明
  • scripts/check-coverage.sh — 交叉对照 L4 系统与 L5 故事
  • scripts/compute-spec-hash.sh — 计算所有规范文件的确定性哈希值
初始化和升级
  • scripts/detect-prerequisites.sh — 检测开发服务器、钩子、发布/测试脚本
  • scripts/verify-init.sh — 检查所有预期的初始化文件是否存在
  • scripts/gap-analysis.sh — 将项目版本与内置框架版本进行比较
实现支持
  • scripts/assess.sh — 一次调用预先加载 rs-impl 所需的全部内容（规范、项目、故事、约定、片段）
  • scripts/scaffold-cypress.sh — 一次调用创建所有 Cypress 基础设施文件（配置、支持文件、DSL、报告器）
  • scripts/generate-test-file.sh — 根据规范 YAML 构建 Cypress 测试文件（使用 loadAndRun 模式嵌入故事）
  • scripts/init-conventions.sh — 从 package.json、tsconfig、Tailwind 配置和源代码中提取约定
  • scripts/generate-test-report.sh — 将 tests-status.json 解析为格式化的通过/失败/未测试报告
故事和测试
  • scripts/filter-stories.sh — 按 ID、系统、优先级或状态筛选 L5 故事
  • scripts/parse-cypress-results.sh — 将 Cypress JSON 输出解析为故事/标准结果
  • scripts/build-tests-status.sh — 将测试结果合并到 tests-status.json
  • scripts/compare-test-runs.sh — 对比两次测试运行，报告回归/修复情况

内置文件

  • 00.AXIOMS.md — 基础信念（由 rs-init 复制到用户项目中）
  • 00.FRAMEWORK.md — 框架定义（由 rs-init 复制到用户项目中）

片段

  • fragments/framework-rules.md — 参考层级和占位符规则
  • fragments/interview-protocol.md — 访谈方法
  • fragments/anti-patterns.md — 各层级的常见反模式
  • fragments/prerequisites.md — 先决条件检测与创建
  • fragments/l5-yaml-format.md — 用户故事的 YAML 语法和微调
  • fragments/l5-test-dsl.md — 测试 DSL 步骤参考和扩展

评论

支持 Markdown