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 是否符合规范
npx skills add Gentleman-Programming/gentle-ai --skill branch-pr -g -y
当PR变更超过400行或需拆分时，自动将大PR切分为链式或堆叠PR，确保每部分独立可审且符合审查预算。
PR变更行数超过400行
用户请求拆分PR或控制审查负载
SDD预测高行号预算风险
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 基准测试 Journeys 的创建、验证与故障排查。指导如何编写符合规范的 Journey，执行驱动模式测试，并在 CI 中复现和诊断问题，确保语义变更后的回归覆盖。
添加或修改 journey
产品语义变更需检查 pinned journeys
诊断 bench 在 CI Unit Tests 中的失败
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-bench -g -y
提供Go语言测试最佳实践，涵盖表驱动测试、Bubbletea TUI流程、teatest交互及Golden文件管理。指导编写高质量单元测试与集成测试，确保行为验证与状态转换的准确性。
编写或审查Go测试代码
添加测试覆盖率
测试Bubbletea/TUI应用
使用teatest进行交互测试
更新或维护Golden文件
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管理的规范性和安全性。
创建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触发
收据驱动开发
审查权限管理
缺陷修正与恢复
npx skills add Gentleman-Programming/gentle-ai --skill rdd-defect-workflow -g -y
SDD变更归档技能，负责将增量规范合并至主规范并移动文件夹完成闭环。当前版本改用原子化命令自动合并，取代手动编辑，确保数据一致性并阻断异常。
SDD实现与验证完成后
Orchestrator发起归档流程
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
SDD探索子代理，负责在变更前调查代码库、分析问题并对比方案。它接收主题和存储模式，执行上下文检索与代码研究，最终返回结构化分析或生成探索文档。
编排器启动探索任务
需求澄清阶段
npx skills add Gentleman-Programming/gentle-ai --skill sdd-explore -g -y
用于初始化 SDD（软件设计文档）上下文，自动检测项目技术栈、测试工具和持久化模式。根据指定模式生成 openspec 配置或 Engram 观察记录，并维护技能注册表，实现开发环境的标准化搭建。
sdd init
iniciar sdd
openspec init
npx skills add Gentleman-Programming/gentle-ai --skill sdd-init -g -y
引导用户在实际代码库中完成SDD全流程，通过探索、实施和归档真实变更来教学。适用于新用户上手或团队标准化开发流程。
需要学习SDD工作流
执行SDD入职培训
npx skills add Gentleman-Programming/gentle-ai --skill sdd-onboard -g -y
SDD流程中的提案生成子智能体，负责基于探索分析或用户输入创建结构化变更提案文档。根据指定持久化模式（Engram/OpenSpec等）读取上下文并输出proposal.md。
编排器启动变更提案工作流
需要生成结构化的技术变更提案
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
作为子代理负责编写SDD规格说明，基于变更提案生成结构化的需求与场景，描述系统行为的增删改查。
编排器启动规格编写任务
需要为变更生成结构化需求和场景
npx skills add Gentleman-Programming/gentle-ai --skill sdd-spec -g -y
将 SDD 变更拆解为具体实施任务的子代理，根据提案、规范和设计生成按阶段组织的 tasks.md，支持多种持久化模式。
编排器启动变更的任务规划
需要分解 SDD 变更为可执行步骤
npx skills add Gentleman-Programming/gentle-ai --skill sdd-tasks -g -y
用于创建和维护LLM-first技能文件的指南，包含结构规范、前置条件检查及元数据格式要求。
创建新技能
编写Agent指令
记录AI使用模式
npx skills add Gentleman-Programming/gentle-ai --skill skill-creator -g -y
用于审计、重构和优化现有LLM技能文件，确保符合规范并提升质量。
审计技能文件
重构技能结构
优化技能描述
npx skills add Gentleman-Programming/gentle-ai --skill skill-improver -g -y
用于在技能增删改后重建并维护技能索引。通过扫描目录生成注册表，处理去重与优先级逻辑，并将结果持久化至Engram，为智能体提供准确的技能路径指引。
安装或移除技能后
创建、移动或重命名技能后
需要刷新技能索引时
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创建及SDD风险管控，维持低认知负荷与清晰的故事线。
实现功能时规划提交
拆分大型变更到多个PR
准备PR前的提交整理
npx skills add Gentleman-Programming/gentle-ai --skill work-unit-commits -g -y
指导在 gentle-ai 项目中创建分支和提交 PR，确保关联已批准 Issue、遵循命名规范及代码量限制，通过自动化检查。
需要为新功能或修复创建 Git 分支
准备并打开 Pull Request 以供审查
需要遵循项目特定的 PR 提交流程和规范
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-branch-pr -g -y
当PR变更行数超过400行或需拆分堆叠PR时，自动将大变更拆分为链式PR，确保每次审查在60分钟内完成，并维护依赖关系与追踪PR。
PR变更行数超过400行
用户请求链式或堆叠PR
SDD预测高风险或推荐链式PR
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-chained-pr -g -y
指导如何设计降低认知负荷的技术文档，涵盖PR描述、架构指南等场景。提供结构化模板及渐进式披露等写作模式，旨在提升文档可读性与审查效率。
编写或编辑技术文档
创建PR描述和Review笔记
撰写README、RFC或入职指南
npx skills add Gentleman-Programming/gentle-ai --skill cognitive-doc-design -g -y
指导 AI 撰写温暖、直接且高效的协作评论，适用于 PR 反馈、Issue 回复及 Slack 沟通。强调行动优先、解释原因、保持简短并匹配上下文语言，旨在提升团队沟通质量与效率。
PR 代码审查反馈
Issue 问题回复
Slack 或 Discord 异步沟通
GitHub 评论撰写
npx skills add Gentleman-Programming/gentle-ai --skill comment-writer -g -y
用于 gentle-ai 项目的基准测试旅程编写与验证。指导如何创建、审查 journey 用例，确保 ID 唯一性及 Review 声明合规。强调通过构建二进制并运行 harness 来提供驱动执行的真实证据，而非仅依赖声明检查。
修改 bench/ 目录下的 journey 文件
产品语义变更需更新 pinned journey
诊断 CI Unit Tests job 中的 bench 失败
npx skills add Gentleman-Programming/gentle-ai --skill gentle-ai-bench -g -y
指导外部协作者遵循 Gentle-AI 项目的 Issue-First 工作流，包括 Issue 创建、PR 撰写、链式 PR 策略及合规性审计。
在 Gentleman-Programming/gentle-ai 仓库中发起或评论 Issue
起草、编辑或审核 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
npx skills add Gentleman-Programming/gentle-ai --skill issue-root-resolution -g -y
定义Go语言RDD审查器传输契约，规范多运行时（如OpenCode、Codex）的适配器实现边界。强制统一提示词、证据与结果模式，禁止并行系统，确保传输过程不消耗修正预算且符合最小化原则。
修改任何运行时调用RDD审查器的逻辑
触碰审查器提示词或结果模式
实现或调整ReviewProviderContract适配器
npx skills add Gentleman-Programming/gentle-ai --skill rdd-advisory-transport -g -y
指导基于收据驱动开发(RDD)的缺陷修复工作流，涵盖触发检查、因果不变量隔离、影响映射及E2E验证。强制代码变更预算与只读校验，确保缺陷修复的可追溯性与安全性。
RDD缺陷修复
收据驱动开发
缺陷工作流
npx skills add Gentleman-Programming/gentle-ai --skill rdd-defect-workflow -g -y
用于系统化处理缺陷报告与积压任务，强调按根因分类并批量修复，防止过度工程化。核心规则包括优先识别根本原因、合并同类问题以单一修复解决多个缺陷、通过删除或简化而非增加复杂性来解决问题，并要求修复必须附带可验证的测试证据。
收到新的 bug 报告
进行 issue triage
处理 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
