Agent Skills
› tzachbon/smart-ralph
tzachbon/smart-ralph
GitHub指导在Claude Code中创建和管理Slash命令，涵盖文件结构、YAML配置、动态参数及最佳实践，旨在提升开发工作流的复用性与一致性。
安装全部 Skills
npx skills add tzachbon/smart-ralph --all -g -y
集合内 Skills (30)
指导在Claude Code中创建和管理Slash命令，涵盖文件结构、YAML配置、动态参数及最佳实践，旨在提升开发工作流的复用性与一致性。
创建斜杠命令
编写自定义命令
定义命令参数
使用命令前置元数据
组织命令结构
npx skills add tzachbon/smart-ralph --skill Command Development -g -y
提供Claude Code插件集成Model Context Protocol (MCP)服务器的指导，涵盖stdio、SSE、HTTP和WebSocket等类型配置及OAuth认证。
添加MCP服务器
集成MCP
在插件中配置MCP
使用.mcp.json
设置Model Context Protocol
连接外部服务
npx skills add tzachbon/smart-ralph --skill MCP Integration -g -y
定义Claude Code插件的本地配置模式，支持在.claude目录下通过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消耗并提高终端交互速度。
用户要求生成计划或方案时
需要输出技术决策或实施步骤时
Agent进行日常任务响应时
npx skills add tzachbon/smart-ralph --skill communication-style -g -y
定义主Agent作为协调者而非执行者的核心原则，禁止直接实现代码或任务，强制通过Task工具将工作委派给具备特定专长的子Agent，确保职责分离与上下文清晰。
用户发起开发任务请求
需要生成规范、设计或执行代码时
Agent试图自行编写代码或文件时
npx skills add tzachbon/smart-ralph --skill delegation-principle -g -y
定义Ralph插件通用的参数、执行模式及共享行为，包括交互与快速模式的切换逻辑、状态管理及自动提交规范。
配置Ralph插件通用行为
解析命令行参数优先级
npx skills add tzachbon/smart-ralph --skill smart-ralph -g -y
基于宪法的特性开发工作流，涵盖规范、计划、任务与实现阶段。提供目录结构、ID系统及分阶段执行指南，确保开发一致性与治理明确性。
需要遵循项目宪法进行新功能设计
生成或更新特性规格说明书
创建技术实施计划
npx skills add tzachbon/smart-ralph --skill speckit-workflow -g -y
用于停止 Ralph Specum 执行流程或移除指定规范文档的技能。支持安全取消（仅清除状态）和完全删除（需确认），确保操作准确并报告结果。
用户明确要求停止 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-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-requirements
用户要求运行 Ralph Specum 的需求阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-requirements -g -y
协调 Ralph Specum 规范的研究阶段，通过委派子代理生成研究报告并管理状态流转。
用户显式请求使用 $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 在 Codex 中的状态或活跃规格进度
npx skills add tzachbon/smart-ralph --skill ralph-specum-status -g -y
用于在 Codex 中切换当前活跃的规格（spec）。通过解析配置文件发现规格目录，根据名称或路径定位目标，更新当前状态文件并汇总规格进度与审批信息。
用户显式请求使用 $ralph-specum-switch
用户要求切换 Ralph Specum 中的活跃规格
npx skills add tzachbon/smart-ralph --skill ralph-specum-switch -g -y
协调任务规划阶段，将工作委派给子代理生成tasks.md，更新状态与进度文件，并管理审批流程或快速进入实现。
用户明确要求使用 $ralph-specum-tasks
用户要求 Ralph Specum 运行 tasks 阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-tasks -g -y
协调大型需求分解为多个规格说明。通过委托子代理执行探索、分解和验证，生成包含愿景、依赖图和接口的Epic计划，并管理状态流转与审批。
用户显式调用 $ralph-specum-triage
用户要求对大型任务进行规格说明分级
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 生成规格文档时的输出风格，要求极致简洁、结构化扫描友好。通过限制篇幅、使用碎片化表达和表格，确保内容易读且节省 Token，适用于所有规格阶段代理的输出格式化。
生成 spec artifacts (research.md, requirements.md, design.md, tasks.md)
需要指导 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状态记录与VF任务格式，检查测试质量及Mock反模式，确保修复真实有效。
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插件核心技能，定义通用参数、执行模式（交互/快速）、状态管理、提交行为及协调器委派规则。用于指导Ralph Specum的操作流程与行为逻辑。
查询ralph参数配置
了解快速模式用法
查看状态文件结构
获取执行模式指南
咨询协调器委派行为
npx skills add tzachbon/smart-ralph --skill smart-ralph -g -y
提供基于规范的开发工作流，涵盖从需求调研、设计到任务分解及自主实现的完整流程。支持单功能快速原型、交互式引导开发及大型功能的史诗级拆解与编排，实现结构化的特性构建。
构建新功能
创建规格说明
启动规范驱动开发
运行研究阶段
生成需求文档
创建设计方案
规划任务
实施规格
检查规格状态
功能分类
创建史诗任务
分解大型功能
npx skills add tzachbon/smart-ralph --skill spec-workflow -g -y
提供 Claude Code 插件 Hook 开发指南，涵盖 Prompt 和 Command 两种类型，详解 PreToolUse 等事件配置格式，用于实现自动化验证、策略执行及工作流集成。
创建或添加 Hook
验证工具调用安全性
配置事件驱动自动化
实施基于提示词的 Hook
npx skills add tzachbon/smart-ralph --skill Hook Development -g -y
