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)
用于准备分支和拉取请求的便携式技能。严格遵循目标仓库的贡献政策，包括关联Issue、标签规范及CI检查，确保PR合规性。
创建或打开拉取请求
准备提交代码的分支
npx skills add Gentleman-Programming/gentle-ai --skill branch-pr -g -y
用于将超过400行的大型PR拆分为链式或堆叠PR，以控制审查负载并保护代码质量。自动评估变更规模，选择合适策略，生成依赖图及验收计划，确保每个子PR独立可合并且符合审查时长限制。
PR变更行数超过400行
用户请求链式或堆叠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
用于生成温暖、直接且高效的协作评论，适用于PR反馈、Issue回复及Slack沟通。遵循简洁、解释原因及多语言适配规则，提升团队沟通质量。
撰写PR代码审查反馈
回复Issue讨论
发送Slack或Discord项目消息
npx skills add Gentleman-Programming/gentle-ai --skill comment-writer -g -y
指导在 gentle-ai 项目中编写、验证和调试 bench/journey 测试用例，确保 CI 流程正确执行驱动模式测试。
修改 bench/ 目录下的 journey 文件
诊断 bench 相关的 CI 单元测试失败
添加新的产品语义验证旅程
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-bench -g -y
用于 Go 语言测试编写与审查，涵盖表驱动测试、覆盖率提升、Bubbletea/TUI 交互测试及黄金文件管理。指导选择合适测试模式并执行标准化流程。
编写或审查 Go 测试代码
增加测试覆盖率
测试 Bubbletea/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 的技能。支持从仓库证据生成问题，严格遵循目标仓库的 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模式激活
缺陷修复流程启动
收据驱动开发场景
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
用于指导AI创建符合规范的LLM技能文件。涵盖触发条件、硬规则、决策门及执行步骤，确保技能结构标准化并正确引用资源。
创建新技能
编写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
维护技能注册表索引，在技能增删改后刷新索引。通过命令或手动扫描SKILL.md，处理去重与优先级，输出索引文件并持久化至Engram，供Agent调度使用。
安装、移除、创建、移动或重命名技能后
需要更新技能索引时
npx skills add Gentleman-Programming/gentle-ai --skill skill-registry -g -y
用于系统化分类和处理软件缺陷与需求，强调按根因聚类而非逐个修复，防止系统过度工程化。适用于新issue、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
规范 Gentle AI 仓库的分支创建与 PR 提交流程，强制关联已批准 Issue、类型标签及行数限制。更新逻辑以尊重目标仓库贡献政策，确保 CI 检查通过并符合 issue-first 贡献策略。
准备向 Gentleman-Programming/gentle-ai 提交代码
创建功能或修复分支
发起 Pull Request
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-branch-pr -g -y
该技能用于在PR超过400行或存在堆叠PR时，将大型变更拆分为链式或堆叠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回复
Review意见
Slack消息
npx skills add Gentleman-Programming/gentle-ai --skill comment-writer -g -y
用于在 gentle-ai 项目中编写、验证和调试基准测试旅程（journeys），确保语义变更时旧行为被正确检测，并通过构建二进制运行驱动模式测试以提供执行证明。
添加或修改 journey
诊断 bench CI 失败
产品语义变更需检查 pin
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-bench -g -y
指导外部协作者遵循 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
用于审计缺陷 backlog，通过根因分析聚类问题并制定修复方案。强调基于代码验证、机制映射和删除式修复，确保解决根本原因而非表面现象，并规范问题关闭流程。
root audit
issue roots
backlog roots
mechanism map
deletion-driven fix
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)的缺陷修复工作流，涵盖审批检查、因果不变量隔离、影响映射及严格测试验证，确保变更可控且可追溯。
RDD enabled
defect workflow
receipt-driven development
npx skills add Gentleman-Programming/gentle-ai --skill rdd-defect-workflow -g -y
系统化问题分诊技能，指导按根因分类处理issue，合并同类项以单一修复解决多个问题，防止系统过度工程化。适用于新issue、bug报告及积压问题的批量分析与修复规划。
新issue提交
bug报告
问题分诊
积压问题管理
社区报告
根因分析
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
