Agent Skills
› kinncj/Heimdall
kinncj/Heimdall
GitHub对生成UI执行WCAG 2.2 AA无障碍审计。支持Web和TUI目标，使用axe或pa11y工具检测违规并阻断合并。新增最小要求检查表及工具自动检测逻辑，确保符合无障碍标准。
安装全部 Skills
npx skills add kinncj/Heimdall --all -g -y
集合内 Skills (105)
按质量分展示前 50 个（共 105 个），完整列表请用安装命令预览或逐个打开详情。
对生成UI执行WCAG 2.2 AA无障碍审计。支持Web和TUI目标，使用axe或pa11y工具检测违规并阻断合并。新增最小要求检查表及工具自动检测逻辑，确保符合无障碍标准。
故事包含 ui:true
明确要求进行无障碍审计
npx skills add kinncj/Heimdall --skill a11y-audit -g -y
根据设计令牌和原型自动生成完整UI组件骨架，包含实现文件、Storybook故事、单元测试及Gherkin规范。支持React-Mantine等框架，基于项目配置自动检测技术栈并生成可运行的TODO存根代码。
需要创建新的UI组件结构
从设计稿生成组件骨架代码
npx skills add kinncj/Heimdall --skill component-scaffold -g -y
从故事Markdown文件提取Gherkin场景生成可执行的.feature文件，并自动生成步骤定义桩代码。支持TypeScript、JavaScript、Python和Java框架，确保测试用例与需求文档同步。
需要同步故事文档到测试套件
从Markdown生成Cucumber特性文件
生成步骤定义桩代码
npx skills add kinncj/Heimdall --skill cucumber-automation -g -y
读取和写入 W3C DTCG 格式的设计令牌（tokens.json），并生成 CSS 自定义属性、Tailwind 配置及 Mantine 主题对象。该技能用于修改或生成设计令牌，确保以 tokens.json 为唯一数据源进行框架输出。
需要修改品牌色、字体或间距等设计变量时
需要将设计令牌导出为 CSS、Tailwind 或 Mantine 格式时
npx skills add kinncj/Heimdall --skill design-tokens -g -y
提供Docker和Compose最佳实践，包括多阶段构建、健康检查及安全规范。指导编写高效容器化配置，强调非root运行、缓存优化及distroless镜像使用。
编写或审查Dockerfile时
配置Docker Compose服务时
需要优化容器构建流程时
npx skills add kinncj/Heimdall --skill docker-patterns -g -y
识别并标注架构决策的云服务成本影响。涵盖计算、存储、网络及第三方API费用，提供Terraform注释规范与月度估算模板，辅助审查基础设施变更时的成本效益。
审查基础设施变更
设计新服务时评估成本
npx skills add kinncj/Heimdall --skill finops-review -g -y
用于自动化管理GitHub Issue生命周期，涵盖创建、查看、编辑标签与指派、评论、关闭及列表查询。支持基于故事阶段自动添加特定模板评论，并通过正文引用实现Issue间的父子或阻塞关联。
需要创建新的GitHub Issue以记录故事或任务
需要根据当前开发阶段更新Issue的标签、指派或状态
需要在Issue中添加符合角色规范的进度或错误评论
需要查询或过滤特定时期的Open Issues
npx skills add kinncj/Heimdall --skill gh-issues -g -y
幂等初始化与同步 GitHub Labels 和 Milestones。通过脚本自动创建缺失标签或更新现有属性，确保项目配置一致。适用于新项目启动及 CI/CD 流程中的状态保障。
新建 GitHub 仓库需要标准化标签体系
CI/CD 流水线中确保 Label 状态同步
团队统一工作分类、优先级及阶段标识
npx skills add kinncj/Heimdall --skill gh-labels-milestones -g -y
管理 GitHub Projects v2 看板，支持通过 CLI 或 GraphQL API 添加 Issue、查询字段及选项 ID、更新单-select 字段值（如状态、类型）。
需要向 GitHub 项目看板添加 Issue
需要更新项目看板的字段值（如状态）
需要查询项目看板的当前状态或字段配置
npx skills add kinncj/Heimdall --skill gh-projects -g -y
用于生成符合规范、命名一致的Gherkin故事文件。涵盖ID分配、时间戳生成、文件名构建、标签格式化及场景验证，供产品负责人编写或更新故事时使用。
编写新的Gherkin故事文件
更新现有的Gherkin故事文件
npx skills add kinncj/Heimdall --skill gherkin-authoring -g -y
提供GitHub CLI (gh) 完整参考，涵盖仓库上下文、Issue（增删改查、评论、状态流转）及PR（创建、审查、合并）操作。适用于自动化管理GitHub工作流，支持任务跟踪、代码审查与CI状态检查。
需要创建或管理GitHub Issue
需要提交或合并Pull Request
查询GitHub仓库状态或搜索Issue/PR
自动化Git工作流中的GitHub交互
npx skills add kinncj/Heimdall --skill github-cli -g -y
用于去除文本中的AI生成痕迹和人工化语言模式，使文档、注释、提交信息等内容更自然。支持通过命令或对话调用，可校准个人风格，检测并修正29种常见AI写作特征，适用于合并前的最终润色。
需要去除文本中AI生成痕迹时
在代码提交前检查提交信息和注释
生成或更新文档后需自然化处理
调整AI辅助写作的语气以符合品牌一致性
npx skills add kinncj/Heimdall --skill humanizer -g -y
提供 Jupyter Notebook 最佳实践，涵盖标准单元格结构、使用 Papermill 实现参数化执行、通过 nbformat 编程创建笔记本、利用 nbconvert 导出格式及 Git 版本控制规范，确保代码可复现性与整洁性。
处理 .ipynb 文件时
需要优化 Notebook 结构或流程时
配置自动化执行或导出时
npx skills add kinncj/Heimdall --skill jupyter-patterns -g -y
依据Karpathy四大原则审计代码变更，自动拦截或手动触发。生成合规报告，未达标则阻止进入验证阶段，确保代码简洁、精准且目标明确。
Phase 5 IMPLEMENT完成后自动触发
用户手动输入/karpathy-audit或@karpathy-audit
npx skills add kinncj/Heimdall --skill karpathy-audit -g -y
提供Kubernetes和Kustomize的最佳实践模板，涵盖基础目录结构、Deployment配置（含安全上下文与探针）、PDB及HPA资源定义。内置验证工作流指导，辅助编写或审查k8s清单文件。
编写Kubernetes部署清单
审查K8s配置文件
配置Kustomize分层管理
设置自动扩缩容策略
npx skills add kinncj/Heimdall --skill kubernetes-patterns -g -y
用于生成和验证Mermaid图表（组件、序列、ER、部署、状态机），以记录软件架构。要求图表语法正确，节点不超过30个，并在提交前测试。
需要绘制系统架构图
需要展示业务流程时序
需要描述数据库实体关系
需要规划基础设施部署
需要定义业务状态流转
npx skills add kinncj/Heimdall --skill mermaid-diagrams -g -y
根据已批准的原型和设计令牌，使用项目指定的UI技术栈（如Mantine、Tailwind或HTML）生成高保真UI组件Mockup代码。支持Web和TUI目标，需通过预检确保原型状态及令牌文件存在。
需要基于已批准的原型图生成高保真UI组件代码
需要将设计令牌应用于具体的UI框架以创建可运行Mockup
npx skills add kinncj/Heimdall --skill mockup -g -y
通用调度器，按优先级执行Taffy工作流、本地技能或子代理。支持从skills.sh注册表自动安装缺失技能，并在状态文件中实时记录运行进度。
需要执行命名工作流、技能或代理时
用户希望统一入口触发复杂任务流水线时
npx skills add kinncj/Heimdall --skill pipeline-runner -g -y
提供 Playwright CLI 交互式浏览器探索与基于快照的交互指南。涵盖安装、核心命令（打开页面、快照、点击填充）、会话管理及截图，并展示从快照到测试代码的工作流及 API 测试方法，旨在优化 Token 效率。
需要进行浏览器自动化操作
编写或运行 Playwright E2E 测试
需要交互式探索网页元素
生成或调试 UI 测试脚本
npx skills add kinncj/Heimdall --skill playwright-cli -g -y
提供PostgreSQL Schema、迁移和查询的最佳实践。涵盖表设计（含RLS）、索引优化、连接池配置及规范，确保使用幂等SQL进行数据库开发。
编写数据库Schema
创建数据迁移文件
优化复杂SQL查询
配置PgBouncer连接池
npx skills add kinncj/Heimdall --skill postgresql-patterns -g -y
提供 Redis 集成最佳实践，涵盖键命名规范、Cache-Aside 缓存模式、基于有序集合的限流及 Session 存储方案。强调设置 TTL、使用 SCAN 和 Pipeline 等规则，确保高性能与稳定性。
需要实现 Redis 缓存逻辑
设计 API 限流功能
配置会话状态存储
npx skills add kinncj/Heimdall --skill redis-patterns -g -y
用于指导编写和管理架构决策记录（ADR）。当涉及重大技术选型、框架引入或关键模式变更时，依据此模板在 docs/specs/ 下创建 ADR，全面记录背景、目标、方案对比、风险及影响评估，以固化架构决策。
需要在多个非平凡的技术方案中进行选择
决定采用新的技术栈或框架
修改现有的重要架构模式
做出具有长期影响的权衡决策
npx skills add kinncj/Heimdall --skill rfc-adr -g -y
模拟橡皮鸭调试，对计划、代码或测试提供独立审查意见。支持PLAN/CODE/TEST三种模式，输出CRITICAL/WARN/INFO分级反馈及APPROVE/REQUEST_CHANGES裁决，辅助捕捉遗漏问题并指导后续迭代。
Phase 3 计划完成后
复杂多文件实现后
编写测试后运行前
对当前工作感到不确定时
npx skills add kinncj/Heimdall --skill rubber-duck -g -y
在代码发布前执行安全与质量审计，检查密钥泄露、漏洞及风险模式。需启用环境变量后使用，根据严重程度分类结果，阻断高危问题，确保上线安全。
提交PR前
合并功能分支到主分支前
新增依赖后
修改认证或基础设施配置后
npx skills add kinncj/Heimdall --skill ship-safe -g -y
用于在开发前生成Gherkin格式的用户故事文件，作为最小规格说明。包含状态机流程、文件模板、自动化校验脚本及场景数量指导，确保需求明确且经过审批后方可进入实现阶段。
需要为新功能编写用户故事时
需要验证现有故事文件的合规性与审批状态时
npx skills add kinncj/Heimdall --skill spec-kit -g -y
评估新功能上线前的运维就绪状态，涵盖故障模式分析、可观测性指标（Metrics/Logs/Traces）及告警配置，并提供标准化的故障排查与恢复运行手册模板。
新功能上线前评审
生产环境发布检查
服务变更风险评估
npx skills add kinncj/Heimdall --skill sre-review -g -y
维持故事Markdown文件与GitHub Issue的双向同步。文件主导叙事和Gherkin，Issue主导标签、状态及DoD。支持新建Issue并回填编号，以及更新Issue内容以反映文件变更。
需要创建新的GitHub Issue以关联故事文件时
故事文件的正文或验收标准发生修改需同步至Issue时
npx skills add kinncj/Heimdall --skill story-issue-sync -g -y
提供Stripe API集成最佳实践，涵盖Webhook签名验证、幂等性键使用及订阅处理。包含本地测试命令、TypeScript代码示例及安全规范，确保支付流程稳定可靠。
需要集成Stripe支付功能
实现Webhook事件处理逻辑
创建Checkout Session
处理Stripe订阅管理
npx skills add kinncj/Heimdall --skill stripe-patterns -g -y
提供 Supabase 开发最佳实践，涵盖本地工作流、数据库迁移及行级安全策略配置。包含 Edge Function 的身份验证模式与安全规范，强调 RLS 强制启用、禁止客户端暴露 service_role 密钥及类型安全生成。
构建 Supabase 应用
配置数据库表结构
设置行级安全策略
开发 Supabase Edge Functions
处理用户身份验证
npx skills add kinncj/Heimdall --skill supabase-patterns -g -y
指导基于红绿重构循环的测试驱动开发工作流。涵盖QA编写失败测试、专家实现最小代码及重构阶段，支持ATDD模式与集成测试容器生命周期管理，确保先写测试后实现。
需要实现新功能时
执行测试驱动开发流程时
npx skills add kinncj/Heimdall --skill tdd-workflow -g -y
提供Terraform基础设施即代码的最佳实践，涵盖模块化目录结构、资源定义规范及工作流。强调成本估算标注、环境隔离、状态锁定及安全规则，确保IaC的可维护性与合规性。
编写或重构Terraform配置
规划基础设施变更
检查Terraform代码规范
npx skills add kinncj/Heimdall --skill terraform-patterns -g -y
基于STRIDE框架对组件和信任边界进行威胁建模，生成包含资产、风险分析及缓解措施的威胁注册表。适用于功能发布前的安全审查，确保识别并缓解潜在安全风险。
需要为新功能或模块进行安全风险评估
执行STRIDE威胁建模分析
准备上线前的安全检查清单
npx skills add kinncj/Heimdall --skill threat-modeling -g -y
提供 Vercel 部署、Edge 函数及环境变量配置的最佳实践。涵盖 vercel.json 设置、运行时选择、中间件模式及 CLI 工作流，指导开发者高效安全地部署 Next.js 应用。
Vercel 部署配置
Next.js 运行时选择
Vercel 环境变量管理
Edge Middleware 实现
npx skills add kinncj/Heimdall --skill vercel-patterns -g -y
根据品牌简报生成视觉识别系统（配色、排版等），输出JSON供design-tokens使用。支持Web和TUI目标，确保WCAG对比度合规。需人工审批后生效。
建立品牌视觉识别
生成设计令牌
需要符合WCAG标准的配色方案
npx skills add kinncj/Heimdall --skill visual-identity -g -y
根据用户故事文件生成低保真线框图，支持ASCII、SVG和HTML格式。基于项目配置自动适配Web或TUI目标，确保输出包含必要的布局文件和审批元数据，供下游Mockup工作使用。
需要为UI故事创建低保真线框图时
从用户故事文件生成ASCII、SVG或HTML布局原型时
npx skills add kinncj/Heimdall --skill wireframe -g -y
针对生成UI运行WCAG 2.2 AA无障碍审计，支持axe或pa11y工具。需为ui:true的故事执行，拦截AA违规。新增tui目标支持：跳过浏览器工具，基于终端清单评估并输出兼容格式的JSON报告。
故事包含 ui:true
用户明确要求审计无障碍性
npx skills add kinncj/Heimdall --skill a11y-audit -g -y
根据设计令牌和原型自动生成完整的UI组件文件树，包含实现代码、Storybook故事、单元测试及Gherkin规范骨架。自动检测技术栈，生成可运行的TODO占位符代码，加速前端组件开发流程。
需要创建新的UI组件
初始化组件目录结构
生成带测试的组件骨架
npx skills add kinncj/Heimdall --skill component-scaffold -g -y
从故事Markdown文件提取Gherkin场景生成可执行的.feature文件，并自动生成步骤定义存根。支持TS/JS、Python和Java框架，保持测试与文档同步。
需要将用户故事转换为自动化测试用例
同步docs/stories到tests/features目录
为新功能生成Cucumber步骤定义骨架
npx skills add kinncj/Heimdall --skill cucumber-automation -g -y
用于读取和写入 W3C DTCG 格式的设计令牌，并生成 CSS、Tailwind 和 Mantine 输出。以 tokens.json 为唯一数据源，自动派生框架配置，禁止手动编辑生成的文件。
需要修改设计系统颜色、字体或间距等令牌时
需要重新生成或更新前端框架的样式配置时
npx skills add kinncj/Heimdall --skill design-tokens -g -y
提供Docker和Docker Compose最佳实践，涵盖多阶段构建、健康检查配置及.dockerignore规范。强调生产环境安全与性能，如使用非root用户、distroless镜像及缓存优化。
编写或审查Dockerfile
配置Docker Compose服务
优化容器构建流程
npx skills add kinncj/Heimdall --skill docker-patterns -g -y
用于识别和标注架构决策的云成本影响。涵盖计算、存储、网络及第三方API的费用驱动因素，提供Terraform注释格式、架构审查问题清单及月度成本估算模板，辅助基础设施变更审查与新服务设计。
审查基础设施变更
设计新服务时评估成本
npx skills add kinncj/Heimdall --skill finops-review -g -y
管理GitHub Issue全生命周期，支持创建、查看、编辑标签与指派、评论及关闭。通过CLI命令自动化处理故事制品，适配不同阶段模板，实现从需求到QA的无干预流转。
需要创建新的GitHub Issue作为故事制品时
根据故事状态更新Issue标签或指派负责人时
在Issue中添加阶段性进展评论或阻塞通知时
npx skills add kinncj/Heimdall --skill gh-issues -g -y
用于在GitHub仓库初始化或CI流程中，幂等地创建和同步Labels与Milestones。通过upsert逻辑确保标签状态一致，支持阶段、类型、优先级及规范等多维分类，且仅增改不删除。
新项目初始化时配置标准标签体系
CI/CD流水线中同步仓库元数据
需要统一团队Issue/Milestone分类规范时
npx skills add kinncj/Heimdall --skill gh-labels-milestones -g -y
管理GitHub Projects v2看板，支持添加Issue卡片、查询及更新字段值（如状态）。优先使用gh CLI，不可用时回退至GraphQL API。
需要向GitHub项目看板添加Issue
需要更新项目看板的字段状态
npx skills add kinncj/Heimdall --skill gh-projects -g -y
用于生成符合规范的 Gherkin 故事文件。涵盖命名约定、ID 分配、时间戳生成及模板填充，并提供场景验证规则（如单一职责、Given-When-Then顺序）和背景块支持，确保故事文件的一致性与有效性。
编写新的用户故事文件
更新现有的 Gherkin 故事
需要为史诗分配新的故事 ID
验证 Gherkin 语法和标签规范
npx skills add kinncj/Heimdall --skill gherkin-authoring -g -y
提供GitHub CLI (gh) 综合参考，涵盖Issue创建、读写、更新、评论及关闭，以及PR的创建、审查、CI检查与合并操作。
需要管理GitHub Issue时
需要创建或处理Pull Request时
需要查看仓库状态或认证信息时
npx skills add kinncj/Heimdall --skill github-cli -g -y
移除文本中的AI写作痕迹，使文档、注释和文章更自然。支持自定义风格校准，检测29种AI模式并执行多轮重写优化。
用户输入 /humanizer 命令
询问请人性化这段文本
MAPLE流程Phase 7后且配置了humanize: true
npx skills add kinncj/Heimdall --skill humanizer -g -y
提供Jupyter Notebook最佳实践，包括标准单元格结构、使用Papermill实现参数化执行、通过nbformat编程创建笔记本、利用nbconvert导出格式以及Git版本控制清理输出，确保代码可复现性和规范性。
处理.ipynb文件
需要标准化Jupyter Notebook结构
配置Papermill参数化执行
编程生成Notebook
导出Notebook为HTML或PDF
清理Notebook输出以提交Git
npx skills add kinncj/Heimdall --skill jupyter-patterns -g -y
基于Karpathy四大原则审计代码变更，确保符合思考、简洁、精准和目标导向。在实施阶段后自动触发或手动调用，生成评分报告并决定流程是否通过。
Phase 5 IMPLEMENT完成后自动触发
用户在聊天中发送/karpathy-audit或@karpathy-audit
npx skills add kinncj/Heimdall --skill karpathy-audit -g -y
提供Kubernetes和Kustomize的最佳实践模板，涵盖基础目录结构、安全Deployment配置、PDB及HPA资源定义。内置验证工作流，辅助编写和审查K8s清单文件。
编写或审查Kubernetes YAML配置文件
使用Kustomize管理环境覆盖层
配置PodDisruptionBudget或HorizontalPodAutoscaler
执行k8s资源应用的干运行验证
npx skills add kinncj/Heimdall --skill kubernetes-patterns -g -y
