Agent Skills
› tzachbon/smart-ralph
tzachbon/smart-ralph
GitHub指导如何为 Claude Code 创建、配置和组织 Slash 命令，涵盖 Markdown 结构、YAML 前置元数据、动态参数及执行最佳实践。
安装全部 Skills
npx skills add tzachbon/smart-ralph --all -g -y
集合内 Skills (30)
指导如何为 Claude Code 创建、配置和组织 Slash 命令，涵盖 Markdown 结构、YAML 前置元数据、动态参数及执行最佳实践。
创建斜杠命令
编写自定义命令
定义命令参数
使用命令前置元数据
组织命令结构
npx skills add tzachbon/smart-ralph --skill Command Development -g -y
指导在 Claude Code 插件中集成 Model Context Protocol (MCP) 服务器，涵盖 .mcp.json 配置、stdio/SSE/HTTP/WebSocket 四种协议类型及 OAuth 认证等外部服务连接方案。
add MCP server
integrate MCP
configure MCP in plugin
use .mcp.json
set up Model Context Protocol
connect external service
npx skills add tzachbon/smart-ralph --skill MCP Integration -g -y
介绍在项目中通过 .local.md 文件存储插件配置与状态的模式，涵盖 YAML frontmatter 结构及从 Hooks、Commands 和 Agents 读取配置的方法。
询问插件设置
存储插件配置
用户可配置的插件
读取 YAML frontmatter
项目级插件设置
npx skills add tzachbon/smart-ralph --skill Plugin Settings -g -y
提供Claude Code插件的标准目录结构、manifest配置及组件组织指南，帮助用户创建、脚手架化或理解插件架构。
创建插件
插件脚手架
理解插件结构
配置plugin.json
npx skills add tzachbon/smart-ralph --skill Plugin Structure -g -y
提供 Claude Code 插件技能开发的指导，涵盖技能结构、元数据编写规范及资源组织最佳实践。
创建新技能
改进技能描述
组织技能内容
了解技能开发最佳实践
npx skills add tzachbon/smart-ralph --skill Skill Development -g -y
定义AI代理的输出规范，要求极致简洁、结构化且可操作。通过碎片化表达、表格和列表提升扫描效率，强制以行动步骤结尾，旨在降低Token消耗并提高终端交互速度。
需要生成开发计划或技术方案时
输出代码建议或任务分解时
npx skills add tzachbon/smart-ralph --skill communication-style -g -y
定义主代理作为协调者而非执行者的核心原则，禁止直接实现工作，必须通过Task工具将所有任务委派给具有特定专长的子代理处理，确保职责分离与专业化。
用户请求执行具体开发或配置任务
需要生成代码、文件或进行系统变更
npx skills add tzachbon/smart-ralph --skill delegation-principle -g -y
定义 Ralph 插件通用的参数解析、执行模式（交互/快速）、状态管理及提交逻辑，为所有插件提供基础行为支撑。
需要统一配置智能代理执行流程
开发或维护 Ralph 系列插件
npx skills add tzachbon/smart-ralph --skill smart-ralph -g -y
提供基于宪法驱动的规范驱动开发工作流，涵盖从建立项目原则、定义特性规格、澄清歧义到制定技术计划的全过程，确保功能开发的一致性与合规性。
需要按照规范驱动方法规划新功能
需要创建或更新项目宪法文档
需要将需求转化为结构化规格和任务
npx skills add tzachbon/smart-ralph --skill speckit-workflow -g -y
用于在Codex中通过Ralph Specum停止执行或移除规格文件。支持安全取消（仅清除状态）和完全移除，需确认目标并处理相关epic文件，确保操作可追溯且无歧义。
用户明确要求使用 $ralph-specum-cancel
用户要求Ralph Specum停止执行
用户要求移除某个spec
npx skills add tzachbon/smart-ralph --skill ralph-specum-cancel -g -y
协调软件设计阶段，解析需求并委托子代理生成架构设计文档。负责状态管理、进度更新及用户审批流程，确保设计输出涵盖架构、接口与测试策略等关键要素。
用户显式请求使用 $ralph-specum-design
要求 Ralph Specum 运行设计阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-design -g -y
用于捕获 Ralph Specum 的产品反馈或 bug 报告。通过总结问题、收集复现上下文，利用 gh 工具创建 GitHub Issue 或生成可粘贴的草稿内容。
用户明确要求使用 $ralph-specum-feedback
用户要求为 Ralph Specum 起草或提交反馈
npx skills add tzachbon/smart-ralph --skill ralph-specum-feedback -g -y
提供 Ralph Specum 在 Codex 中的使用指南，解释主技能、辅助技能及工作流（正常/大型/快速模式），指导用户如何触发和审批各阶段。
用户明确要求使用 $ralph-specum-help
用户询问 Ralph Specum 的帮助或命令指南
npx skills add tzachbon/smart-ralph --skill ralph-specum-help -g -y
协调 Ralph Specum 实施流程，通过解析规范与任务状态，将具体实现委托给子代理执行，负责进度同步、批处理逻辑及异常恢复。
用户明确要求使用 $ralph-specum-implement
要求 Ralph Specum 运行已批准任务的实现
npx skills add tzachbon/smart-ralph --skill ralph-specum-implement -g -y
用于为现有代码库生成可搜索的索引规格文件，支持解析路径、类型等范围参数，扫描控制器、服务等组件，并输出到指定目录。
用户显式请求使用 $ralph-specum-index
用户要求 Ralph Specum 生成或刷新索引制品
npx skills add tzachbon/smart-ralph --skill ralph-specum-index -g -y
协调员角色，负责在实施后根据反馈重构需求、设计和任务规范。通过委派子代理执行具体修订，确保上游变更级联更新下游文件，并记录决策依据。
用户明确要求使用 $ralph-specum-refactor
要求 Ralph Specum 在实现学习后修订规范工件
npx skills add tzachbon/smart-ralph --skill ralph-specum-refactor -g -y
协调Ralph Specum的需求阶段，解析规格并委托子代理生成需求文档，管理状态流转与审批流程。
用户明确要求使用 $ralph-specum-requirements
用户要求 Ralph Specum 运行需求阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-requirements -g -y
协调软件需求调研阶段，解析规范并委派子代理生成调研报告，管理状态流转与审批流程。
用户显式调用 $ralph-specum-research
用户请求 Ralph Specum 执行调研阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-research -g -y
用于启动或恢复 Ralph Specum 规范。解析参数，定位或创建规范目录，初始化状态文件，并支持分支隔离。在快速模式外默认暂停等待用户指令，确保流程可控。
用户显式请求使用 $ralph-specum-start
用户要求启动或继续 Ralph Specum 规范
npx skills add tzachbon/smart-ralph --skill ralph-specum-start -g -y
用于查询 Ralph Specum 状态或活跃规格进度的技能。通过读取配置文件和目录结构，汇总各规范根下的活跃规范、史诗状态、任务完成情况及审批状态，提供清晰的进度概览和后续操作建议。
用户明确请求使用 $ralph-specum-status
用户询问 Ralph Specum 的状态或活跃规格进展
npx skills add tzachbon/smart-ralph --skill ralph-specum-status -g -y
用于在Codex中切换Ralph Specum的活跃规范文件。通过解析配置和目录结构，根据用户请求或列出可用选项，更新当前规范状态并展示其阶段、进度及文件详情。
用户明确要求使用 $ralph-specum-switch
用户要求切换 Ralph Specum 的活跃规范
npx skills add tzachbon/smart-ralph --skill ralph-specum-switch -g -y
协调任务规划阶段，解析规范并委托子代理生成任务列表。维护状态、更新进度文件，并根据模式决定是否继续执行或等待审批。
用户显式请求运行 Ralph Specum tasks 阶段
用户调用 $ralph-specum-tasks
npx skills add tzachbon/smart-ralph --skill ralph-specum-tasks -g -y
用于将大型需求拆分为多个规格说明的协调技能。通过委派子代理执行探索、分解和验证，生成包含愿景、依赖关系和接口的史诗计划，并管理状态流转。
用户显式调用 $ralph-specum-triage
请求 Ralph Specum 对大型工作进行规格拆分
npx skills add tzachbon/smart-ralph --skill ralph-specum-triage -g -y
Ralph Specum是Codex中的核心协调技能，负责管理软件开发生命周期的全流程。它通过路由意图并委托给专门的子代理（如研究、设计、实施）来执行具体任务，同时维护项目状态和配置，确保工作流有序进行。
用户显式调用 $ralph-specum
请求启动、恢复或快速模式
询问当前规范状态
npx skills add tzachbon/smart-ralph --skill ralph-specum -g -y
定义Ralph Agent生成规范文档时的极简输出风格，通过碎片化表达、表格结构和底部行动步骤提升终端扫描效率与速度。
生成spec artifacts如research.md或design.md
需要格式化Agent输出以符合简洁规范时
npx skills add tzachbon/smart-ralph --skill communication-style -g -y
用于在规格制定前通过交互式对话收集需求，自动区分代码事实与用户决策，引导澄清问题并支持自适应头脑风暴。
运行交互式面试以收集需求
需要自适应头脑风暴对话时
npx skills add tzachbon/smart-ralph --skill interview-framework -g -y
用于在修复代码前复现失败、修复后验证解决情况，并检查测试质量（如模拟反模式）。通过记录前后状态确保问题真正解决，防止回归。
verify a fix
reproduce failure
diagnose issue
check BEFORE/AFTER state
VF task
reality check
check test quality
npx skills add tzachbon/smart-ralph --skill reality-verification -g -y
提供Ralph插件的核心行为指南，涵盖参数配置、执行模式（普通/快速）、状态管理、提交规范及协调器委派规则，用于指导Agent高效完成Specum操作。
查询ralph参数或执行模式
需要快速生成或交互式审查Spec文件
处理状态文件或提交行为问题
配置协调器与子代理的委派逻辑
npx skills add tzachbon/smart-ralph --skill smart-ralph -g -y
提供基于规范的开发工作流，涵盖从需求调研、设计到任务分解和自主实现的完整流程。支持单功能规范和大型史诗功能的拆解与编排，辅助用户高效进行特性开发与项目管理。
构建新功能
创建开发规范
启动规范驱动开发
运行研究阶段
生成需求文档
创建设计方案
规划任务
实施规范
检查规范状态
特性分类
创建史诗功能
分解大型特性
npx skills add tzachbon/smart-ralph --skill spec-workflow -g -y
提供 Claude Code 插件钩子开发指南，涵盖 PreToolUse 等事件驱动自动化脚本的创建、验证及 Prompt/Command 类型实现配置。
创建钩子
添加 PreToolUse/PostToolUse 钩子
验证工具使用
实现基于提示词的钩子
设置事件驱动自动化
npx skills add tzachbon/smart-ralph --skill Hook Development -g -y
