Agent Skills
› tzachbon/smart-ralph
tzachbon/smart-ralph
GitHub指导在 Claude Code 中创建、配置和组织 Slash 命令，涵盖 YAML 前缀、动态参数及执行规范。
Install All Skills
npx skills add tzachbon/smart-ralph --all -g -y
Skills in Collection (32)
指导在 Claude Code 中创建、配置和组织 Slash 命令，涵盖 YAML 前缀、动态参数及执行规范。
创建斜杠命令
添加自定义命令
定义命令参数
使用命令 frontmatter
组织命令结构
npx skills add tzachbon/smart-ralph --skill Command Development -g -y
指导在Claude Code插件中集成Model Context Protocol服务器，支持stdio、SSE、HTTP和WebSocket等多种连接方式，实现外部服务与API的结构化工具接入。
添加MCP服务器
集成MCP协议
配置MCP连接外部服务
设置Model Context Protocol
npx skills add tzachbon/smart-ralph --skill MCP Integration -g -y
介绍Claude Code插件使用.local.md文件存储用户配置和状态的规范，涵盖YAML前置元数据结构和从Hooks、命令及Agent读取配置的代码示例。
询问插件设置
配置用户可定制的插件
读写.local.md文件
管理插件状态
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
定义主代理作为协调者的核心原则，严禁自行实现代码或执行任务。要求通过Task工具将所有工作委派给具备特定专长的子代理（如架构师、分析师等），确保职责分离与上下文清晰。
用户请求开发、设计或执行具体技术任务时
主代理准备直接编写代码、修改文件或运行命令时
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
定义Codex面试框架，规范各阶段委托前的检查、状态匹配及审批流程。确保在状态转换或子任务分发前通过check-delegation验证，管理快速模式与正常模式的边界条件，保障决策一致性与安全性。
执行阶段转换或子任务分发时
需要验证委托资格和状态一致性时
npx skills add tzachbon/smart-ralph --skill interview-framework-codex -g -y
用于安全终止 Ralph Specum 执行流程并可选移除规范。通过校验原型状态、中断构建器、保留证据并发布审核通过的取消记录，确保本地操作安全且数据可追溯。
用户明确要求停止 Ralph Specum 执行
用户要求移除当前 spec
npx skills add tzachbon/smart-ralph --skill ralph-specum-cancel -g -y
协调 Ralph Specum 设计阶段，作为协调者而非架构师，将工作委托给子代理。负责解析规范、验证需求、执行阶段门控检查及原型记录选择，确保在生成前完成必要的审批和依赖检查。
用户显式请求使用 $ralph-specum-design
明确要求 Ralph Specum 运行设计阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-design -g -y
用于捕获 Ralph Specum 的产品反馈或 bug 报告。通过总结问题、收集复现上下文，并生成 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-implement
明确要求 Ralph Specum 运行实施、快速模式或继续请求
npx skills add tzachbon/smart-ralph --skill ralph-specum-implement -g -y
用于为现有代码库生成可搜索的索引规格文件。通过解析用户范围，扫描控制器、服务等代码区域，并更新或创建 specs/.index/ 下的索引文档，确保输出确定性以支持后续研究。
用户明确要求使用 $ralph-specum-index
要求 Ralph Specum 生成或刷新索引制品
npx skills add tzachbon/smart-ralph --skill ralph-specum-index -g -y
协调可选的原型覆盖流程，委托子代理执行源工作。通过脚本解析路径、管理状态变更及记录，支持直接、建议、恢复、快速运行或取消原型，确保主阶段不变并在用户授权前保持远程指针待处理。
显式调用 $ralph-specum-prototype
要求运行、恢复、快速运行或取消 Ralph Specum 原型
npx skills add tzachbon/smart-ralph --skill ralph-specum-prototype -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 在 Codex 中运行需求阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-requirements -g -y
协调 Ralph Specum 研究阶段，解析规范并执行门禁检查。加载访谈框架以收集证据和决策阈值，随后将研究工作委派给 research-analyst 子代理生成研究文档。
用户显式请求使用 $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中切换活跃的Ralph Specum规范。通过解析配置文件发现规范根目录，支持按路径或名称切换，更新当前规范状态并汇总进度、审批及原型依赖信息，不修改底层数据。
用户明确要求使用$ralph-specum-switch命令
用户要求Ralph Specum在Codex中切换活跃规范
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
用户要求对大型工作进行规格拆分
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 代理的输出，提升阅读效率与 Token 经济性。
生成 spec 文档（research.md, requirements.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状态确保问题真正解决，并检测测试中的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
Smart Ralph技能定义Ralph插件的核心行为，包括通用参数、执行模式（交互/快速）、状态管理及协调器委托规则，指导用户进行规范生成与操作。
查询ralph参数或执行模式
需要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 插件 Hook 开发指南，涵盖 Prompt-Based 和 Command 类型 Hook 的配置与实现。用于事件驱动自动化、工具调用验证及安全策略执行。
创建 Hook
添加 PreToolUse/PostToolUse 钩子
实现基于提示词的 Hook
设置事件驱动自动化
npx skills add tzachbon/smart-ralph --skill Hook Development -g -y
