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


