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 (30)
指导如何为 Claude Code 创建和管理斜杠命令，涵盖命令结构、YAML 配置、动态参数及最佳实践。
创建斜杠命令
添加自定义命令
定义命令参数
使用 YAML frontmatter
组织命令
npx skills add tzachbon/smart-ralph --skill Command Development -g -y
指导在 Claude Code 插件中集成 Model Context Protocol (MCP) 服务器，支持配置 .mcp.json、连接外部服务及处理认证。
添加 MCP 服务器
集成 MCP
配置 MCP 插件
使用 .mcp.json
设置 Model Context Protocol
连接外部服务
npx skills add tzachbon/smart-ralph --skill MCP Integration -g -y
定义Claude Code插件配置存储模式，通过.local.md文件结合YAML Frontmatter管理项目级插件状态与设置，并提供从Hooks、Commands及Agents中读取配置的代码示例。
询问插件设置
配置用户可定制的插件
处理.local.md文件
读取YAML frontmatter
实现每项目插件配置
npx skills add tzachbon/smart-ralph --skill Plugin Settings -g -y
提供 Claude Code 插件的标准化目录结构、manifest配置及组件组织规范，指导用户创建、脚手架生成或理解插件架构。
create a plugin
scaffold a plugin
understand plugin structure
organize plugin components
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通用沟通规范，要求输出极致精简、结构化且可操作。遵循Matt Pocock原则，强调碎片化表达、扫描式结构及末尾行动步骤，旨在降低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
定义 Smart Ralph 插件的核心参数、执行模式（交互/快速）及共享行为，规范状态文件结构与提交逻辑。
需要配置或理解 Ralph 插件通用参数时
查询执行模式或状态管理规则时
npx skills add tzachbon/smart-ralph --skill smart-ralph -g -y
基于宪法驱动的特性开发工作流，涵盖规范、计划、任务和实施阶段。提供目录结构、ID系统及各阶段输入输出定义，确保功能开发与项目原则一致。
需要遵循特定方法论进行特性开发
创建或更新项目宪法文档
生成特性规格说明书或技术计划
npx skills add tzachbon/smart-ralph --skill speckit-workflow -g -y
用于在 Codex 中显式调用以停止 Ralph Specum 的执行流程，或选择性地删除指定 spec。支持安全取消（仅清状态）和完全移除（确认后备删目录），确保操作精确且可追溯。
用户明确要求停止执行
用户要求删除特定 spec
npx skills add tzachbon/smart-ralph --skill ralph-specum-cancel -g -y
协调软件设计阶段，通过委托子代理生成设计文档并管理状态流转，确保架构、接口及测试策略的完整性，支持快速模式与审批流程。
用户显式请求使用 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
用于解释 Codex 中 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
用于为现有代码库生成可搜索的索引规范文件，支持解析范围、扫描代码结构并更新索引文档。
用户明确要求使用 $ralph-specum-index
要求 Ralph Specum 生成或刷新索引制品
npx skills add tzachbon/smart-ralph --skill ralph-specum-index -g -y
协调 Ralph Specum 重构流程，将规范修订委托给子代理处理。根据实施反馈更新需求、设计和任务文档，确保下游变更同步，并记录决策依据。
用户显式请求使用 $ralph-specum-refactor
需要基于实施学习结果修订规范工件
npx skills add tzachbon/smart-ralph --skill ralph-specum-refactor -g -y
协调需求阶段，委托子代理生成需求文档。解析规范状态，合并元数据，更新进度并引导用户审批或进入设计阶段。
用户显式调用 $ralph-specum-requirements
要求 Ralph Specum 运行需求阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-requirements -g -y
协调代码库研究阶段，解析规范并委托子智能体生成研究报告。通过访谈收集上下文，验证输出并更新进度状态，最终引导用户审批或进入下一阶段。
用户明确要求使用 $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 状态的工具。当用户显式请求或询问 Spec 进度时触发，通过读取配置文件和目录结构，汇总各 Spec 的当前阶段、任务完成情况及 Epic 状态。
用户明确请求使用 $ralph-specum-status
用户询问 Ralph Specum 在 Codex 中的状态或活跃 Spec 进度
npx skills add tzachbon/smart-ralph --skill ralph-specum-status -g -y
用于在 Codex 中切换活动规范（Spec）的 Skill。通过解析配置和文件路径，支持列出、选择并更新当前活跃的规范上下文，确保操作明确无歧义。
用户明确要求使用 $ralph-specum-switch
用户明确要求切换到 Ralph Specum
npx skills add tzachbon/smart-ralph --skill ralph-specum-switch -g -y
作为协调器，负责解析项目规范并委派任务规划子智能体生成tasks.md。通过合并状态、更新进度及控制审批流程，确保开发任务的有序分解与验证，不直接执行具体编码工作。
用户显式调用 $ralph-specum-tasks
请求 Ralph Specum 运行 tasks 阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-tasks -g -y
用于将大型开发任务（Epic）分解为多个具体规范（Spec）的协调技能。通过委托子代理进行探索、拆解和验证，生成包含愿景、依赖关系和执行计划的 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 处理特定阶段
请求自主模式或快速模式
npx skills add tzachbon/smart-ralph --skill ralph-specum -g -y
规范 Agent 输出风格，要求极致简洁、结构化及扫描友好。用于生成规格文档、格式化结果或提供输出指导，旨在提升效率并降低 Token 成本。
生成 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
用于验证修复有效性的技能，通过复现故障前后状态对比来确认问题解决，并检测测试中的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插件核心技能，定义通用参数、执行模式（普通/快速）、状态管理、提交行为及协调器委派规则，用于指导Agent规范操作。
询问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 和 Command 类型 Hook 的配置、事件处理及最佳实践。
创建 Hook
实现 PreToolUse/PostToolUse 钩子
验证工具使用
设置事件驱动自动化
npx skills add tzachbon/smart-ralph --skill Hook Development -g -y
