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 模板，并强制自动化检查通过。
创建或准备 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及架构文档。包含关键写作模式（如渐进式披露）和标准Markdown结构模板，旨在提升文档的可读性与审查效率。
编写或编辑需要快速理解的文档
创建PR描述或审查笔记
撰写贡献者指南或架构文档
优化冗长密集的文档
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 声明及执行证明，确保语义变更时的回归覆盖与驱动模式验证。
修改 bench/ 目录下的旅程文件
产品语义变更需检查旧行为映射
诊断 bench 相关的 CI 单元测试失败
添加或调整 journey corpus
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-bench -g -y
指导编写和审查 Go 测试，涵盖表格驱动测试、Bubbletea TUI 流测试、teatest 使用及黄金文件更新。提供硬规则、决策门和执行步骤，确保测试行为导向、状态转换准确及集成测试可跳过。
编写或审查 Go 测试代码
增加 Go 测试覆盖率
测试 Bubbletea/TUI 交互流程
使用 teatest 进行 UI 测试
更新或维护黄金文件
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表单与仓库策略，执行去重搜索，验证用户权限以处理受保护标签，确保操作合规与安全。
issue creation
bug reports
feature requests
issue approval
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 变更，同步 delta 规范至主规范并移动文件夹，生成最终状态报告以闭环开发周期。
SDD 实施与验证完成后触发归档流程
需要合并最终规范并存档变更记录
npx skills add Gentleman-Programming/gentle-ai --skill sdd-archive -g -y
负责生成SDD技术设计文档，分析变更需求与代码库，输出架构决策、数据流及技术 rationale。支持多种持久化模式，默认英文输出，并包含适用性威胁矩阵评估。
需要创建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上下文，自动检测项目技术栈、测试工具及持久化模式，根据模式生成openspec或Engram配置文件，构建技能注册表并保存测试能力。
用户请求初始化SDD
执行 sdd init 命令
npx skills add Gentleman-Programming/gentle-ai --skill sdd-init -g -y
引导用户在实际代码库中完成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研究阶段的子代理，收集外部证据并生成可审计的技术文档。严格验证数据源权限与持久化一致性，确保结论有据可依，支持决策门控评估。
需要进行SDD研究
需要外部证据支持
需要生成基于来源的研究成果
npx skills add Gentleman-Programming/gentle-ai --skill sdd-research -g -y
负责根据变更提案编写 SDD 增量规格说明，处理新增或修改能力的结构化需求与场景。支持多种持久化模式，确保规范符合项目约定。
需要生成系统行为变更的规格说明
编排器启动规格编写阶段工作
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
用于创建LLM优先的技能定义文件，遵循特定规范生成SKILL.md，包含前置检查、结构模板及元数据要求。
创建新技能
编写Agent指令
文档化AI使用模式
npx skills add Gentleman-Programming/gentle-ai --skill skill-creator -g -y
用于审计、重构和规范现有 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报告进行系统性分类与根因分析，强调按根因集群合并修复而非逐条修补。通过严格的规则防止过度工程化，确保修复方案能精简系统复杂度，并以可执行测试证据关闭问题，提升维护性。
收到新的Issue或Bug报告
需要处理积压的Issue列表
社区反馈导致的问题洪水
识别阻塞用户或死胡同场景
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 检查通过，禁止强制推送及 AI 署名。
创建新修复或功能的分支
在 GitHub 上打开 Pull Request
准备代码变更以供审查
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-branch-pr -g -y
当PR变更超400行或需拆分时，自动将大PR拆分为链式或堆叠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
用于撰写温暖、直接且高效的协作评论，适用于PR反馈、Issue回复及Slack沟通。遵循简洁、解释原因及匹配语言等语音规则，提供结构化公式与示例，提升团队异步沟通质量。
PR代码审查
Issue讨论回复
Slack或Discord项目沟通
npx skills add Gentleman-Programming/gentle-ai --skill comment-writer -g -y
用于在 gentle-ai 项目中编写、验证和运行基准测试旅程。指导如何正确构建二进制文件并执行驱动模式测试，确保 CI 一致性，处理语义变更时的旧旅程检查，以及生成包含实际执行结果的 PR 证据。
添加或修改 journey
诊断 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 策略
验证 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。
审计缺陷根因
解决issue集群
关闭过期issue
npx skills add Gentleman-Programming/gentle-ai --skill issue-root-resolution -g -y
定义 RDD 审查器的统一 Go 传输契约，规范运行时适配器与审查逻辑的边界。确保提示词、证据和结果模式的集中管理，禁止并行系统，保障审查流程的一致性与安全性。
修改任何运行时（如 Claude Code, OpenCode）调用 RDD 审查器的方式
涉及审查器提示词、镜头证据、结果模式或适配器的变更
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报告
积压任务处理
社区反馈
根因分析
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
