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 (MCP) 服务器的指南，涵盖 .mcp.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/plugin-name.local.md 文件存储 YAML frontmatter 配置。提供 Bash 脚本解析及在 Hooks、Commands、Agents 中读取配置的示例，实现项目级插件行为定制。
询问插件设置或配置方法
需要读写 .local.md 状态文件
希望插件支持用户自定义参数
npx skills add tzachbon/smart-ralph --skill Plugin Settings -g -y
提供 Claude Code 插件的目录结构、组件组织及清单配置指南。涵盖自动发现机制、plugin.json 元数据定义及路径引用规范，辅助用户创建或理解插件架构。
创建插件
脚手架化插件
了解插件结构
设置 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生成计划或方案
需要统一所有Agent的输出格式与风格
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
定义 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, research, design等）
需要确认阶段完成并执行权限委派时
npx skills add tzachbon/smart-ralph --skill interview-framework-codex -g -y
用于安全停止 Ralph Specum 执行并可选移除 spec。支持清理原型、释放租约、保留证据及审批流程，确保操作可追溯且不影响远程分支。
用户明确要求取消或停止 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 报告。总结问题、收集复现上下文，并在 gh 可用时创建 GitHub Issue，否则生成可直接粘贴的 Issue 正文及 URL。
用户明确要求使用 $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 指导时触发，涵盖主技能、辅助技能及原型覆盖模式说明。
用户显式请求使用 $ralph-specum-help
用户询问 Ralph Specum 的命令或使用指南
npx skills add tzachbon/smart-ralph --skill ralph-specum-help -g -y
Ralph Specum实施协调技能，负责解析规范、管理任务状态及原型记录，并委派子代理执行具体开发任务。
用户明确要求使用$ralph-specum-implement
请求Ralph Specum以快速模式或显式继续运行实施
npx skills add tzachbon/smart-ralph --skill ralph-specum-implement -g -y
用于为现有代码库生成可搜索的索引规范文件。通过解析用户指定的范围，扫描控制器、服务等代码结构，并更新specs/.index目录下的索引文档，确保输出确定性以便复用。
用户显式要求使用$ralph-specum-index
用户要求Ralph Specum在Codex中生成或刷新索引工件
npx skills add tzachbon/smart-ralph --skill ralph-specum-index -g -y
协调Ralph Specum原型覆盖，委托子代理执行源工作。通过脚本解析路径、管理状态与记录、控制构建流程，确保在用户授权前保持主阶段不变并处理隔离与交接。
用户显式调用$ralph-specum-prototype
要求运行、恢复、快速运行或取消可选原型
npx skills add tzachbon/smart-ralph --skill ralph-specum-prototype -g -y
协调 Ralph Specum 重构流程，根据实施反馈委派子代理更新需求、设计及任务文档。新增原型阶段处理逻辑，包括状态协调与下游选择，确保规范一致性。
用户显式请求使用 $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 在 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状态，解析配置根目录下的规格文件、原型记录及任务进度，汇总活跃规格、Epic状态、审批情况及阻塞项。
用户明确要求使用 $ralph-specum-status
用户询问 Ralph Specum 的状态或活跃规格进展
npx skills add tzachbon/smart-ralph --skill ralph-specum-status -g -y
用于切换 Ralph Specum 中活跃规格的技能。通过解析配置确定默认根目录，支持按路径或名称切换，列出可用规格并处理歧义。更新当前状态文件，展示阶段进度及原型依赖关系。
用户明确要求使用 $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
协调大型需求分解为多个规格说明书。通过子代理执行探索、分解、验证和最终化，严格遵循合同规范与状态管理，确保输出结构完整。
用户显式请求使用 $ralph-specum-triage
要求将大型工作项拆解为多个规格说明书
npx skills add tzachbon/smart-ralph --skill ralph-specum-triage -g -y
Ralph Specum 是 Codex 的核心工作流技能，管理软件开发生命周期。支持启动、恢复、快速模式及原型阶段，通过路由子代理处理需求、设计和任务规划，集成状态管理与脚本工具以协调多阶段协作。
用户显式调用 $ralph-specum
请求在 Codex 中使用 Ralph Specum
要求处理特定阶段或可选原型
npx skills add tzachbon/smart-ralph --skill ralph-specum -g -y
规范 Agent 输出风格，要求极致简洁、碎片化表达，优先使用表格和要点。规定输出结构为概述、内容、疑问、行动步骤，旨在提升扫描效率并降低 Token 成本。
生成规格文档（如 research.md, design.md）
格式化 Agent 输出内容
需要指导输出格式时
npx skills add tzachbon/smart-ralph --skill communication-style -g -y
规范 Ralph 阶段中的关键用户决策访谈流程，通过分层 grill 机制识别决策点、持久化答案并获取审批。确保在委派工作前完成事实发现与共识建立，支持中断恢复，保障项目上下文一致性。
需要识别关键用户决策时
运行分层 grill 以获取明确批准时
恢复中断的访谈流程时
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
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 开发指南，涵盖 PreToolUse 等事件触发、Prompt/Command 类型实现及配置格式，用于实现自动化验证与策略执行。
创建 Hook
添加 PreToolUse/PostToolUse/Stop Hook
验证工具调用
实现基于提示的 Hook
使用 ${CLAUDE_PLUGIN_ROOT}
设置事件驱动自动化
阻止危险命令
npx skills add tzachbon/smart-ralph --skill Hook Development -g -y
