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 (32)
指导如何在 Claude Code 中创建、配置和管理斜杠命令，涵盖文件结构、YAML 前置元数据、动态参数及执行模式，旨在提升工作流复用性与一致性。
创建斜杠命令
编写自定义命令
定义命令参数
使用 YAML 前置元数据
组织命令结构
npx skills add tzachbon/smart-ralph --skill Command Development -g -y
指导在Claude Code插件中集成Model Context Protocol服务器，支持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前缀的用户可配置设置和状态，支持从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
定义AI代理的输出规范，要求极致简洁、结构化且可操作。通过碎片化表达、表格优先及固定结构（概述-内容-问题-步骤），提升终端阅读效率并降低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 面试框架，规范各阶段通过算法与领域模型进行决策检查、用户交互及委托前校验。确保状态一致性，控制关键节点的风险与审批流程。
执行 start, triage, research 等阶段的委托前检查
需要确认关键架构或范围变更的用户决策
npx skills add tzachbon/smart-ralph --skill interview-framework-codex -g -y
用于安全停止 Ralph Specum 执行并可选移除规范。通过解析状态、处理活跃原型、中断构建器并发布不可变取消证据，确保本地目标确认与数据保留，防止误删远程分支。
用户显式要求使用 $ralph-specum-cancel
要求 Ralph Specum 在 Codex 中停止执行或移除 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 报告。通过整理问题摘要、复现步骤和环境信息，生成详细的 Issue 草稿或直接创建 GitHub Issue，确保报告包含预期与实际行为对比及日志等关键上下文。
用户明确要求使用 $ralph-specum-feedback
用户要求 Ralph Specum 起草或提交反馈
npx skills add tzachbon/smart-ralph --skill ralph-specum-feedback -g -y
用于解释 Ralph Specum 在 Codex 中的功能与命令，指导用户进行软件规格定义、原型设计及实施流程。
用户询问 Ralph Specum 帮助
用户请求使用 $ralph-specum-help
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
要求使用 Ralph Specum 修订实现后的规格文档
npx skills add tzachbon/smart-ralph --skill ralph-specum-refactor -g -y
协调Ralph Specum需求阶段，解析规范并调用phase_gate.py，结合研究结果进行技能发现与面试框架加载，最终委派产品管理子代理生成需求文档。
用户明确要求使用$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
用于切换当前激活的规范（spec）。通过解析配置和状态文件，定位目标规范并更新当前状态，同时只读报告原型依赖、阻塞项及过期工件信息。
用户明确要求使用 $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 运行任务阶段
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是Codex的主要交互界面，管理软件开发生命周期的全流程。支持启动、恢复、快速模式及原型协调，通过路由至Triage、Research、Requirements、Design等子代理，实现从需求到设计的自动化编排与状态管理。
用户显式调用$ralph-specum
请求Ralph Specum处理特定阶段或可选原型
npx skills add tzachbon/smart-ralph --skill ralph-specum -g -y
定义Ralph Agent生成规格文档时的极简输出风格，通过碎片化表达、表格优先和结构化扫描提升效率。
生成spec artifacts如research.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
用于验证修复效果，通过复现故障前后状态对比来确认问题是否解决。包含目标检测、命令映射及测试质量检查，防止假阳性测试。
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
指导基于规范的开发工作流，将功能需求转化为结构化规范并分阶段执行。涵盖研究、需求、设计、任务分解及实施，支持新功能启动、大型特性拆解（Epic）及多阶段状态管理。
构建新功能或创建规范
启动规范驱动开发流程
运行研究或生成需求阶段
规划任务或实施规范
检查规范状态或分类功能
创建史诗或分解大型特性
npx skills add tzachbon/smart-ralph --skill spec-workflow -g -y
提供Claude Code插件Hook开发指南，涵盖Prompt与Command两种类型及配置格式。用于实现事件驱动自动化、工具调用验证及安全策略执行。
创建或添加Hook
实现PreToolUse/PostToolUse等钩子
设置事件驱动自动化
验证工具使用安全性
npx skills add tzachbon/smart-ralph --skill Hook Development -g -y
