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)服务器，支持stdio、SSE、HTTP及WebSocket等多种连接方式，提供配置文件创建与外部服务对接的详细方案。
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
介绍 Claude Code 插件配置模式，通过 .local.md 文件存储项目级设置与状态。涵盖 YAML frontmatter 结构定义及从 Hooks、命令和 Agent 中读取配置的 Bash 解析方法。
询问插件设置或配置
管理用户可配置的插件状态
读取 .local.md 文件中的 YAML frontmatter
实现 per-project 的插件行为配置
npx skills add tzachbon/smart-ralph --skill Plugin Settings -g -y
指导创建和配置Claude Code插件，涵盖目录结构、manifest定义及组件组织规范。
创建插件
搭建插件脚手架
理解插件结构
配置插件清单
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
定义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 执行流程或移除指定规范。支持安全取消（仅清状态）和完全删除，需确认操作并处理关联的 Epic 文件，防止误删。
用户明确要求停止 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 使用方法
用户请求命令指南或帮助信息
npx skills add tzachbon/smart-ralph --skill ralph-specum-help -g -y
协调Ralph Specum实施流程，通过委派子代理执行任务。负责解析规范、计算计数器、管理状态及进度更新，确保任务有序完成并处理中断恢复。
用户显式请求使用 $ralph-specum-implement
要求Ralph Specum在Codex中运行实现或继续请求
npx skills add tzachbon/smart-ralph --skill ralph-specum-implement -g -y
用于为现有代码库生成可搜索的索引规范文件。根据用户指定的路径、类型等范围，扫描控制器、服务等组件，并更新或创建specs/.index目录下的索引文档，支持干跑模式以确保输出确定性。
用户明确要求使用$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的需求阶段，解析规范并委托子代理生成需求文档，管理状态流转与审批流程。
用户明确要求使用 $ralph-specum-requirements
用户要求运行 Ralph Specum 的需求阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-requirements -g -y
协调Ralph Specum研究阶段，委托子代理生成研究报告，管理状态合并与进度更新，并在快速模式外等待用户审批以推进后续需求。
用户显式请求使用$ralph-specum-research
用户明确要求Ralph Specum在Codex中运行研究阶段
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 的任务阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-tasks -g -y
协调大型需求拆解为多个规格说明。检查当前史诗状态，委托子代理执行探索、分解及验证，聚合生成史诗计划文件，并路由至下一步执行或等待审批。
用户显式请求使用 $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
规范Agent输出风格，要求极致简洁、碎片化表达及结构化排版（如表格、要点），优先扫描阅读。适用于生成规格文档或格式化所有Ralph Agent的输出结果，以提升效率并降低Token成本。
生成spec artifacts
格式化agent输出
需要指导简洁排版时
npx skills add tzachbon/smart-ralph --skill communication-style -g -y
提供交互式访谈框架，通过自适应对话收集需求。遵循3阶段算法（理解、提议、确认），优先探索代码库事实，限制选项数量并推荐最佳方案，用于规范制定前的需求澄清与头脑风暴。
运行交互式访谈以收集规格说明前的需求
需要向用户提出澄清问题后委派子代理
任何Ralph阶段命令需要自适应头脑风暴对话
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参数或执行模式
需要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 开发指南，涵盖 PreToolUse 等事件配置、Prompt/Command 类型实现及插件与用户设置格式差异，用于构建自动化工作流与安全策略。
创建 Hook
实现 Prompt-Based Hook
配置 PreToolUse 或 PostToolUse
设置事件驱动自动化
验证工具调用
npx skills add tzachbon/smart-ralph --skill Hook Development -g -y
