Agent Skills
› tzachbon/smart-ralph
tzachbon/smart-ralph
GitHub指导如何在 Claude Code 中开发斜杠命令。涵盖命令结构、YAML 配置、动态参数、文件引用及最佳实践，强调命令应作为给 Agent 的指令而非用户消息，并说明项目、个人和插件命令的存放位置与区别。
安装全部 Skills
npx skills add tzachbon/smart-ralph --all -g -y
集合内 Skills (30)
指导如何在 Claude Code 中开发斜杠命令。涵盖命令结构、YAML 配置、动态参数、文件引用及最佳实践，强调命令应作为给 Agent 的指令而非用户消息，并说明项目、个人和插件命令的存放位置与区别。
创建斜杠命令
添加自定义命令
定义命令参数
使用命令 frontmatter
组织命令结构
在命令中使用 AskUserQuestion
获取命令开发最佳实践
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 四种协议类型及 OAuth 认证等外部服务接入场景。
add MCP server
integrate MCP
configure MCP in plugin
use .mcp.json
set up Model Context Protocol
connect external service
mentions ${CLAUDE_PLUGIN_ROOT} with MCP
discusses MCP server types
npx skills add tzachbon/smart-ralph --skill MCP Integration -g -y
指导如何在项目中通过 .claude/plugin-name.local.md 文件存储插件配置与状态。支持 YAML frontmatter，涵盖从 Hooks、命令和 Agent 中读取设置的 Bash 解析模式及示例。
询问插件设置
配置用户可定制插件
管理 per-project 插件配置
读写 .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
定义AI代理的极简沟通规范，强调以扫描为导向的输出。要求牺牲语法换取简洁，使用片段、表格和列表。结构包含概述、主体、待决问题及最后的具体行动步骤，旨在提升终端阅读效率并降低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插件时
查看或调试Ralph插件的通用参数和状态时
希望以快速模式自动执行生成任务时
npx skills add tzachbon/smart-ralph --skill smart-ralph -g -y
基于宪法的特性开发工作流，涵盖指定、规划、澄清和实施阶段。通过明确治理和一致性分析确保质量，支持自动递增ID管理，提供结构化目录与模板以规范研发流程。
需要遵循宪法原则进行新功能设计时
执行特性规格说明或技术规划时
解决需求歧义并更新规格文档时
初始化或更新项目核心原则时
npx skills add tzachbon/smart-ralph --skill speckit-workflow -g -y
用于停止 Ralph Specum 执行并可选删除指定 spec。支持通过路径、名称或当前状态定位目标，默认安全取消仅清除状态文件，全量删除需确认。保留 Epic 文件除非用户明确要求移除。
用户明确请求使用 $ralph-specum-cancel
用户要求 Ralph Specum 在 Codex 中停止执行
用户要求移除某个 spec
npx skills add tzachbon/smart-ralph --skill ralph-specum-cancel -g -y
协调 Ralph Specum 设计阶段，委托架构师子代理生成 design.md。需读取需求与研究文档，更新状态与进度，并在非快速模式下等待用户审批或继续任务。
用户明确要求使用 $ralph-specum-design
用户要求 Ralph Specum in Codex 运行设计阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-design -g -y
用于捕获 Ralph Specum 的产品反馈或 bug 报告。需用户显式触发，负责总结问题、收集复现上下文，并生成 GitHub Issue 草稿或直接提交。
用户明确要求使用 $ralph-specum-feedback
用户要求 Ralph Specum in Codex 起草或提交反馈
npx skills add tzachbon/smart-ralph --skill ralph-specum-feedback -g -y
用于解释 Codex 中 Ralph Specum 的工作流与技能体系。在用户显式请求帮助或提及 `$ralph-specum-help` 时触发，指导用户选择入口、理解审批流程及阶段控制。
用户明确询问 Ralph Specum 的帮助或命令指南
用户显式调用 `$ralph-specum-help`
npx skills add tzachbon/smart-ralph --skill ralph-specum-help -g -y
协调器技能，仅在显式请求时触发。负责解析规范、重新计算任务计数并合并状态，随后将任务委托给 spec-executor 子代理执行，处理批处理、验证及状态持久化，直至完成或中断。
用户明确要求使用 $ralph-specum-implement
要求 Ralph Specum 在 Codex 中运行已批准任务的实现、快速模式或继续请求
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 规格文档。通过委派给子代理更新需求、设计和任务文件，确保下游变更级联，并引导用户确认或继续实施。
用户明确要求使用 $ralph-specum-refactor
用户要求使用 Ralph Specum in Codex 修订实施后的规格工件
npx skills add tzachbon/smart-ralph --skill ralph-specum-refactor -g -y
作为协调者，通过委托子智能体生成需求文档。负责解析规范、合并状态、更新进度，并根据快速模式决定是否进入设计阶段。
用户显式请求使用 $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在Codex中开始或恢复规范
npx skills add tzachbon/smart-ralph --skill ralph-specum-start -g -y
当用户显式请求使用 $ralph-specum-status 或查询 Ralph Specum 状态时使用。用于报告配置规范根目录下的 Ralph 状态，包括活跃规范、史诗进度、任务完成情况及审批状态。
用户明确询问 Ralph Specum 的状态
用户明确要求查看活跃的规范进度
npx skills add tzachbon/smart-ralph --skill ralph-specum-status -g -y
用于在 Codex 中切换活跃 spec。通过读取配置文件解析 spec 根目录，根据路径或名称定位目标，处理歧义并更新当前状态，最后总结 spec 的阶段、进度及文件信息。
用户明确要求使用 $ralph-specum-switch
用户明确要求 Ralph Specum 切换活跃 spec
npx skills add tzachbon/smart-ralph --skill ralph-specum-switch -g -y
协调任务规划阶段，委托子代理生成tasks.md。支持快速模式、粒度控制及审批流程，更新进度状态并引导用户确认或进入实施。
用户明确请求使用 $ralph-specum-tasks
用户明确要求 Ralph Specum 在 Codex 中运行任务阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-tasks -g -y
协调大型需求分解为多个规格说明。通过子代理执行探索、拆解和验证，生成包含愿景、依赖关系和接口合同的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 在 Codex 中处理任务
指定由 Ralph Specum 处理特定阶段
要求启用自主模式、快速模式或无暂停继续执行
npx skills add tzachbon/smart-ralph --skill ralph-specum -g -y
规范Ralph Agent输出风格，要求极致简洁、碎片化表达。规定输出结构：概述、主体、未决问题、行动步骤（置于末尾以便自下而上阅读）。旨在降低Token成本，提升终端扫描效率，适用于所有规格说明阶段。
生成spec artifacts (research.md, requirements.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
用于修复类任务的验证技能，通过复现故障前后状态对比确认修复效果。支持CI、测试、构建等场景的命令映射，规范BEFORE/AFTER文档记录，并检测Mock过度等测试质量反模式。
verify a fix
reproduce failure
diagnose issue
check BEFORE/AFTER state
VF task
reality check
check test quality
mock-only tests
npx skills add tzachbon/smart-ralph --skill reality-verification -g -y
Ralph插件核心技能，定义通用参数、执行模式（普通/快速）、状态管理及协调器委派规则。适用于查询Ralph参数、状态文件、执行循环行为及插件操作指导。
查询ralph参数或快捷模式
需要了解提交规范或最大迭代次数
询问ralph状态文件或执行模式
需要指导ralph循环行为或协调器委派
npx skills add tzachbon/smart-ralph --skill smart-ralph -g -y
用于规范驱动开发工作流，支持新功能创建、需求分析、设计、任务分解及自主执行。提供快速原型和引导式开发模式，并具备大型特性拆解为史诗（Epic）及多Spec编排的能力。
用户请求构建功能或创建规范
需要启动规范驱动的开发流程
运行研究阶段或生成需求文档
进行系统设计或任务规划
实施规范检查状态或处理特性分类
创建史诗或分解大型功能
寻求规范开发工作流指导
npx skills add tzachbon/smart-ralph --skill spec-workflow -g -y
提供 Claude Code 插件 Hook 开发指南，涵盖 PreToolUse 等事件。支持 Prompt-Based 和 Command 两种类型，详解 hooks.json 与 settings.json 配置格式，用于实现工具调用验证、策略执行及自动化工作流。
创建或添加 Hook
实现 PreToolUse/PostToolUse/Stop 钩子
验证工具使用安全性
配置事件驱动自动化
使用 ${CLAUDE_PLUGIN_ROOT}
npx skills add tzachbon/smart-ralph --skill Hook Development -g -y
