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 等协议，实现外部服务工具调用。
添加 MCP 服务器
集成 MCP
配置插件中的 MCP
使用 .mcp.json
设置 Model Context Protocol
连接外部服务
npx skills add tzachbon/smart-ralph --skill MCP Integration -g -y
定义Claude Code插件配置模式，通过.local.md文件存储YAML前端与Markdown内容，支持在Hooks、命令和Agent中读取项目级插件设置与状态。
询问插件设置或配置
管理用户可配置的插件行为
处理.per-project plugin settings
读取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，确保职责分离与流程规范。
需要分解复杂开发任务时
主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
用于在 Codex 中停止 Ralph Specum 执行或移除指定 spec。支持安全取消（仅清除状态）和完全删除，需确认操作并报告结果。
用户明确要求使用 $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 草稿及 URL。
用户明确要求使用 $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 实现流程，作为协调者而非执行者。通过解析规格、计算任务状态并委派给子代理执行具体开发任务，管理进度更新、验证及断点续跑，确保任务有序完成。
用户显式请求使用 $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 在 Codex 中修订规格工件
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 的状态或进展
npx skills add tzachbon/smart-ralph --skill ralph-specum-status -g -y
用于显式调用时切换当前活跃规范（spec）的技能。支持解析多根目录、处理歧义名称、列出可用规范并更新当前状态，确保精确切换目标规范。
用户明确要求使用 $ralph-specum-switch
用户明确要求在 Codex 中切换 Ralph Specum
npx skills add tzachbon/smart-ralph --skill ralph-specum-switch -g -y
协调 Ralph Specum 任务规划阶段，通过子代理生成 tasks.md，更新进度状态并管理审批流程。
用户显式调用 $ralph-specum-tasks
用户要求运行 Ralph Specum 的任务阶段
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 智能体输出风格，强调极简、扫描友好和结构化。适用于生成规格文档及所有阶段的结果格式化，通过省略语法、使用表格和项目符号提升效率与清晰度。
生成 spec artifacts (如 research.md, design.md)
格式化 Agent 输出内容
需要简洁、可扫描的终端显示格式
npx skills add tzachbon/smart-ralph --skill communication-style -g -y
用于需求规格阶段的交互式访谈技能，通过三阶段算法（理解、提议、确认）自适应引导用户澄清需求。优先探索代码库事实，仅针对用户决策提问，并支持提前结束信号检测。
运行交互式访谈以收集需求
在规范阶段前询问澄清问题
需要自适应头脑风暴对话的需求分析场景
npx skills add tzachbon/smart-ralph --skill interview-framework -g -y
指导在修复任务中通过复现故障前后状态对比来验证修复效果，检查测试质量并识别 Mock 反模式。
verify a fix
reproduce failure
diagnose issue
check BEFORE/AFTER state
VF task
reality check
check test quality
mock-only tests
npx skills add tzachbon/smart-ralph --skill reality-verification -g -y
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 开发指南，涵盖 Prompt-Based 和 Command 两种类型，详解 PreToolUse 等事件配置及 hooks.json/settings.json 格式差异。
创建 Hook
实现 PreToolUse/PostToolUse 钩子
验证工具调用
设置事件驱动自动化
npx skills add tzachbon/smart-ralph --skill Hook Development -g -y
