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 (37)
规范 Pull Request 创建流程，强制关联已批准 Issue、添加类型标签并通过自动化检查。提供分支命名正则、PR 模板结构及 Shellcheck 脚本校验规则，确保代码合并质量。
创建或准备提交 Pull Request
协助贡献者打开 PR
验证 PR 是否关联批准的 Issue
npx skills add Gentleman-Programming/gentle-ai --skill branch-pr -g -y
当PR超过400行或需拆分时，将变更拆分为链式/堆叠PR，确保每份PR在60分钟内可审查，管理依赖与追踪。
PR变更行数超过400行
需要拆分大型变更以保护审查焦点
请求链式PR、堆叠PR或审查切片
npx skills add Gentleman-Programming/gentle-ai --skill chained-pr -g -y
专注于降低认知负荷的技术文档设计技能，适用于PR描述、README、RFC及架构文档。提供结构化模板与渐进式披露等原则，帮助快速理解、审查和协作。
编写或编辑技术文档
创建PR描述或Review说明
撰写Onboarding指南
重构冗长难懂的文档
npx skills add Gentleman-Programming/gentle-ai --skill cognitive-doc-design -g -y
提供高效、温暖且直接的协作评论写作规范，适用于PR反馈、Issue回复及Slack沟通。遵循实用优先、简明扼要原则，指导AI生成高质量的技术评审与团队交流内容。
编写PR代码审查意见
回复Issue讨论
撰写Slack或Discord消息
npx skills add Gentleman-Programming/gentle-ai --skill comment-writer -g -y
用于在 gentle-ai 项目中编写、验证和运行基准测试旅程（journeys）。涵盖 corpus 声明校验、CI 复现、ID 管理及执行证明，确保产品语义变更后的行为正确性。
添加或修改 journey
诊断 bench CI 失败
变更影响 journey pin 的产品语义
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-bench -g -y
用于编写和审查 Go 测试的规范，涵盖表驱动测试、Bubbletea TUI 流测试（teatest）、黄金文件管理及集成测试跳过策略，确保测试行为与状态转换的正确性。
编写或审查 Go 单元测试
增加 Go 测试覆盖率
测试 Bubbletea/TUI 交互流程
使用 teatest 进行终端测试
更新或生成黄金文件
npx skills add Gentleman-Programming/gentle-ai --skill go-testing -g -y
作为父级编排器，通过delegate_task将复杂任务（如多文件读写、测试构建、深度调试或审查）委派给临时工作节点，以保护上下文并验证结果。
需要理解4个以上文件的广泛探索
涉及2个以上非平凡文件的多文件实现
执行测试或构建
对新代码进行对抗性审查
可能导致上下文过载的多步调试
npx skills add Gentleman-Programming/gentle-ai --skill hermes-ephemeral-delegation -g -y
用于在GitHub仓库中创建、起草、审查、分派或批准Issue。严格遵循仓库策略与YAML表单，执行去重搜索，验证标签权限及审批授权，确保操作安全合规。
创建GitHub Issue
Bug报告提交
功能请求处理
Issue审批流程
npx skills add Gentleman-Programming/gentle-ai --skill issue-creation -g -y
执行盲式双评委对抗审查，并行评估目标并合并结果。仅修复双方确认的严重问题，最多两轮修正与复审，最终给出批准或升级结论，不直接触发发布。
用户明确要求进行 Judgment Day 或双评委/对抗性审查
需要对特定代码目标执行严格的独立双重验证
npx skills add Gentleman-Programming/gentle-ai --skill judgment-day -g -y
指导基于RDD（收据驱动开发）的缺陷修复工作流，涵盖审批、因果不变量隔离、影响映射及变更预算控制。
RDD
receipt-driven development
review authority
defect workflow
npx skills add Gentleman-Programming/gentle-ai --skill rdd-defect-workflow -g -y
负责完成 SDD 变更归档的子代理，将增量规范合并至主规范并移动变更文件夹，生成最终状态报告以闭环开发周期。
编排器在实施和验证完成后触发归档流程
需要合并规范并归档变更文件夹时
npx skills add Gentleman-Programming/gentle-ai --skill sdd-archive -g -y
负责生成SDD技术设计文档，根据变更提案和规范制定架构决策、数据流及实施细节。
编排器启动变更设计阶段
npx skills add Gentleman-Programming/gentle-ai --skill sdd-design -g -y
作为探索子代理，负责在确定变更前深入调查代码库、分析问题并比较方案，最终返回结构化分析报告或生成exploration.md文档。
执行器启动功能探索任务
需要澄清需求或技术实现路径
npx skills add Gentleman-Programming/gentle-ai --skill sdd-explore -g -y
初始化SDD上下文，检测项目技术栈、测试能力及持久化模式，生成技能注册表。支持Engram、OpenSpec及混合模式，处理严格TDD配置逻辑。
用户请求初始化SDD环境
执行 sdd init 命令
npx skills add Gentleman-Programming/gentle-ai --skill sdd-init -g -y
引导用户基于真实代码库完成 SDD（Spec-Driven Development）全流程，通过探索、实施到归档的交互式教学，帮助用户掌握规范驱动开发的最佳实践。
启动 SDD 完整生命周期流程
需要学习或演示 SDD 工作流
npx skills add Gentleman-Programming/gentle-ai --skill sdd-onboard -g -y
负责生成SDD变更提案，整合探索分析结果与用户输入，产出结构化proposal.md文档。支持多种持久化模式（engram/openspec/hybrid/none），严格遵循角色委派、语言规范及文件存储约定。
编排器启动变更提案工作流
需要创建SDD变更提案文档
npx skills add Gentleman-Programming/gentle-ai --skill sdd-propose -g -y
专注于 SDD 研究任务的子代理，负责收集外部证据、验证来源并生成可审计的研究成果。严格遵循权限与持久化规则，确保结论有据可依，输出包含状态、摘要及风险评估的结构化结果。
需要进行 SDD 研究
需要外部证据支持
要求基于来源的审计型研究
npx skills add Gentleman-Programming/gentle-ai --skill sdd-research -g -y
作为子代理负责编写SDD规格说明，根据变更提案生成结构化的需求与场景，描述系统行为的增删改查。支持Engram、OpenSpec及混合模式，确保技术文档的规范持久化。
编排器启动规格制定工作
需要为变更生成结构化需求和场景
npx skills add Gentleman-Programming/gentle-ai --skill sdd-spec -g -y
将 SDD 变更分解为具体实施任务，依据提案、规范和设计生成 tasks.md。支持 Engram、OpenSpec 及混合模式，自动识别文件变更、依赖顺序、测试要求及安全威胁矩阵。
需要分解 SDD 变更为具体实现步骤时
Orchestrator 启动变更的任务规划阶段时
npx skills add Gentleman-Programming/gentle-ai --skill sdd-tasks -g -y
指导创建符合规范的LLM技能文件，包括结构定义、前置检查及元数据格式，确保AI使用模式的可复用性。
创建新技能
编写Agent指令
记录AI使用模式
npx skills add Gentleman-Programming/gentle-ai --skill skill-creator -g -y
用于审计、重构和规范化现有 SKILL.md 文件的技能，确保符合 LLM-first 规范。
审计现有 SKILL.md
重构 SKILL.md
提升技能质量
npx skills add Gentleman-Programming/gentle-ai --skill skill-improver -g -y
维护技能索引注册表，在技能增删改后扫描并生成索引文件，支持去重与持久化，为智能体提供准确的路径指引。
安装、移除或创建技能
技能目录发生变动
需要刷新技能索引
npx skills add Gentleman-Programming/gentle-ai --skill skill-registry -g -y
指导对系统性问题进行分类和修复，强调按根因聚类处理而非逐个修补，防止过度工程化。要求修复必须简化系统结构，通过删除或放宽现有逻辑来解决问题，并确保所有关闭都有测试证据支持。
新issue报告
bug报告
问题分类
积压工作规划
npx skills add Gentleman-Programming/gentle-ai --skill systemic-issue-triage -g -y
指导将代码变更拆分为可独立审查的工作单元，确保提交包含测试和文档，保持仓库状态合理，并支持链式PR以控制单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
用于将超过400行的大型PR拆分为可链式或堆叠的较小PR，确保每次审查在60分钟内完成。包含决策门控、执行步骤及输出规范，旨在控制代码审查负载并提升合并效率。
PR变更行数超过400行
用户请求拆分PR或管理审查负载
SDD提示高风险或推荐链式PR
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-chained-pr -g -y
指导如何设计降低认知负荷的技术文档，适用于PR描述、README、架构指南等。通过结构化模板和渐进式披露等模式，提升文档的可读性与审查效率。
编写或编辑技术文档
创建PR描述或审查笔记
撰写架构或入职指南
npx skills add Gentleman-Programming/gentle-ai --skill cognitive-doc-design -g -y
指导 AI 撰写温暖、直接且高效的协作评论，适用于 PR 反馈、Issue 回复等场景。强调快速切入重点、解释原因、保持简短并匹配语境语言，避免冗余和语气生硬。
PR 代码审查反馈
Issue 问题回复
GitHub 评论撰写
Slack/Discord 异步沟通
npx skills add Gentleman-Programming/gentle-ai --skill comment-writer -g -y
用于编写、验证和调试 gentle-ai 的基准测试旅程（journeys），确保符合 CI 规范与评审规则，通过构建二进制并运行驱动模式来提供执行证据。
添加或修改 bench/ 下的旅程文件
诊断 CI 单元测试中的基准测试失败
产品语义变更需检查受影响的旅程
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-bench -g -y
面向 gentle-ai 项目外部贡献者的协作规范，严格遵循 Issue-first 工作流。涵盖 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
用于审计缺陷库中共享根本原因，通过机制映射和删除驱动策略解决集群问题，并基于证据关闭过时或已修复的Issue。
root audit
issue roots
resolver issues de raíz
npx skills add Gentleman-Programming/gentle-ai --skill issue-root-resolution -g -y
规范RDD审查器传输契约，统一Go后端与多运行时适配器的交互标准。明确适配器职责边界、数据格式及错误处理机制，确保审查流程的原子性、一致性和可追溯性。
修改审查器提示词或证据模式
调整运行时调用逻辑
涉及审查结果架构变更
npx skills add Gentleman-Programming/gentle-ai --skill rdd-advisory-transport -g -y
指导基于RDD的缺陷修复工作流，涵盖审批、影响映射、测试验证及变更预算控制。
RDD enabled
defect workflow
receipt-driven development
npx skills add Gentleman-Programming/gentle-ai --skill rdd-defect-workflow -g -y
用于系统化归因和分类问题，防止逐个修复症状导致系统过度工程化。通过根因聚类批量解决缺陷，强制验证测试证据，并严格审查变更是否增加复杂性，确保修复精简有效。
新Issue或Bug报告
问题分流与优先级排序
积压问题回溯分析
npx skills add Gentleman-Programming/gentle-ai --skill systemic-issue-triage -g -y
指导如何将代码变更拆分为可审查的工作单元，确保提交包含完整行为、测试和文档，避免按文件类型拆分。适用于准备PR、拆分大型功能或构建链式PR，以控制单PR行数并降低审查认知负荷。
实现功能时的提交规划
将大变更拆分为链式PR
准备PR前的提交整理
npx skills add Gentleman-Programming/gentle-ai --skill work-unit-commits -g -y
