Agent Skills
› Gentleman-Programming/gentle-ai
Gentleman-Programming/gentle-ai
GitHub这是一个共享参考文档包，用于存储被其他SDD技能调用的通用参考资料。它本身不可直接调用，仅作为支持性资源存在。
Install All Skills
npx skills add Gentleman-Programming/gentle-ai --all -g -y
Skills in Collection (36)
规范创建Pull Request的流程，包括分支命名、PR模板填写及关联Issue检查。确保提交符合约定式提交标准，并通过自动化检查后合并。
创建或准备Pull Request
为贡献者开启PR
npx skills add Gentleman-Programming/gentle-ai --skill branch-pr -g -y
该技能用于管理大型PR，当变更超过400行时，自动将其拆分为链式或堆叠PR，确保每次审查在60分钟内完成。包含策略选择、分支创建及依赖管理规则。
PR变更行数超过400行
用户请求拆分PR或控制审查负载
SDD预测高预算风险
npx skills add Gentleman-Programming/gentle-ai --skill chained-pr -g -y
专注于降低认知负荷的文档设计技能，适用于PR描述、README、RFC等。提供结构化模板和渐进式披露等模式，帮助快速创建清晰、易扫描的技术文档。
编写或编辑技术指南
撰写README文件
创建RFC文档
编写入职指南
生成架构文档
准备审查用文档
npx skills add Gentleman-Programming/gentle-ai --skill cognitive-doc-design -g -y
用于撰写温暖、直接且高效的协作评论，适用于PR反馈、Issue回复及Slack沟通。遵循特定语音规则与公式，确保内容实用、简洁并解释原因，提升团队协作效率。
PR反馈
Issue回复
代码审查
Slack消息
npx skills add Gentleman-Programming/gentle-ai --skill comment-writer -g -y
用于 gentle-ai 基准测试旅程的编写、验证与调试。涵盖 CI 复现、唯一 ID 管理、Review 模式声明及语义变更检查，确保驱动执行的正确性。
添加或修改 journey
诊断 bench CI 失败
产品语义变更影响旅程
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-bench -g -y
指导编写和审查Go测试，涵盖表格驱动测试、Bubbletea/TUI流测试（teatest）、黄金文件管理及覆盖率提升。提供决策门径和执行步骤，确保测试行为导向且可维护。
编写Go单元测试或集成测试
审查Go测试代码
添加测试覆盖率
使用teatest测试TUI交互
更新或验证黄金文件
npx skills add Gentleman-Programming/gentle-ai --skill go-testing -g -y
作为父编排器，通过delegate_task将复杂任务（如多文件操作、测试构建、深度调试）委派给临时子代理，以保护主上下文并高效协调工作流。
需要探索多个文件或进行代码库映射
涉及多个非平凡文件的实现或修改
执行测试套件或构建流程
对代码差异进行独立审查
多步骤调试导致上下文过载
npx skills add Gentleman-Programming/gentle-ai --skill hermes-ephemeral-delegation -g -y
基于仓库策略发现与合规检查，自动化创建、分类和审批 GitHub Issue。支持模板匹配、去重搜索及提交前隐私审查，确保符合贡献规范。
创建或起草 GitHub Issue
Bug 报告提交
功能请求提出
Issue 审核与分类
npx skills add Gentleman-Programming/gentle-ai --skill issue-creation -g -y
Judgment Day 技能提供双盲对抗性代码审查机制，通过并行运行两个独立法官评估目标，仅在双方确认严重问题时触发修复，支持最多两轮修正与复审，确保审查的客观性与严谨性。
用户明确要求执行 Judgment Day 或对抗性审查
需要对特定目标进行高可靠性的双重验证
npx skills add Gentleman-Programming/gentle-ai --skill judgment-day -g -y
指导基于RDD的缺陷修复工作流，涵盖审批、影响分析、测试验证及交付门禁，确保变更可控与证据充分。
RDD模式启用
缺陷修复流程
收据驱动开发
npx skills add Gentleman-Programming/gentle-ai --skill rdd-defect-workflow -g -y
负责归档已完成的SDD变更，通过同步差异规范合并至主规范并移动文件夹以完成生命周期。
实现和验证完成后触发归档
需要归档SDD变更时
npx skills add Gentleman-Programming/gentle-ai --skill sdd-archive -g -y
负责软件设计文档(SDD)中的技术设计与架构规划。接收变更提案与规范，分析代码库后生成包含架构决策、数据流及技术依据的design.md文件，支持多种持久化模式。
需要制定技术方案或系统架构时
Orchestrator启动设计阶段任务时
npx skills add Gentleman-Programming/gentle-ai --skill sdd-design -g -y
用于在实施变更前探索 SDD 想法的子代理，负责调查代码库、分析问题并返回结构化分析结果。
orchestrator 启动探索任务
需求澄清阶段
npx skills add Gentleman-Programming/gentle-ai --skill sdd-explore -g -y
初始化 SDD 上下文，检测项目技术栈、测试工具及持久化模式，生成技能注册表与配置文件。
用户请求初始化 SDD
触发 sdd init 命令
npx skills add Gentleman-Programming/gentle-ai --skill sdd-init -g -y
引导用户在实际代码库中完成完整的SDD（结构化设计开发）流程，通过探索、实现和归档真实改进项，以教代练帮助用户掌握工作流。
编排器启动SDD周期入职培训
用户需要学习或体验SDD完整工作流
npx skills add Gentleman-Programming/gentle-ai --skill sdd-onboard -g -y
创建SDD变更提案，整合探索分析并生成结构化proposal.md。新增统一执行角色声明以消除指令冲突，并增加自动化测试确保所有技能文件符合无撤回的角色定义规范。
启动变更提案工作流
需要生成结构化变更提案
npx skills add Gentleman-Programming/gentle-ai --skill sdd-propose -g -y
SDD规范子代理，根据变更提案生成结构化的增量规格说明（需求与场景），支持多种持久化模式并严格区分编排者与执行者角色。
编排器启动规格编写任务
需要为系统变更生成结构化需求和场景
npx skills add Gentleman-Programming/gentle-ai --skill sdd-spec -g -y
用于将SDD变更分解为具体实施任务的子代理。接收提案、规范和设计文档，分析文件依赖和测试要求，生成按阶段组织的tasks.md实现步骤清单。
需要分解SDD变更任务时
编排器启动任务规划流程时
npx skills add Gentleman-Programming/gentle-ai --skill sdd-tasks -g -y
指导 Agent 创建或更新 LLM-first 技能文件。依据规范检查现有指南，确定触发场景，按标准结构编写 SKILL.md 并注册，确保格式合规且内容精简。
需要创建新的 AI 技能
编写 Agent 指令
文档化 AI 使用模式
npx skills add Gentleman-Programming/gentle-ai --skill skill-creator -g -y
用于审计、重构和规范现有SKILL.md文件的技能，确保符合LLM-first风格指南。默认仅审查，仅在明确要求时修改，保留作者意图并优化结构。
审计现有技能文件
重构技能格式
规范化技能描述
提升技能质量
npx skills add Gentleman-Programming/gentle-ai --skill skill-improver -g -y
维护技能注册表，扫描并索引 SKILL.md 文件，处理去重与路径解析，确保代理能准确获取技能元数据。
安装、移除或创建技能后
需要刷新技能索引时
npx skills add Gentleman-Programming/gentle-ai --skill skill-registry -g -y
系统化问题分类与治理技能，强调按根因聚类修复而非逐个修补，防止系统过度复杂化。适用于新Issue、Bug报告及积压清理，确保修复方案精简并附带测试证据。
接收新的Issue或Bug报告
进行Issue Triage分类
处理积压问题列表
社区反馈分析
npx skills add Gentleman-Programming/gentle-ai --skill systemic-issue-triage -g -y
指导开发者按可审查的工作单元规划提交和PR，避免按文件类型拆分，确保测试与代码同行，并在变更超400行时拆分为链式PR，以降低审查认知负荷。
实现功能时的提交拆分
准备PR前的工作单元规划
大型变更的链式PR处理
npx skills add Gentleman-Programming/gentle-ai --skill work-unit-commits -g -y
指导在 gentle-ai 项目中创建分支和 PR，确保关联已批准 Issue、遵循命名规范、控制代码行数并满足 CI 检查要求。
创建新功能或修复的分支
提交 Pull Request 供审查
准备代码变更
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-branch-pr -g -y
当PR超过400行或需拆分时，自动将变更拆分为链式或堆叠PR，确保每部分可独立审查，提供依赖图和验证计划以控制评审负载。
PR代码变更超过400行
用户请求链式或堆叠PR
SDD预测高风险或推荐链式PR
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-chained-pr -g -y
用于设计降低认知负荷的技术文档，涵盖PR描述、架构说明及新手指南。通过结构化模板和渐进式披露等模式，提升文档的可读性、扫描效率及审查体验。
编写或编辑README、RFC、架构文档
创建PR描述、审查笔记、入职指南
npx skills add Gentleman-Programming/gentle-ai --skill cognitive-doc-design -g -y
指导 Agent 撰写温暖、直接且高效的协作评论，适用于 PR 反馈、Issue 回复及 Slack 沟通。强调实用性、简洁性及技术理由说明，遵循特定语气和语言规则。
PR 代码审查反馈
Issue 回复
Slack 或 Discord 消息
npx skills add Gentleman-Programming/gentle-ai --skill comment-writer -g -y
用于 gentle-ai 基准测试框架的旅程（Journey）开发与验证。涵盖编写/修改旅程定义、确保 Review 模式声明、处理语义变更导致的回归检查，以及通过构建二进制并运行驱动式执行来提供完整的测试证据。
添加或修改 bench 目录下的旅程
诊断 CI 中基准测试失败
产品语义变更需校验旅程引脚
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-bench -g -y
指导 Gentleman-Programming/gentle-ai 外部贡献者遵循 Issue-first 工作流，涵盖 Issue 创建、PR 起草、链式 PR 策略及合规性检查。
在 Gentleman-Programming/gentle-ai 仓库中作为外部协作者提交代码
起草或审核 Pull Request 正文
决定使用链式 PR 还是堆叠 PR 策略
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-collab-perfect -g -y
用于在 Gentle AI 仓库创建 GitHub Issue。需先查重并选择 Bug 或功能模板，严禁提交空白问题。Issue 自动标记待审，必须获得维护者批准后方可开发。
报告 gga 项目缺陷
请求新功能或增强
向 Gentleman-Programming/gentle-ai 仓库提交 GitHub Issue
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-issue-creation -g -y
针对缺陷集群进行根因审计与解决，通过机制映射验证问题根源，优先采用删除式修复方案，并基于确凿证据关闭过时或已修复的问题。
审计缺陷积压中的共享根因
提出针对问题集群的修复方案
判定并关闭已解决或过期的问题
npx skills add Gentleman-Programming/gentle-ai --skill issue-root-resolution -g -y
定义 Go 语言 RDD 审查传输协议，规范运行时与适配器交互。限制适配器职责，确保提示词、证据和结果模式统一由 Go 合约管理，保障审查流程的完整性与安全性。
修改运行时调用 RDD 审查器的逻辑
触碰审查提示词或结果模式
实现 OpenCode 或 Codex 审查插件
npx skills add Gentleman-Programming/gentle-ai --skill rdd-advisory-transport -g -y
指导基于收据驱动开发(RDD)的缺陷修复工作流，涵盖审批、因果隔离、测试验证及变更控制。
RDD模式启用
缺陷修复流程
收据驱动开发
npx skills add Gentleman-Programming/gentle-ai --skill rdd-defect-workflow -g -y
系统化问题分诊技能，通过根因分类批量处理Bug，防止过度工程。强制从根源修复而非逐个修补，确保修复方案精简系统结构，提升可维护性。
新Issue提交
Bug报告
积压任务清理
社区反馈
npx skills add Gentleman-Programming/gentle-ai --skill systemic-issue-triage -g -y
指导如何按可审查的工作单元规划代码提交，避免按文件类型拆分，确保测试和文档与代码同行，并支持构建链式PR以控制变更规模。
实现功能时的提交拆分
准备PR前的代码整理
大型变更拆分为链式PR
npx skills add Gentleman-Programming/gentle-ai --skill work-unit-commits -g -y
