Agent Skills
› tzachbon/smart-ralph
tzachbon/smart-ralph
GitHub指导在 Claude Code 中创建和管理斜杠命令，涵盖文件结构、YAML 配置、动态参数及最佳实践，旨在提升 Agent 交互效率与工作流标准化。
Install All Skills
npx skills add tzachbon/smart-ralph --all -g -y
Skills in Collection (32)
指导在 Claude Code 中创建和管理斜杠命令，涵盖文件结构、YAML 配置、动态参数及最佳实践，旨在提升 Agent 交互效率与工作流标准化。
创建斜杠命令
定义命令参数
使用 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 协议及 OAuth 认证。
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前端和Markdown内容，支持按项目自定义设置、状态管理及在Hook、命令和Agent中读取应用。
询问插件设置
配置用户可定制插件
读取.local.md文件
管理插件状态文件
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 插件技能开发指南，涵盖 SKILL.md 结构、元数据规范及脚本/参考资源组织最佳实践，助力构建模块化扩展能力。
创建新技能
改进技能描述
规划技能目录结构
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处理，确保职责分离与流程规范。
用户发起开发或配置任务请求
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, triage, research, requirements, design, tasks 阶段时
执行 check-delegation 进行阶段转换或子任务分发前
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 或生成草稿，输出包含预期与实际行为及复现步骤的具体报告。
用户明确要求使用 $ralph-specum-feedback
请求 Ralph Specum 起草或提交反馈
npx skills add tzachbon/smart-ralph --skill ralph-specum-feedback -g -y
用于解释 Ralph Specum 在 Codex 中的使用方法和命令指南。当用户明确要求帮助或查询 Ralph Specum 相关指令时触发，涵盖主技能、辅助技能及原型覆盖模式的说明。
用户明确请求使用 $ralph-specum-help
用户询问 Ralph Specum 的帮助或命令指南
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 生成或刷新索引制品
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 规格文档。通过调用子代理更新需求、设计和任务文件，确保规格与实现一致并处理下游级联变更。
用户明确要求使用 $ralph-specum-refactor
要求 Ralph Specum 在 Codex 中修订规格工件
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 运行研究阶段
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
用户明确要求 Ralph Specum 切换活动规范
npx skills add tzachbon/smart-ralph --skill ralph-specum-switch -g -y
作为协调者，通过子代理执行任务规划。负责解析规范、验证前置文档、运行阶段门控脚本、选择原型记录及加载技能框架，确保任务生成前的状态一致性与审批合规。
用户显式请求使用 $ralph-specum-tasks
用户要求 Ralph Specum 在 Codex 中运行 tasks 阶段
npx skills add tzachbon/smart-ralph --skill ralph-specum-tasks -g -y
协调大型需求分解为多个规格说明，通过子代理执行，管理Epic状态、模式路由及技能发现。
用户显式请求使用 $ralph-specum-triage
用户要求对大型任务进行规格分解
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
定义 Ralph Agent 输出规范，要求极致简洁、结构化及扫描友好。适用于生成规格文档（研究/需求/设计/任务）及格式化 Agent 结果，通过省略语法、使用片段和表格提升效率并降低 Token 成本。
生成 spec artifacts (research.md, requirements.md, design.md, tasks.md)
格式化 Agent 输出内容
结构化阶段结果
npx skills add tzachbon/smart-ralph --skill communication-style -g -y
规范AI在开发阶段进行关键决策访谈的流程，通过构建设计树和分层审批机制，确保用户确认核心架构与范围决策。
需要识别关键用户决策时
运行分层审批访谈时
恢复中断的访谈流程时
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
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
实现 PreToolUse/PostToolUse 钩子
设置事件驱动自动化
验证工具使用
npx skills add tzachbon/smart-ralph --skill Hook Development -g -y
