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
协助提交代码审查
npx skills add Gentleman-Programming/gentle-ai --skill branch-pr -g -y
该技能用于管理超过400行变更的PR，通过将其拆分为链式或堆叠PR来保持审查焦点。它定义了拆分规则、决策门和执行步骤，确保每个子PR独立可审查并维护依赖关系。
PR变更行数超过400行
用户请求链式或堆叠PR
SDD预测高风险或推荐链式PR
npx skills add Gentleman-Programming/gentle-ai --skill chained-pr -g -y
提供降低认知负荷的文档设计指南，涵盖PR描述、README及架构文档。通过结构化模板和渐进式披露等模式，优化信息呈现，提升阅读与审查效率。
编写或编辑技术文档
创建PR描述和审查笔记
撰写架构或入职指南
npx skills add Gentleman-Programming/gentle-ai --skill cognitive-doc-design -g -y
指导AI撰写温暖、直接且高效的协作评论，适用于PR反馈、Issue回复及Slack消息。遵循快速切入、解释原因、保持简短等语音规则，提供标准化评论公式与示例，支持多语言语境匹配。
PR代码审查反馈
Issue回复与建议
GitHub评论撰写
Slack或Discord项目沟通
npx skills add Gentleman-Programming/gentle-ai --skill comment-writer -g -y
指导在 gentle-ai 项目中编写、验证和运行基准测试旅程（Journey）的技能。涵盖 CI 复现、ID 唯一性检查、Review 状态声明及驱动模式执行，确保语义变更后的测试覆盖率与正确性。
添加或修改 journey
诊断 bench 测试失败
产品语义变更影响旅程
执行 go test ./bench
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-bench -g -y
指导编写和审查Go测试，涵盖表格驱动测试、覆盖率提升、Bubbletea TUI流测试及黄金文件管理。提供决策门径和执行步骤，确保测试行为导向、状态转换准确及集成测试可跳过。
编写或审查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的Skill。严格遵循YAML表单与仓库策略，执行重复检查及权限验证，确保Issue创建的合规性与事实准确性。
创建GitHub Issue
Bug报告提交
功能请求处理
Issue审批与分类
npx skills add Gentleman-Programming/gentle-ai --skill issue-creation -g -y
执行对抗性双重代码审查，通过两个独立评审者并行验证目标，仅在双方确认严重问题时触发修复，最多两轮修正与复审，最终输出批准或升级结论。
用户明确要求进行 Judgment Day 或双重/对抗性审查
需要对特定代码目标进行严格的 adversarial review
npx skills add Gentleman-Programming/gentle-ai --skill judgment-day -g -y
指导基于RDD的缺陷修复工作流，涵盖审批、影响分析、测试验证及发布门禁。确保变更符合因果不变量与回滚边界，严格限制代码修改量并提供证据化决策。
需要处理软件缺陷或Bug修复
执行接收驱动开发(RDD)流程
进行代码审查与合并前的质量门禁评估
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技能文件，包括定义触发场景、遵循样式指南、构建结构化SKILL.md及注册技能。
创建新技能
编写Agent指令
记录AI使用模式
npx skills add Gentleman-Programming/gentle-ai --skill skill-creator -g -y
用于审计、重构和规范现有SKILL.md文件，确保符合LLM-first标准。通过检查元数据、触发器清晰度和结构，生成改进报告或应用安全修改，保留作者意图并优化内容布局。
需要审计现有技能定义
要求重构或规范化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及ODD开发流程。
实现功能时拆分提交
准备PR前的提交整理
大型变更转为链式PR
npx skills add Gentleman-Programming/gentle-ai --skill work-unit-commits -g -y
指导在Gentle AI项目中创建分支和PR，强调基于已批准Issue、类型标签规范、400行限制及权限控制，确保PR符合CI检查并避免AI署名。
准备或创建Pull Request
为新功能或修复创建分支
审查PR合规性
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-branch-pr -g -y
该技能用于处理大型或堆叠的Pull Request，通过将超过400行代码的变更拆分为链式PR来保护审查焦点。它提供决策门限和执行步骤，确保每个PR独立可审查且符合时间预算，从而优化代码审查流程。
PR变更行数超过400行
用户请求链式或堆叠PR
SDD预测高行号预算风险
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消息
npx skills add Gentleman-Programming/gentle-ai --skill comment-writer -g -y
规范 gentle-ai 基准测试中旅程（Journey）的编写、验证与执行流程，确保语义变更下的回归测试有效性。
添加或修改 bench/ 目录下的旅程文件
诊断 CI 基准测试失败
产品语义变更需检查旧行为关联
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-bench -g -y
指导外部协作者遵循 Gentle-AI 仓库的 Issue-First 工作流，涵盖 Issue 创建、PR 起草、Chained-PR 策略选择及合规性审计。
在 Gentleman-Programming/gentle-ai 仓库中作为外部协作者贡献代码
需要起草、编辑或审核 Pull Request 内容
决定使用 Chained 还是 Stacked 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
定义Go语言RDD审核器传输契约，规范运行时适配器与核心逻辑的边界。确保提示词、证据和结果模式的统一性，防止并行系统构建，保障审核流程的原子性与安全性。
修改运行时调用RDD审核器的方式
触碰审核提示词或结果模式
实现新的审核适配器
npx skills add Gentleman-Programming/gentle-ai --skill rdd-advisory-transport -g -y
指导基于RDD（收据驱动开发）的缺陷修复工作流，涵盖触发检查、因果不变量隔离、影响映射、行为测试及发布门禁，确保变更可控且可追溯。
用户发起缺陷修复任务
涉及收据驱动开发流程的代码修改
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
