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 (38)
指导如何创建符合规范的 Pull Request，包括关联 Issue、命名分支、添加类型标签及检查 CI 状态。
准备提交 PR
创建 Pull Request
协助贡献者打开 PR
npx skills add Gentleman-Programming/gentle-ai --skill branch-pr -g -y
将超过400行的大PR拆分为链式或堆叠PR，确保每次审查聚焦且耗时在60分钟内。处理分支策略选择、依赖管理及例外情况报告，保障代码可维护性。
PR变更行数超过400
用户请求拆分大PR
存在堆叠PR或审查切片需求
npx skills add Gentleman-Programming/gentle-ai --skill chained-pr -g -y
提供降低认知负荷的文档设计指南，适用于PR描述、README、RFC及架构文档。通过前置结论、渐进式披露和分块等模式，优化文档结构与可读性，提升读者理解效率与审查体验。
编写或编辑需要快速理解的文档
创建PR描述或审查笔记
撰写贡献者指南或入职文档
重构冗长密集的文档
npx skills add Gentleman-Programming/gentle-ai --skill cognitive-doc-design -g -y
提供温暖直接的协作评论写作指南，适用于PR反馈、Issue回复及Slack消息。强调高效行动、解释原因、保持简短并匹配上下文语言，旨在提升代码审查与团队沟通质量。
PR反馈
Issue回复
代码审查
Slack或Discord消息
npx skills add Gentleman-Programming/gentle-ai --skill comment-writer -g -y
规范 gentle-ai 基准测试旅程的编写、验证与执行流程，确保语义变更时的回归覆盖。指导开发者通过构建运行器验证驱动模式下的实际执行结果，而非仅依赖声明检查。
修改 bench/ 目录下的旅程文件
诊断 CI 基准测试失败
产品语义变更需验证影响
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-bench -g -y
提供 Go 语言测试最佳实践，涵盖表格驱动测试、Bubbletea/TUI 行为与交互测试、Golden files 管理及集成测试跳过策略。指导开发者选择合适模式并执行标准化测试流程。
编写或审查 Go 测试用例
增加代码覆盖率
测试 Bubbletea TUI 应用
更新 Golden files
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。严格遵循 YAML Issue Form 格式，执行重复检查与标签管理，确保操作符合仓库策略及权限要求。
创建 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模式进行代码审查
处理复杂依赖关系的Bug
npx skills add Gentleman-Programming/gentle-ai --skill rdd-defect-workflow -g -y
负责归档 SDD 变更，将增量规范合并至主规范并移动变更文件夹。确保归档报告准确反映最终状态，避免使用过时中间快照误导读者，完成 SDD 生命周期闭环。
编排器启动归档流程
SDD 变更完成且需持久化记录
npx skills add Gentleman-Programming/gentle-ai --skill sdd-archive -g -y
负责生成SDD技术设计文档，基于提案和规格说明输出架构决策、数据流及实现方案。支持多种持久化模式，包含代码库分析与威胁矩阵评估，确保设计严谨性。
需要创建SDD技术设计时
Orchestrator启动变更设计流程时
npx skills add Gentleman-Programming/gentle-ai --skill sdd-design -g -y
用于在实施变更前探索 SDD 想法的辅助技能。负责调查代码库、分析问题并对比方案，返回结构化分析结果或生成探索文档，支持多种持久化模式。
需要探索新功能或修复方案的场景
需求澄清阶段的技术调研
npx skills add Gentleman-Programming/gentle-ai --skill sdd-explore -g -y
用于初始化 SDD 项目上下文，自动检测技术栈并配置测试能力、持久化及技能注册表。支持 engram、openspec 和 hybrid 模式，根据严格 TDD 设置生成相应配置文件。
用户请求初始化 SDD 环境
执行 sdd init 命令
npx skills add Gentleman-Programming/gentle-ai --skill sdd-init -g -y
SDD工作流入门引导技能，通过交互式指导用户在实际代码库中完成从探索到归档的完整周期，旨在通过实践进行教学。
Orchestrator启动SDD全周期入职流程
需要向用户演示或执行SDD工作流
npx skills add Gentleman-Programming/gentle-ai --skill sdd-onboard -g -y
SDD变更提案子代理，负责根据探索分析生成结构化proposal.md文档。支持Engram、OpenSpec及混合模式，自动处理目录创建与规范遵循。
编排器启动变更提案工作
需要创建结构化技术变更提案
npx skills add Gentleman-Programming/gentle-ai --skill sdd-propose -g -y
SDD研究子代理，负责基于授权外部来源进行可选的技术调查与证据收集。执行角色隔离，仅输出事实、假设及限制，不持久化数据或做产品决策，将未决问题返回编排者。
需要基于外部权威来源进行技术调研
编排者委托进行可选的外部证据收集
npx skills add Gentleman-Programming/gentle-ai --skill sdd-research -g -y
该技能用于作为子代理生成软件设计文档的规格说明，根据变更提案编写结构化需求与场景，支持增量或完整规范，并适配多种持久化模式。
编排器启动变更规格编写工作
需要基于提案生成系统行为变更的结构化描述
npx skills add Gentleman-Programming/gentle-ai --skill sdd-spec -g -y
用于将SDD变更分解为可执行实施任务的子代理，根据提案和设计生成任务列表。
启动变更的任务规划阶段
需要分解SDD变更为具体实施步骤
npx skills add Gentleman-Programming/gentle-ai --skill sdd-tasks -g -y
SDD验证技能，在显式请求时运行可选的诊断检查。审查可用实现和工件，报告测试结果、缺失证据及限制，不进行代码修改或自动修复，确保验证过程客观且独立。
用户显式请求 SDD 验证
需要检查实现状态或测试证据
npx skills add Gentleman-Programming/gentle-ai --skill sdd-verify -g -y
指导创建LLM优先的Agent技能文件，包含触发条件判断、格式规范（Frontmatter）、目录结构及执行步骤，确保技能符合项目标准且具备可复用性。
创建新的Agent技能
编写Agent指令模板
记录AI使用模式
npx skills add Gentleman-Programming/gentle-ai --skill skill-creator -g -y
用于审计、重构和规范现有的LLM技能定义文件。依据风格指南检查元数据、触发器及结构，生成审计报告或在授权后应用修复，确保技能符合运行时指令标准并保留作者意图。
需要审计或改进现有SKILL.md文件时
请求重构或规范化技能定义时
npx skills add Gentleman-Programming/gentle-ai --skill skill-improver -g -y
管理技能注册表，在技能增删改后重建索引。通过gentle-ai命令或手动扫描SKILL.md，去重并生成.registry文件，支持持久化至Engram，确保代理能准确定位和调用技能。
安装、移除、创建、移动或重命名技能后
需要刷新技能索引时
npx skills add Gentleman-Programming/gentle-ai --skill skill-registry -g -y
用于系统性地分类和归并问题，防止过度工程。通过识别根因簇进行批量修复，确保每个修复能缩小系统复杂度而非增加状态，强制基于测试证据关闭问题。
新 issue 或 bug report 处理
backlog 规划与清理
社区报告分析
根因归类
npx skills add Gentleman-Programming/gentle-ai --skill systemic-issue-triage -g -y
指导将代码变更拆分为可独立审查的工作单元，确保测试、文档与行为逻辑同提交，控制单次变更规模以优化代码审查体验并支持链式PR。
实施功能开发
拆分提交历史
构建链式或堆叠PR
保持测试和文档与代码同步
npx skills add Gentleman-Programming/gentle-ai --skill work-unit-commits -g -y
指导创建与准备 Pull Request 的技能，确保关联已批准 Issue、遵守 CI 规则及行数以优化代码审查流程。
创建新分支或功能
提交 PR 进行审查
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-branch-pr -g -y
用于将超400行的大PR拆分为链式或堆叠PR，控制单次审查工作量。
PR变更行数超过400行
用户请求拆分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
指导AI撰写温暖、直接且高效的协作评论，适用于PR反馈、Issue回复及Slack沟通。遵循简洁、解释原因及匹配语境语言等规则，提供标准化评论公式与示例，提升团队沟通质量。
PR代码审查
Issue回复
Slack消息沟通
npx skills add Gentleman-Programming/gentle-ai --skill comment-writer -g -y
用于验证 gentle-ai 基准测试中旅程声明与执行。涵盖编写/审查旅程、处理语义变更导致的旧引脚检查，以及通过构建运行器和本地二进制文件进行驱动模式执行，确保 CI 流程中的测试准确性。
修改 bench/ 目录下的旅程文件
诊断 CI Unit Tests 作业中的基准测试失败
产品语义变更需检查受影响的旅程
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-bench -g -y
指导外部协作者遵循 Gentle-Programming/gentle-ai 的 Issue-first 工作流，包括 PR 起草、链式策略选择及合规性审计。
在 Gentle-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审查者传输层契约，规范运行时（如OpenCode、Codex）调用审查器的边界。强制适配器仅负责调用与原始字节返回，禁止解析逻辑；确保审查结果仅具建议性，由Go端控制准入。
修改运行时调用RDD审查器的方式
调整审查提示词或证据结构
实现或修改审查适配器
npx skills add Gentleman-Programming/gentle-ai --skill rdd-advisory-transport -g -y
指导基于RDD的缺陷修复工作流，涵盖触发检查、因果不变量隔离、影响映射及行为测试。强制执行400行变更限制和只读验证，确保修复的可追溯性与安全性，适用于复杂代码库的规范开发。
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
npx skills add Gentleman-Programming/gentle-ai --skill work-unit-commits -g -y
