Agent Skills
› tzachbon/smart-ralph
tzachbon/smart-ralph
GitHub指导在 Claude Code 中创建、配置和管理斜杠命令，涵盖文件结构、YAML frontmatter 参数、动态参数处理及最佳实践。
Install All Skills
npx skills add tzachbon/smart-ralph --all -g -y
Skills in Collection (32)
指导在 Claude Code 中创建、配置和管理斜杠命令，涵盖文件结构、YAML frontmatter 参数、动态参数处理及最佳实践。
create a slash command
add a custom command
define command arguments
use command frontmatter
organize commands
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插件的本地配置模式，通过.claude目录下的.local.md文件存储YAML前缀的配置与状态，支持在Hooks、命令和Agent中读取以实现行为可配置化。
询问插件设置或配置
需要读写用户可配置的插件状态文件
解析.local.md中的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消耗并提升终端阅读效率。
生成任何Agent响应或计划时
需要格式化技术文档或指令时
npx skills add tzachbon/smart-ralph --skill communication-style -g -y
定义主Agent作为协调者而非执行者的核心原则，禁止直接实现代码或操作，必须通过Task工具将所有工作委派给具有特定专业能力的子Agent处理。
需要分解复杂任务并分配给不同角色
涉及多阶段软件开发流程的协调
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面试框架技能，用于在开发各阶段执行严格的用户决策访谈与授权检查。通过算法和领域模型验证状态一致性，确保仅在满足所有条件时进行委托，防止未经批准的自动化操作。
需要执行关键用户决策确认时
触发阶段转换或子任务分发前
npx skills add tzachbon/smart-ralph --skill interview-framework-codex -g -y
用于安全停止 Ralph Specum 执行或移除规范。处理原型状态、租赁释放及证据发布，确保本地操作安全并保留源路径。
用户明确要求使用 $ralph-specum-cancel
用户要求 Ralph Specum 在 Codex 中停止执行或移除规范
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 报告。自动总结问题、收集复现上下文，并根据 gh 可用性创建 GitHub Issue 或生成草稿。
用户明确请求使用 ralph-specum-feedback
要求起草或提交 Ralph Specum 的反馈
npx skills add tzachbon/smart-ralph --skill ralph-specum-feedback -g -y
用于解释 Ralph Specum 工作流及其辅助技能，指导用户进行需求分析、设计、原型验证和代码实现的规范操作。
用户询问 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
用于为现有代码库生成可搜索的索引规范文件，支持解析作用域、扫描代码结构并更新索引文档，确保输出确定性以复用。
用户明确要求使用 $ralph-specum-index
要求 Ralph Specum 在 Codex 中生成或刷新索引制品
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-specum-refactor
需要基于实施反馈更新规格工件
npx skills add tzachbon/smart-ralph --skill ralph-specum-refactor -g -y
协调 Ralph Specum 需求阶段，解析规范并运行阶段门控。根据研究状态执行技能发现，加载访谈框架，并在通过委派检查后，将需求生成工作委托给 product-manager 子代理处理。
用户显式请求使用 $ralph-specum-requirements
用户明确要求 Ralph Specum 在 Codex 中运行需求阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-requirements -g -y
协调 Ralph Specum 研究阶段，解析规范并委托子代理生成研究内容。支持交互与快速模式，执行阶段门控检查、技能发现及面试框架加载，确保严格的状态转换和权限验证。
用户明确要求使用 $ralph-specum-research
用户要求 Ralph Specum in 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 的状态或活跃规范进度
npx skills add tzachbon/smart-ralph --skill ralph-specum-status -g -y
用于在 Codex 中切换活跃规范（spec）。支持列出可用规范、解析路径、更新当前状态，并只读报告原型依赖与阻塞信息。
用户明确要求使用 ralph-specum-switch
需要切换或查看当前活跃规范
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
用于协调大型工作项（Epic）的多规格分解任务。通过解析模式标志，验证并管理Epic状态，集成技能发现与面试框架，最终将分解工作委派给子代理执行。
用户显式调用 $ralph-specum-triage
请求 Ralph Specum 对大型工作进行规格分解
npx skills add tzachbon/smart-ralph --skill ralph-specum-triage -g -y
Ralph Specum 是 Codex 的主要工作流入口，处理需求、原型、设计等阶段的启动与协调。通过路由至子代理或执行特定脚本，管理状态合并、任务计数及阶段门禁，确保开发流程规范执行。
用户显式调用 $ralph-specum
请求 Ralph Specum 处理命名阶段
要求 Ralph Specum 处理可选原型
npx skills add tzachbon/smart-ralph --skill ralph-specum -g -y
规范Agent输出风格，要求极致简洁、结构化扫描式排版及明确行动步骤，适用于所有Ralph规格阶段文档生成。
生成规格文档(如requirements.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
指导在修复类任务中先复现失败再验证解决结果，规范BEFORE/AFTER状态文档记录，并检测Mock测试反模式，确保问题真实解决且无回归。
用户要求验证修复方案或重现故障
需要检查修复前后的代码/测试结果状态
诊断Issue或进行现实核查
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 插件 Hook 开发指南，涵盖 Prompt-Based 和 Command 两种类型，支持 PreToolUse、Stop 等事件。用于实现工具调用验证、策略执行、上下文加载及自动化工作流集成。
创建或添加 Hook
实现基于提示的 Hook
验证工具使用安全性
配置事件驱动自动化
设置 Hook 触发器
npx skills add tzachbon/smart-ralph --skill Hook Development -g -y
