Agent Skills
› tzachbon/smart-ralph
tzachbon/smart-ralph
GitHub指导如何为Claude Code创建和管理斜杠命令，涵盖文件结构、YAML配置、动态参数及最佳实践。
Install All Skills
npx skills add tzachbon/smart-ralph --all -g -y
Skills in Collection (30)
指导如何为Claude Code创建和管理斜杠命令，涵盖文件结构、YAML配置、动态参数及最佳实践。
创建斜杠命令
添加自定义命令
定义命令参数
组织命令结构
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 四种服务器类型的实现与认证流程。
add MCP server
integrate MCP
configure MCP in plugin
use .mcp.json
set up Model Context Protocol
connect external service
mentions ${CLAUDE_PLUGIN_ROOT} with MCP
discusses MCP server types
npx skills add tzachbon/smart-ralph --skill MCP Integration -g -y
定义 Claude Code 插件本地配置模式，支持通过 .local.md 文件存储 YAML frontmatter 格式的每项目设置与状态，并提供 Bash 解析、命令及 Agent 读取配置的示例。
询问插件设置或配置方法
需要实现用户可配置的插件行为
处理 .local.md 文件或 YAML frontmatter 数据
npx skills add tzachbon/smart-ralph --skill Plugin Settings -g -y
提供 Claude Code 插件的标准目录结构、组件组织方式及 manifest 配置指南，辅助用户创建、脚手架化或理解插件架构。
create a plugin
scaffold a plugin
understand plugin structure
npx skills add tzachbon/smart-ralph --skill Plugin Structure -g -y
提供 Claude Code 插件技能开发的指导，涵盖技能结构、元数据规范及资源组织最佳实践。
创建新技能
改进技能描述
编写 SKILL.md
优化技能结构
npx skills add tzachbon/smart-ralph --skill Skill Development -g -y
定义Agent输出规范，要求极致简洁、结构化扫描友好及行动导向。旨在降低Token成本并提升终端阅读效率，适用于所有Agent的沟通与计划输出。
需要生成代码计划或技术文档时
Agent进行任务拆解或步骤规划时
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
定义 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 执行或移除 spec 的技能。支持按路径或名称解析目标，默认安全取消仅清除状态文件，全量删除需确认并保留 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，否则生成可直接粘贴的 Issue 草稿和链接。
用户明确要求使用 $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-implement
要求 Ralph Specum 在 Codex 中运行实施或继续请求
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
该 Skill 用于在实现后根据新学到的知识重构规范文档。作为协调员，它委派子代理更新需求、设计和任务文件，确保下游内容随上游变更同步，并记录决策理由。
用户显式请求使用 $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
协调 Ralph Specum 的任务规划阶段，解析规范与需求，委派子代理生成任务清单并更新进度状态。
用户显式请求使用 $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 协调器，用于管理软件开发生命周期工作流。通过路由意图并委派给子代理（如研究、需求、设计、实施）来处理项目阶段，同时维护状态和路径解析。
用户显式调用 $ralph-specum
请求 Ralph Specum 处理特定阶段
要求使用自主模式或快速模式
npx skills add tzachbon/smart-ralph --skill ralph-specum -g -y
规范 Agent 输出风格，要求极致精简、碎片化表达及表格/列表结构。旨在降低 Token 消耗，提升终端阅读效率，适用于所有 Ralph 规格文档生成阶段。
生成 spec artifacts
格式化 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
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
规范化的特性开发工作流技能，支持从需求研究、设计到任务分解及自主实现的端到端管理。提供单特性与大型史诗（Epic）分解模式，通过结构化阶段引导开发并自动生成产物。
构建新功能
生成需求或设计文档
规划开发任务
执行规范驱动的开发流程
拆解大型功能模块
npx skills add tzachbon/smart-ralph --skill spec-workflow -g -y
提供 Claude Code 插件钩子开发指南，涵盖 Prompt-Based 和 Command 两种类型，详解 PreToolUse、Stop 等事件配置及 hooks.json/settings.json 格式差异。
创建钩子
实现 PreToolUse/PostToolUse/Stop 钩子
验证工具使用
设置事件驱动自动化
npx skills add tzachbon/smart-ralph --skill Hook Development -g -y
