Agent Skills
› tzachbon/smart-ralph
tzachbon/smart-ralph
GitHub指导在 Claude Code 中创建、配置和管理斜杠命令的 Skill，涵盖文件结构、YAML frontmatter、动态参数及最佳实践。
Install All Skills
npx skills add tzachbon/smart-ralph --all -g -y
Skills in Collection (32)
指导在 Claude Code 中创建、配置和管理斜杠命令的 Skill，涵盖文件结构、YAML frontmatter、动态参数及最佳实践。
创建斜杠命令
添加自定义命令
定义命令参数
使用 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 协议类型及外部服务连接方法。
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 中的读取方法。
询问插件设置或配置
需要管理插件状态文件
实现用户可配置的插件行为
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 插件技能开发的指导，涵盖技能结构、元数据编写规范及资源组织最佳实践，帮助用户创建或优化模块化技能。
create a skill
add a skill to plugin
write a new skill
improve skill description
organize skill content
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
定义 Smart Ralph 插件核心行为，规范通用参数、执行模式及状态管理。支持交互与快速两种模式，处理文件提交逻辑及任务循环协议，为各插件提供统一的基础能力支撑。
需要统一配置 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 多阶段工作流的面试框架与委托门禁机制，规范状态校验、快速模式及硬边界规则。
需要执行或检查项目阶段间的委托流程时
配置 Codex 自动化工作流的审批与验证逻辑时
npx skills add tzachbon/smart-ralph --skill interview-framework-codex -g -y
用于安全停止 Ralph Specum 执行并可选移除规范。通过解析目标、检查状态、处理原型租赁与构建器中断，发布不可变取消证据，确保本地操作安全且保留源路径。
用户明确要求使用 $ralph-specum-cancel
要求 Ralph Specum 停止执行或移除 spec
npx skills add tzachbon/smart-ralph --skill ralph-specum-cancel -g -y
协调 Ralph Specum 设计阶段，通过子代理处理架构工作。负责解析规范、验证需求、运行阶段门禁及原型选择，确保设计流程合规并委托具体实现。
用户明确要求使用 $ralph-specum-design
要求 Ralph Specum 在 Codex 中运行设计阶段
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
用于解释 Ralph Specum 在 Codex 中的功能与使用指南。当用户显式请求帮助或查询命令时触发，提供流程说明及原型覆盖模式的指导。
用户显式询问如何使用 $ralph-specum-help
用户请求 Ralph Specum 的帮助或命令指导
npx skills add tzachbon/smart-ralph --skill ralph-specum-help -g -y
协调员技能，用于执行已批准的 Ralph Specum 实现任务。通过解析 tasks.md 和状态文件，将具体任务委派给 spec-executor 子代理，管理原型记录、依赖检查及任务调度流程。
用户显式请求使用 $ralph-specum-implement
请求在 Codex 中运行 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 可选原型覆盖，委托子代理处理源码工作。通过解析路径、匹配模式（直接/建议/恢复/快速/取消）并调用锁定状态与记录脚本，确保原型状态变更的原子性与一致性，直至完成门控验证。
用户显式调用 $ralph-specum-prototype
要求运行、恢复、快速运行或取消 Ralph Specum 原型
npx skills add tzachbon/smart-ralph --skill ralph-specum-prototype -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 在 Codex 中运行需求阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-requirements -g -y
协调 Ralph Specum 研究阶段，解析规范并委托子代理执行研究。通过阶段门控和面试框架验证状态，确保正确加载技能与上下文，最终生成 research.md 报告。
用户明确要求使用 $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 开始或继续 spec
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
用于切换当前活跃规范的工具，解析配置、列出选项、更新状态并报告原型依赖与阻塞项。
用户明确要求使用 $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 的核心工作流插件，负责管理需求分析、原型设计和任务规划的全生命周期。通过路由至子代理处理各阶段，并协调状态与分支，支持从启动到完成的端到端开发流程。
用户显式调用 $ralph-specum
请求在 Codex 中使用 Ralph Specum
要求 Ralph Specum 处理特定阶段或可选原型
npx skills add tzachbon/smart-ralph --skill ralph-specum -g -y
定义 Ralph 智能体生成规范文档及格式化输出的沟通风格，强调极致简洁、扫描友好结构及底部优先的行动步骤，适用于所有规范阶段。
生成 spec artifacts
格式化 agent 输出
npx skills add tzachbon/smart-ralph --skill communication-style -g -y
用于在 Ralph 阶段识别关键用户决策，执行分层审批式访谈（Grill），持久化部分答案并获取显式批准。支持中断后恢复，确保在委托工件工作前完成必要确认，作为正常模式访谈行为的唯一真理来源。
需要识别关键用户决策时
运行分层审批式访谈时
中断的访谈需要恢复时
委托工件工作前需获取显式批准时
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 Specum操作及插件配置。
查询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 插件钩子开发指南，涵盖 Prompt 和 Command 类型钩子的实现、配置格式及事件触发机制，用于实现自动化验证、策略执行和上下文集成。
创建或添加 Hook
实现 PreToolUse/PostToolUse 等事件驱动逻辑
配置 Claude Code 插件钩子
npx skills add tzachbon/smart-ralph --skill Hook Development -g -y
