Agent Skills
› shinpr/claude-code-workflows
shinpr/claude-code-workflows
GitHub提供技术决策准则、反模式检测及故障回退设计原则。用于审查代码质量与设计缺陷，识别违反DRY/SRP等规范的写法，指导错误传播与降级策略，确保系统正确性与可维护性。
安装全部 Skills
npx skills add shinpr/claude-code-workflows --all -g -y
集合内 Skills (115)
按质量分展示前 50 个（共 115 个），完整列表请用安装命令预览或逐个打开详情。
提供技术决策准则、反模式检测及故障回退设计原则。用于审查代码质量与设计缺陷，识别违反DRY/SRP等规范的写法，指导错误传播与降级策略，确保系统正确性与可维护性。
代码审查
架构设计评审
调试复杂故障
评估技术债务
后端实现完整性检查
npx skills add shinpr/claude-code-workflows --skill ai-development-guide -g -y
提供语言无关的编码原则，涵盖可维护性、可读性及代码质量。指导功能设计（参数管理、单一职责）、错误处理及持续重构，旨在通过简洁结构和清晰命名提升代码长期健康度与开发效率。
实现新功能时参考编码规范
重构代码以提升可维护性
审查代码质量与设计合理性
npx skills add shinpr/claude-code-workflows --skill coding-principles -g -y
提供PRD、ADR等文档模板及创建决策矩阵。根据变更类型（如后端/前端新增、文件数量）指导文档生成顺序，并定义ADR触发条件（合同、数据流、架构变更），确保技术文档规范与可追溯性。
创建或审查技术文档
确定项目所需文档类型
npx skills add shinpr/claude-code-workflows --skill documentation-criteria -g -y
捕获并持久化仓库外资源（如设计源、API、密钥等）的访问方法，确保下游工作能确定性获取。涵盖双 tier 存储位置、单点真理规则及更新协议，适用于依赖外部资源的场景。
工作依赖于外部资源
用户提及设计源、设计系统、API 模式、IaC 源或密钥存储
npx skills add shinpr/claude-code-workflows --skill external-resource-context -g -y
提供React/TypeScript前端开发的技术决策标准、反模式检测及质量门禁。用于审查组件、Hooks、浏览器行为及实现完整性，倡导价值优先与快速失败原则，识别代码与设计层面的不良实践。
审查React组件或Hooks实现
检测前端代码中的反模式
评估浏览器行为兼容性
检查前端技术决策合理性
npx skills add shinpr/claude-code-workflows --skill frontend-ai-guide -g -y
用于规划实施策略、选择开发方法或定义验证标准的元认知框架。通过现状分析、设计收敛（MVP/失败检查/扩展/减法）及策略探索，系统性地确定最优实现路径。
规划实施策略
选择开发方法
定义验证标准
npx skills add shinpr/claude-code-workflows --skill implementation-approach -g -y
提供集成与E2E测试设计原则、ROI计算及审查标准。定义三类测试预算，推荐fixture-e2e为主流方案，强调行为优先与高ROI候选项筛选，指导测试设计与质量评审。
设计集成测试
规划E2E测试策略
评估测试用例ROI
审查测试代码质量
npx skills add shinpr/claude-code-workflows --skill integration-e2e-testing -g -y
优化LLM友好型上下文，确保下游智能体明确执行目标、成功标准及未决事项。通过正向指令、具体化模糊术语、定义输出结构、提供必要背景及分解步骤，消除歧义，提升自动化执行的稳定性和可预测性。
编写或修订面向LLM的提示词
生成任务交接文档
创建规划工件或报告
npx skills add shinpr/claude-code-workflows --skill llm-friendly-context -g -y
用于实现React/TypeScript的前端单元测试、集成测试及浏览器E2E测试。遵循AAA结构、独立性及命名规范，支持配置化运行器与Mock层，适用于生成或补全前端测试骨架场景。
创建新的前端测试文件
补全测试骨架代码
编写React组件单元测试
实现浏览器级E2E测试
npx skills add shinpr/claude-code-workflows --skill test-implement -g -y
提供语言无关的测试原则，涵盖TDD流程、质量要求（如覆盖率诊断而非目标）、设计规则（AAA模式、隔离性）及Mock与数据层测试规范。适用于编写测试、制定策略或审查质量。
编写单元测试或集成测试
设计测试策略
审查现有测试代码质量
实施TDD开发流程
npx skills add shinpr/claude-code-workflows --skill testing-principles -g -y
提供React与TypeScript前端开发规范，涵盖类型安全（优先unknown）、组件设计、注释准则及RSC边界处理。指导代码实现、类型推断及外部数据校验，确保类型严谨性与架构一致性。
实现React组件或Hooks
编写TypeScript类型定义
处理前端状态管理
进行前端错误处理与数据校验
npx skills add shinpr/claude-code-workflows --skill typescript-rules -g -y
提供后端与技术决策指南，涵盖价值优先工程、代码与设计反模式检测（如违反DRY/SRP原则）及快速失败容错设计。用于审查实现选择、识别代码异味、排查故障及评估完整性。
审查后端技术决策
检测代码异味与反模式
分析系统故障与调试
评估实现完整性
npx skills add shinpr/claude-code-workflows --skill ai-development-guide -g -y
提供语言无关的代码规范，强调可维护性、简洁性及设计收敛。涵盖代码质量、函数设计（参数管理、单一职责）及错误处理原则，指导编码、重构与审查，确保代码清晰、低耦合且易于长期维护。
实现新功能
重构现有代码
进行代码质量审查
npx skills add shinpr/claude-code-workflows --skill coding-principles -g -y
提供PRD、ADR、设计文档等模板及创建决策矩阵，根据代码变更规模（文件数）和架构复杂度自动判定所需文档，规范技术文档创建流程。
创建或审查技术文档
确定项目所需的文档类型
评估是否需要进行架构决策记录
npx skills add shinpr/claude-code-workflows --skill documentation-criteria -g -y
捕获并持久化仓库外资源（如设计稿、API、密钥等）的访问方法，确保下游工作能确定性获取。通过两级存储和项目/特性分层管理，定义聆听协议以更新资源上下文，避免重复询问用户。
工作依赖外部资源
提及设计源、设计系统、API Schema、IaC 源码或密钥库
npx skills add shinpr/claude-code-workflows --skill external-resource-context -g -y
提供React/TypeScript前端开发的技术决策标准、反模式检测及质量门禁。用于审查组件、Hooks、浏览器行为及实现完整性，强调价值优先与低生命周期成本，识别代码与设计层面的不良实践。
审查React或TypeScript组件实现
检查Hooks编写规范
评估前端代码质量与反模式
审核浏览器兼容性或行为逻辑
npx skills add shinpr/claude-code-workflows --skill frontend-ai-guide -g -y
用于规划实施策略、选择开发方法及定义验证标准的元认知框架。通过现状分析、设计收敛（MVP及增删检查）和策略探索，系统性地确定最优实现路径。
规划实施策略
选择开发方法
定义验证标准
npx skills add shinpr/claude-code-workflows --skill implementation-approach -g -y
提供集成与E2E测试的设计原则、ROI计算及审查标准。定义三种测试类型及其预算，指导用户选择fixture-e2e或service-integration-e2e，强调基于行为和高ROI的测试设计，适用于测试设计与质量审查。
设计集成测试
设计E2E测试
审查测试质量
计算测试ROI
npx skills add shinpr/claude-code-workflows --skill integration-e2e-testing -g -y
规范LLM间交互上下文，确保下游代理明确执行目标、成功标准及输出格式。通过消除模糊指令、细化约束和分解步骤，减少猜测，提升自动化执行的稳定性与准确性。
编写或修订面向LLM的提示词
创建任务交接文档
生成规划工件或报告
npx skills add shinpr/claude-code-workflows --skill llm-friendly-context -g -y
该技能用于故障诊断，通过编排调查、验证和求解子代理识别根因。支持变更失败与新发现分类，利用规则顾问分析核心问题，迭代生成解决方案并输出报告。
用户请求排查系统或代码故障
需要分析错误日志并定位根本原因
变更部署后出现异常需回溯
npx skills add shinpr/claude-code-workflows --skill recipe-diagnose -g -y
用于在已有UI基础上进行会话内调整与验证。通过委托子代理分析代码和设计源，由主会话执行资源确认、规模判断、编辑及迭代验证，确保最终提交符合质量标准。
需要对已实现的UI功能进行修改或调整
需要基于设计源对现有前端界面进行验证和修复
npx skills add shinpr/claude-code-workflows --skill recipe-front-adjust -g -y
作为编排器，在自主模式下执行前端构建任务文件。通过解析工作计划和消耗的任务集，遵循执行、分支、质量修复和提交的四步循环，并在每次提交前运行前端质量修复工具，确保任务完成或升级。
用户指令执行现有的前端任务文件
需要批量审批并自动化执行前端实现任务
npx skills add shinpr/claude-code-workflows --skill recipe-front-build -g -y
该技能用于前端设计阶段，作为编排者协调多个子代理完成从代码库分析到设计文档生成的全流程。涵盖范围引导、UI分析、技术设计及文档审查，并在关键节点暂停以获取用户确认，确保设计质量与一致性。
需要生成前端设计文档
进行中大型前端项目的架构与设计规划
npx skills add shinpr/claude-code-workflows --skill recipe-front-design -g -y
作为前端规划编排者，依据设计文档协调子代理生成测试骨架与工作计划。流程包括选择设计文档、确认并执行测试生成、创建详细工作规划，最终提交计划供用户审批，确保前端开发任务有序落地。
需要制定前端工作计划
根据设计文档进行前端任务拆解
请求获取前端开发方案批准
npx skills add shinpr/claude-code-workflows --skill recipe-front-plan -g -y
面向React/TS前端的实现后质检编排器，验证代码与设计文档合规性及安全性。支持自动修复代码或更新设计文档，依据安全结果阻断或输出独立报告。
需要验证前端代码是否符合设计文档规范时
进行前端代码安全审查及合规性评估时
npx skills add shinpr/claude-code-workflows --skill recipe-front-review -g -y
该技能通过调用rule-advisor进行元认知分析，辅助Agent选择规则、识别潜在失败模式并规划任务。它指导Agent在执行前理解任务本质，利用TaskCreate创建结构化的任务列表，并依据推荐的第一步和警告模式执行实施，确保高质量交付。
需要执行复杂任务时
希望遵循特定开发规范或最佳实践时
需要结构化分解任务步骤时
npx skills add shinpr/claude-code-workflows --skill recipe-task -g -y
用于更新现有设计文档（Design Doc/PRD/ADR）的编排技能。通过识别目标、澄清变更、调用子代理更新、执行审查及一致性检查，并在关键节点暂停以获取用户批准，确保文档更新的准确性与质量。
需要修改现有的设计文档
需要对PRD或ADR进行迭代更新
请求对已有技术设计文档进行审查和修订
npx skills add shinpr/claude-code-workflows --skill recipe-update-doc -g -y
指导子代理协调与工作流编排。核心规则包括：通过需求分析器评估规模，监控范围变更并重新评估；遵循“指定目标而非执行细节”的委派原则，明确职责边界；按优先级处理冲突，确保专家自主执行并在受阻时升级问题。
需要协调多个子代理完成复杂任务
管理多阶段工作流或决定自主执行模式
监控需求变更对现有工作流的影响
npx skills add shinpr/claude-code-workflows --skill subagents-orchestration-guide -g -y
执行元认知任务分析与技能选择。通过识别任务本质、估算规模及类型，结合标签匹配与隐式依赖，从技能索引中筛选并确定优先级合适的技能组合，以指导后续工作。
需要判断任务复杂度时
选择合适技能时
估算工作量规模时
npx skills add shinpr/claude-code-workflows --skill task-analyzer -g -y
指导实现React/TypeScript的前端测试，涵盖单元、集成及E2E测试。遵循AAA结构、独立性及用户视角命名原则，依据类型引用对应文档，利用仓库配置的运行器和Mock环境完成测试骨架生成与实现。
创建前端单元测试或集成测试
实现浏览器级E2E测试
补全生成的测试骨架代码
npx skills add shinpr/claude-code-workflows --skill test-implement -g -y
提供语言无关的测试原则，涵盖TDD流程、质量要求（如覆盖率诊断）、设计规则（AAA模式）、Mock规范及数据层测试策略。用于编写测试、制定策略或审查质量，强调关键路径覆盖和隔离性。
编写单元测试或集成测试时
设计测试策略或架构
审查现有测试代码的质量与规范性
配置CI/CD中的测试性能阈值
npx skills add shinpr/claude-code-workflows --skill testing-principles -g -y
提供React与TypeScript前端开发规范，涵盖类型安全（优先unknown）、组件设计、代码注释及RSC边界处理。用于指导实现React组件、编写TS代码及构建前端功能，确保类型严谨性与架构一致性。
实现React组件
编写TypeScript代码
前端功能开发
npx skills add shinpr/claude-code-workflows --skill typescript-rules -g -y
提供语言无关的后端技术决策标准、反模式检测及调试指南。用于审查代码异味、失败处理及实现完整性，强调价值优先、快速失败原则及错误上下文保留，旨在降低生命周期成本并提升系统可维护性。
审查后端实现选择
检测代码异味或反模式
分析系统故障原因
评估实现完整性
npx skills add shinpr/claude-code-workflows --skill ai-development-guide -g -y
提供语言无关的代码规范，涵盖可维护性、简洁性及设计收敛等核心理念。详细规定了代码质量、函数参数管理、单一职责、错误处理及命名规范，旨在指导功能实现、重构及代码审查，提升代码清晰度与长期健康度。
实现新功能时参考编码原则
进行代码重构以降低维护成本
执行代码质量审查
npx skills add shinpr/claude-code-workflows --skill coding-principles -g -y
提供PRD、ADR等文档模板及创建决策矩阵。根据变更类型（如新特性、架构调整）和文件规模，自动判定所需文档及顺序，规范技术文档创作流程。
创建或审查技术文档
确定项目所需的文档类型
评估是否需要编写ADR
npx skills add shinpr/claude-code-workflows --skill documentation-criteria -g -y
捕获并持久化仓库外资源（如设计稿、API、IaC）的访问方式，确保下游工作可确定性获取。通过两级存储和听音协议管理元数据，避免重复询问用户。
工作依赖外部资源
提及设计源、设计系统、API模式、IaC或密钥库
npx skills add shinpr/claude-code-workflows --skill external-resource-context -g -y
提供React/TypeScript前端开发的技术决策准则、反模式检测及质量门禁。用于审查组件、Hooks、浏览器行为及实现完整性，强调价值优先、代码规范与失败快速原则，帮助识别并规避技术债务与设计缺陷。
审查React或TypeScript组件设计
检查Hooks实现与状态管理
评估前端代码质量与反模式
调试前端逻辑错误
确认前端实现是否完整
npx skills add shinpr/claude-code-workflows --skill frontend-ai-guide -g -y
用于规划实施策略、选择开发方法或定义验证标准的元认知框架。通过现状分析、设计收敛（MVP与迭代）及策略探索，系统化地确定最优实现路径。
规划实施策略
选择开发方法
定义验证标准
npx skills add shinpr/claude-code-workflows --skill implementation-approach -g -y
提供集成与E2E测试设计原则、ROI计算及审查标准。定义三类测试预算，指导基于行为优先的候选项选择，明确fixture-e2e为默认路径，仅在涉及真实跨服务一致性时启用service-integration-e2e，确保测试高效且可维护。
设计集成或端到端测试方案
评估测试用例的投资回报率(ROI)
审查现有测试代码的质量与覆盖度
npx skills add shinpr/claude-code-workflows --skill integration-e2e-testing -g -y
优化LLM友好型上下文，明确输入输出、成功标准及未决事项，确保下游Agent无需猜测即可执行。适用于编写或修订提示词、交接文档及规划工件，通过具体化指令和分解步骤提升执行稳定性。
编写面向LLM的提示词
创建Agent间交接文档
生成规划工件或报告
修订生成的指令
npx skills add shinpr/claude-code-workflows --skill llm-friendly-context -g -y
该技能用于为现有代码库添加集成/E2E测试。通过解析设计文档，生成测试骨架并创建任务文件，协调子代理完成实现、审查和质量修复，确保测试覆盖后端、前端或全栈功能。
需要为现有后端、前端或全栈项目添加集成测试
需要为现有功能补充端到端(E2E)测试用例
已有设计文档需转化为自动化测试脚本
npx skills add shinpr/claude-code-workflows --skill recipe-add-integration-tests -g -y
作为编排者，在自主模式下执行材料化的任务文件。通过解析工作计划并筛选特定任务集，遵循执行、分支、质量修复和提交的循环协议，委托子代理完成工作并确保交付物质量。
用户提供包含现有任务文件的执行指令
需要批量审批并自动执行预定义的开发任务
npx skills add shinpr/claude-code-workflows --skill recipe-build -g -y
作为编排器，协调子智能体完成代码库分析、范围确认及技术设计文档（ADR/Design Doc）的生成与审核。通过严格的质量门控和用户审批节点，确保设计输出的一致性与准确性。
需要生成技术设计文档
需要进行架构决策记录
启动代码库分析与设计阶段
npx skills add shinpr/claude-code-workflows --skill recipe-design -g -y
作为编排者诊断问题，通过结构化流程协调调查、验证和求解子代理。先确定问题类型并补充信息，调用规则顾问分析本质，再按序执行调查与验证，最终输出根因及解决方案。
需要排查系统故障或错误原因
用户报告异常并要求定位根本原因
变更导致的问题诊断请求
npx skills add shinpr/claude-code-workflows --skill recipe-diagnose -g -y
用于在已有UI基础上进行会话内调整，通过获取外部资源、分析代码、确认修改集、执行调整并与设计源比对验证的闭环流程，确保前端界面精准修正。
需要对已实现的前端UI进行微调或修正
用户提供了新的设计稿或视觉规范需同步到现有代码
npx skills add shinpr/claude-code-workflows --skill recipe-front-adjust -g -y
作为编排者，自动解析并执行前端任务文件。通过精确匹配和排除规则定位工作规划及待处理任务集，遵循执行、分支、质量修复、提交的循环，并在每次提交前运行前端质量修复器，直至所有任务完成或升级。
用户指令包含现有任务文件并要求自主执行
需要批量审批并执行前端实现任务
npx skills add shinpr/claude-code-workflows --skill recipe-front-build -g -y
该技能用于中大型前端项目的架构设计编排。作为协调者，它按顺序调度多个子代理（如代码分析、UI规范、技术设计等），在关键节点暂停以获取用户确认，确保生成高质量的设计文档或ADR。
需要为中大型前端项目创建设计文档
执行从代码库分析到前端设计文档生成的完整流程
npx skills add shinpr/claude-code-workflows --skill recipe-front-design -g -y
前端规划编排技能，负责从设计文档创建前端工作计划并获取审批。流程包括选择设计文档、生成测试骨架（可选）、调用工作规划器制定计划、审查及最终确认批准。
用户请求基于设计文档创建前端工作计划
需要协调子代理进行前端任务规划和测试生成
npx skills add shinpr/claude-code-workflows --skill recipe-front-plan -g -y
作为编排器对React/TypeScript前端实现进行设计合规性与安全验证。通过code-reviewer和security-reviewer评估结果，根据违规类型自动路由至代码修复或设计文档更新路径，确保实现与设计一致且符合安全标准。
需要检查前端代码是否符合设计文档规范时
需要进行前端实施后的质量与安全审查时
npx skills add shinpr/claude-code-workflows --skill recipe-front-review -g -y
作为编排器执行全栈任务文件，通过Agent工具委派工作。根据文件名模式路由至后端或前端子代理，严格遵循执行、分支、质量修复和提交的循环，确保在提交前运行相应层级的质量修复程序。
需要执行已物化的全栈任务文件
用户提供了包含现有任务文件的执行指令
npx skills add shinpr/claude-code-workflows --skill recipe-fullstack-build -g -y
