Agent Skills
› tzachbon/smart-ralph
tzachbon/smart-ralph
GitHub指导如何在 Claude Code 中创建、配置和管理斜杠命令，涵盖文件结构、YAML 前置元数据、动态参数及执行模式。
安装全部 Skills
npx skills add tzachbon/smart-ralph --all -g -y
集合内 Skills (30)
指导如何在 Claude Code 中创建、配置和管理斜杠命令，涵盖文件结构、YAML 前置元数据、动态参数及执行模式。
创建斜杠命令
编写自定义命令
定义命令参数
使用 YAML frontmatter
组织命令结构
npx skills add tzachbon/smart-ralph --skill Command Development -g -y
提供 Claude Code 插件集成 Model Context Protocol (MCP) 服务器的指南，涵盖 .mcp.json 配置、stdio/SSE/HTTP/WebSocket 等协议类型及 OAuth 认证流程。
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 插件中通过 .claude/plugin-name.local.md 文件存储用户可配置设置和状态的模式，支持 YAML frontmatter 及从 Hooks、Commands、Agents 读取配置。
询问插件设置或配置
需要存储插件状态或用户配置
处理 .local.md 文件
读取 YAML frontmatter
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消耗并提高终端阅读体验。
需要生成代码计划或技术方案时
Agent输出内容需遵循特定沟通风格约束时
npx skills add tzachbon/smart-ralph --skill communication-style -g -y
定义主Agent作为协调者而非执行者的核心原则，禁止直接实现代码或任务，必须通过Task工具将所有工作委派给具备专业能力的子Agent，确保职责分离与流程规范。
需要协调多阶段开发流程
决定由主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
用于停止 Ralph Specum 执行或移除规范。支持按路径或名称定位目标，读取状态文件总结进度。默认安全取消仅删除状态文件保留规范；全量删除需确认并清理目录及当前指针，同时保护 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 在 Codex 中的帮助或命令指导
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
用于在实现后根据学习成果协调修订 Ralph 规格文档。作为协调者，将具体修订任务委派给子智能体，确保需求、设计和任务文件的级联更新与一致性。
用户显式请求使用 ralph-specum-refactor
需要基于实现反馈修订规格工件
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 的研究阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-research -g -y
用于启动或恢复 Ralph Specum 规范流程。解析参数，初始化或合并状态文件，处理分支隔离，并在设置完成后暂停等待用户指令以继续研究。
用户显式调用 $ralph-specum-start
要求 Ralph Specum 开始或恢复 spec
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。支持通过路径或名称解析目标，列出可用 Spec，处理歧义并更新当前状态文件，最后总结 Spec 的进度和审批状态。
用户明确要求使用 $ralph-specum-switch
用户要求 Ralph Specum 切换活跃 Spec
npx skills add tzachbon/smart-ralph --skill ralph-specum-switch -g -y
协调任务规划阶段，解析规范并委托子代理生成任务列表。维护状态与进度，支持快速模式及审批流程，确保任务原子化与验证策略。
用户显式请求使用 $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
规范 Agent 输出风格，要求极致简洁、碎片化表达及扫描式结构。适用于生成规格文档或格式化结果，旨在提升终端阅读效率并降低 Token 成本。
生成规格文档（如 requirements.md, design.md）
格式化 Agent 输出内容
需要指导输出格式时
npx skills add tzachbon/smart-ralph --skill communication-style -g -y
提供自适应头脑风暴对话算法，用于在规格制定前通过交互式问答收集需求。涵盖理解、提议和确认三阶段流程，支持代码库优先探索与完成信号检测。
运行交互式面试以收集需求
在委托子代理前询问澄清问题
需要自适应头脑风暴的Ralph阶段命令
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
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 和 Command 类型，支持 PreToolUse 等事件驱动自动化、工具调用验证及策略执行。
创建 Hook
实现 PreToolUse/PostToolUse 钩子
设置事件驱动自动化
使用 ${CLAUDE_PLUGIN_ROOT}
验证工具调用
npx skills add tzachbon/smart-ralph --skill Hook Development -g -y
