Agent Skills
› tzachbon/smart-ralph
tzachbon/smart-ralph
GitHub指导如何为 Claude Code 创建、配置和管理斜杠命令，涵盖文件结构、YAML frontmatter、动态参数及执行最佳实践。
Install All Skills
npx skills add tzachbon/smart-ralph --all -g -y
Skills in Collection (30)
指导如何为 Claude Code 创建、配置和管理斜杠命令，涵盖文件结构、YAML frontmatter、动态参数及执行最佳实践。
创建斜杠命令
添加自定义命令
定义命令参数
使用命令 frontmatter
组织命令结构
npx skills add tzachbon/smart-ralph --skill Command Development -g -y
指导在 Claude Code 插件中集成 Model Context Protocol (MCP) 服务器，支持通过 .mcp.json 或 plugin.json 配置，涵盖 stdio、SSE、HTTP 及 WebSocket 四种连接方式，用于接入外部服务和 API。
添加 MCP 服务器
集成 MCP
配置插件中的 MCP
使用 .mcp.json
设置 Model Context Protocol
连接外部服务
npx skills add tzachbon/smart-ralph --skill MCP Integration -g -y
介绍Claude Code插件的配置模式，说明如何通过.claude/plugin-name.local.md文件存储用户可配置的设置和状态。包含YAML frontmatter结构解析及在Hooks、Commands和Agents中的读取方法。
询问插件设置
配置用户可定制的插件
处理 .local.md 文件
读取 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
定义 Agent 输出规范，要求极致简洁、结构化及可扫描。规定以片段和表格替代长句，按概览、内容、问题、步骤顺序输出，旨在提升终端阅读效率并降低 Token 成本。
生成计划或方案时
输出技术文档或代码注释时
需要总结或概述信息时
npx skills add tzachbon/smart-ralph --skill communication-style -g -y
定义主Agent作为协调者而非执行者的核心原则，禁止直接实现代码或任务，必须通过Task工具将工作委派给具备特定专长的子Agent，确保职责分离与流程规范。
需要协调多阶段开发流程
决定如何分配子任务给不同专家角色
npx skills add tzachbon/smart-ralph --skill delegation-principle -g -y
定义Smart Ralph插件核心的通用参数、执行模式及共享行为，包括快速/交互模式、提交逻辑、状态管理及任务完成协议。
配置或开发Ralph系列插件
需要统一插件的命令行参数和状态管理逻辑
npx skills add tzachbon/smart-ralph --skill smart-ralph -g -y
基于宪法驱动的特性开发工作流，涵盖规范、计划与实现阶段。通过明确治理规则和质量检查清单，确保功能开发的一致性与合规性。
需要制定新功能的技术规范
生成特性实施计划
npx skills add tzachbon/smart-ralph --skill speckit-workflow -g -y
用于停止 Ralph Specum 执行流程或移除指定规范。支持安全取消（仅清状态）或完全删除，需确认操作目标及范围，避免误删关联文件。
用户明确要求使用 $ralph-specum-cancel 命令
用户要求 Ralph Specum 在 Codex 中停止执行
用户要求移除某个 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 报告。通过整理问题摘要、复现步骤和环境信息，生成详细的 Issue 草稿或直接提交至 GitHub。
用户明确要求使用 $ralph-specum-feedback
请求 Ralph Specum 起草或提交反馈
npx skills add tzachbon/smart-ralph --skill ralph-specum-feedback -g -y
用于解释 Codex 中 Ralph Specum 技能集的使用方法和流程，包括入口推荐、阶段控制及审批机制。
用户显式请求使用 $ralph-specum-help
用户询问 Ralph Specum 命令或帮助指南
npx skills add tzachbon/smart-ralph --skill ralph-specum-help -g -y
协调 Ralph Specum 实施流程，作为协调者而非执行者。负责解析规范、计算任务状态，并将具体实现任务委派给 spec-executor 子代理，同时管理进度更新和状态持久化。
用户显式请求使用 $ralph-specum-implement
明确要求 Ralph Specum 在 Codex 中运行实施、快速模式或继续请求
npx skills add tzachbon/smart-ralph --skill ralph-specum-implement -g -y
用于生成和刷新代码库的可搜索索引规范。通过解析用户范围扫描代码结构，生成标准化的组件与外部规格文件，确保输出确定性以便复用，并支持干跑模式及明确的审批交互流程。
用户显式请求使用 $ralph-specum-index
用户要求 Ralph Specum 在 Codex 中生成或刷新索引制品
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-requirements
用户要求 Ralph Specum 运行需求阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-requirements -g -y
协调Ralph Specum研究阶段，委托子智能体生成research.md并管理状态流转。
用户显式请求使用 $ralph-specum-research
显式要求Ralph Specum运行研究阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-research -g -y
用于启动或恢复 Ralph Specum 规范。解析参数，初始化状态，管理分支隔离，并在设置后等待用户确认是否继续研究。
显式调用 $ralph-specum-start
请求在 Codex 中启动或恢复 Ralph Specum
npx skills add tzachbon/smart-ralph --skill ralph-specum-start -g -y
用于查询 Ralph Specum 项目状态的工具，通过读取规范根目录下的状态文件、任务列表等，汇总并展示活跃规范、阶段、待办及审批状态。
用户明确要求使用 $ralph-specum-status
用户询问 Ralph Specum 在 Codex 中的状态或活跃规范进度
npx skills add tzachbon/smart-ralph --skill ralph-specum-status -g -y
用于切换活跃规范（spec）的工具。支持解析配置、列出可用规范、处理歧义并更新当前状态，适用于明确请求切换 Ralph Specum 的场景。
用户显式要求使用 $ralph-specum-switch
用户明确要求切换活跃的 spec
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
用于将大型开发任务分解为多个规范（specs）的协调技能。通过委派子代理进行探索、分解和验证，生成包含愿景、依赖关系和接口的史诗计划，并管理执行状态。
用户显式请求使用 $ralph-specum-triage
用户要求 Ralph Specum 对大型工作进行规格分解
npx skills add tzachbon/smart-ralph --skill ralph-specum-triage -g -y
Ralph Specum 是 Codex 中协调软件开发生命周期的核心技能，负责路由需求、设计、实施等阶段，委托子代理执行具体任务并管理项目状态。
用户显式调用 $ralph-specum
请求 Ralph Specum 处理特定阶段
请求自主或快速模式
npx skills add tzachbon/smart-ralph --skill ralph-specum -g -y
规范 Ralph Agent 输出风格，要求极致简练、结构化扫描式排版。适用于生成规格文档及格式化 Agent 结果，强调碎片化表达与动作导向，提升终端阅读效率并降低 Token 成本。
生成 spec 文档
格式化 Agent 输出
npx skills add tzachbon/smart-ralph --skill communication-style -g -y
用于需求调研阶段的自适应对话框架，通过代码优先探索与用户决策确认，引导收集规格说明前的需求。
运行交互式面试以收集需求
在规格制定前进行适应性头脑风暴
npx skills add tzachbon/smart-ralph --skill interview-framework -g -y
指导在修复任务中先复现故障再验证解决，通过记录BEFORE/AFTER状态确保修复有效，并检查测试质量以识别Mock滥用反模式。
verify a fix
reproduce failure
diagnose issue
check BEFORE/AFTER state
reality check
npx skills add tzachbon/smart-ralph --skill reality-verification -g -y
Ralph插件核心技能，定义通用参数、执行模式（普通/快速）、状态管理、提交行为及协调器委派规则。用于指导用户进行Ralph Specum操作、配置插件参数及理解执行循环与代理协作机制。
询问 Ralph 参数或命令行选项
需要了解快速模式与普通模式的区别
查询状态文件或提交行为逻辑
需要协调器委派或执行循环指导
npx skills add tzachbon/smart-ralph --skill smart-ralph -g -y
指导基于规格驱动的开发工作流，支持从需求研究、设计到任务分解和自主实现的完整流程。提供单功能规格及大型特性（Epic）的分解与编排能力，涵盖快速原型和引导式开发模式。
构建新功能
创建规格文档
启动规格驱动开发
运行研究阶段
生成需求
创建设计方案
规划任务
实现规格
检查规格状态
特性分类
创建史诗（Epic）
分解大型特性
获取工作流指导
npx skills add tzachbon/smart-ralph --skill spec-workflow -g -y
提供 Claude Code 插件 Hook 开发指南，涵盖 Prompt-Based 和 Command 类型，指导用户配置 PreToolUse 等事件以实现自动化验证、策略执行及工作流集成。
创建 Hook
添加 PreToolUse/PostToolUse/Stop Hook
实现基于提示的 Hook
设置事件驱动自动化
npx skills add tzachbon/smart-ralph --skill Hook Development -g -y
