Agent Skills
› kdlbs/kandev
kdlbs/kandev
GitHub用于调试 ACP Agent CLI，通过 JSON-RPC 会话捕获原始数据帧并生成 JSONL 文件。适用于探测模型能力、对比 Agent、测试 Prompt、检查初始化失败原因及分析原始协议负载。
Install All Skills
npx skills add kdlbs/kandev --all -g -y
Skills in Collection (34)
用于调试 ACP Agent CLI，通过 JSON-RPC 会话捕获原始数据帧并生成 JSONL 文件。适用于探测模型能力、对比 Agent、测试 Prompt、检查初始化失败原因及分析原始协议负载。
用户要求探测或比较 Agent 能力
用户询问 Agent 支持的模型或模式
用户需要调试 Agent 启动失败或初始化问题
用户希望查看或重现原始 ACP 协议数据帧
npx skills add kdlbs/kandev --skill acp-debug -g -y
指导如何添加新的第三方集成（如Jira/Linear），涵盖后端服务架构、前端Hook复用及Mock测试配置，强调使用共享组件与标准模式。
需要接入新的第三方服务
初始化集成模块
搭建外部API对接框架
npx skills add kdlbs/kandev --skill add-integration -g -y
自动清理本地已合并或远程删除的Git分支及关联工作树，保持仓库整洁。
需要清理本地废弃分支
PR合并后整理仓库
npx skills add kdlbs/kandev --skill clean-branches -g -y
用于审查代码质量、安全性和架构合规性。仅在用户明确要求或PR/CI发现需要时触发，针对Go后端与Vite/React单体仓库进行详细检查，要求提供文件路径行号引用及具体修复方案。
用户明确请求本地代码审查
PR或CI流程中产生需要处理的具体发现
npx skills add kdlbs/kandev --skill code-review -g -y
指导使用 Conventional Commits 规范进行代码暂存和提交，确保提交信息格式符合项目要求，支持自动生成变更日志和发布说明。
用户输入 commit
存在脏文件或已暂存的更改
在推送 PR 之前
npx skills add kdlbs/kandev --skill commit -g -y
指导 Agent 在编码或调试前精准收集项目上下文，通过分层加载规则、检查清单及选择性模式，避免信息缺失或过载，确保遵循项目规范与最佳实践。
开始新会话
切换代码区域
输出质量下降
跨前后端任务
需对齐开发规范
npx skills add kdlbs/kandev --skill context-engineering -g -y
用于创建、修改、调试、测试、打包或发布Kandev运行时插件的专用技能，涵盖从模板构建到市场发布的完整生命周期。
创建新的Kandev插件
修复现有Kandev插件Bug
发布Kandev插件
npx skills add kdlbs/kandev --skill create-kandev-plugin -g -y
用于诊断Kandev后端逻辑、运行实例及UI/浏览器故障。遵循分诊、取证、诊断流程，安全收集证据并定位根因，为后续修复提供依据。
用户报告意外行为或Bug
请求调查问题原因
需要添加日志或仪器以获取证据
npx skills add kdlbs/kandev --skill debug -g -y
用于在代码或行为变更影响 CLI、配置、API 及用户界面时，判断并更新公开文档。涵盖检查范围、更新流程及内部文档边界，确保文档与实现保持一致。
代码变更涉及 CLI 命令、配置键或 API 接口
需要评估新功能或修改是否需要更新公开文档
执行 PR 审查以确认文档同步状态
npx skills add kdlbs/kandev --skill docs-maintainer -g -y
指导使用 Playwright 和 TDD 模式编写及运行 Web E2E 测试，涵盖执行上下文、相关技能、目录结构及无头运行命令。
需要编写或运行端到端测试时
使用 Playwright 进行 Web 应用测试时
npx skills add kdlbs/kandev --skill e2e -g -y
用于诊断Bug、分析根因并制定修复计划的工作流。强调先复现问题、对齐需求与设计，生成可审查的修复方案和工单，再交由TDD实施，严禁未经规划直接修改代码。
用户报告系统存在缺陷或异常行为
需要修复已知Bug并遵循严格开发流程
npx skills add kdlbs/kandev --skill fix -g -y
将AI会话经验转化为持久化的开发规范，包括更新技能、代理、命令及跨平台配置文件，优化AI助手的工作流与行为约束。
用户要求记录会话经验或教训
需要更新或创建Agent技能文件
请求修改AGENTS.md等全局指令
进行跨AI平台的配置迁移
npx skills add kdlbs/kandev --skill harness-improvement -g -y
在需求或设计前澄清意图、检查假设，通过依赖顺序提问解决未决决策。用于大型不确定项目的压力测试和意图确认，避免盲目执行。
进行功能或修复规划前的假设检查
对大型不确定项目进行意图澄清和压力测试
npx skills add kdlbs/kandev --skill interview-me -g -y
将需求与系统设计转化为实施计划和工作订单，输出至docs/plans目录。通过映射变更、梳理边界和依赖关系，生成plan.md及任务文件，确保设计包在实现前经过审查，支持同步管理现有计划。
需要将已批准的需求和系统设计转化为具体的实施步骤
需要创建或更新docs/plans下的实施计划和工作订单文件
npx skills add kdlbs/kandev --skill plan -g -y
规范单会话编排流程，明确用户主导模型选择与阶段检查点。通过设计、执行和升级检查点管理任务委派，利用工作订单实现需求到交付的有序流转，确保高价值决策由强模型处理，机械工作用弱模型，提升开发可控性与效率。
多模型切换场景下的任务委派
复杂功能开发的计划与分解
需要用户确认的高风险架构或安全决策
npx skills add kdlbs/kandev --skill planner-orchestration -g -y
基于 Playwright CLI 的浏览器自动化工具，支持页面导航、元素交互（点击、输入、拖拽）、截图/PDF导出及状态管理。适用于 Web 自动化测试和网页操作场景。
需要自动化执行网页浏览或表单填写任务
进行 Web 页面的功能测试或回归测试
需要从网页获取截图或 PDF 文档
npx skills add kdlbs/kandev --skill playwright-cli -g -y
自动化处理 Pull Request 的 CI 检查失败和代码审查意见。包括等待 CI、修复有效错误、处置审查线程、解决合并冲突并推送更新，确保 PR 顺利合入。
用户请求修复 PR 的 CI 失败或审查意见
需要自动处理 GitHub PR 的状态和评论
npx skills add kdlbs/kandev --skill pr-fixup -g -y
生成PR可视化HTML说明文件，解释PR目的、用户影响、界面变更及兼容性风险。通过JSON数据驱动渲染，帮助审查者快速理解变更内容，非代码评审工具。
请求生成PR可视化 walkthrough
需要以视觉化方式解释PR变更
npx skills add kdlbs/kandev --skill pr-walkthrough -g -y
自动创建 Pull Request 并监控 CI 检查及代码审查反馈，支持 GitHub、GitLab 和 Azure Repos 多平台适配。
需要提交代码并创建 PR
需要修复 PR 中的审查意见或 CI 失败
npx skills add kdlbs/kandev --skill pr -g -y
为产品演示、截图和视频生成可复现的临时测试数据与环境，确保UI状态真实可信。通过隔离工作区和Mock服务构建场景，支持桌面与移动端路由验证，并在录制前进行排练，最终交付给视频捕获流程。
需要生成产品演示视频或截图
创建临时的演示数据环境
准备着陆页媒体素材
npx skills add kdlbs/kandev --skill product-demo-seeding -g -y
自动化生成 Kandev 产品演示视频、GIF 及截图。通过隔离数据录制高质量母版，支持多端适配与镜头控制，确保内容可逆与复用。
需要产品演示视频或 GIF
请求不同画幅或缩放效果
需要着陆页媒体素材
npx skills add kdlbs/kandev --skill product-video-capture -g -y
验证提交后安全推送分支到远程仓库，支持跨库 PR 场景及 --fixup 选项。
需要推送已验证的分支
执行 git push 操作
npx skills add kdlbs/kandev --skill push -g -y
用于在功能实现后进行对抗性验证，主动寻找边界值、错误路径和集成问题中的缺陷。通过理解意图、追踪连接、测试正常路径及尝试破坏系统来全面评估质量。
用户明确要求对抗性验证
需要 actionable PR/CI 发现
npx skills add kdlbs/kandev --skill qa -g -y
用于记录架构决策（ADR）并同步更新相关需求与系统设计。当涉及长期约束、公共契约或重大权衡时自动触发，确保文档一致性与可追溯性。
建立或变更长期边界、公共契约或所有权规则
显式请求记录架构决策说明(ADR)或规范
npx skills add kdlbs/kandev --skill record -g -y
描述 Kandev 项目的版本发布规范，涵盖 Stable SemVer 与 npm Nightly 渠道约定。指导维护者通过 CI 执行版本递增、构建多平台制品、发布 GitHub Release 及同步至 npm、Homebrew 和 Scoop，并说明 PR 规则集绕过与安全配置。
执行 Kandev 项目版本发布流程
查询或解释版本渠道（Stable/Nightly）命名规则
排查发布制品或通道同步问题
npx skills add kdlbs/kandev --skill release -g -y
提供运行时功能标志的全生命周期管理指南，涵盖添加、灰度发布、晋升和移除。确保前后端配置一致性，强制执行安全降级策略，防止未启用功能暴露，适用于涉及特性开关的开发任务。
需要添加新的功能标志或发布开关
执行功能标志的灰度发布或逐步推广
移除过期的功能标志或进行版本升级
npx skills add kdlbs/kandev --skill runtime-feature-flags -g -y
用于代码重构后对近期变更代码进行简化，包括内联一次性抽象、移除推测性代码、减少嵌套及提升可读性，仅在显式请求或PR审查时执行。
用户显式请求简化代码
PR审查中发现需要简化的问题
npx skills add kdlbs/kandev --skill simplify -g -y
规范驱动开发工作流，用于非平凡功能。涵盖意图澄清、需求、系统设计、计划与工单创建，并在获得明确授权后执行TDD实现及PR审查，确保设计资产持久化。
用户请求新功能或行为变更修复
需要进行系统设计与实施规划
npx skills add kdlbs/kandev --skill spec-driven-development -g -y
用于创建或更新Kandev产品需求与系统设计文档，明确可观测行为与技术路径。涵盖需求定义、系统架构设计及ADR记录，排除实施计划与Bug修复场景。
需要编写新的产品需求文档
需要制定或更新系统设计文档
记录具有重大意义的技术决策
npx skills add kdlbs/kandev --skill spec -g -y
指导使用TDD（红-绿-重构）流程进行代码变更，要求先写失败测试再实现生产代码。适用于Bug修复、新功能及重构，涵盖Go和TypeScript单元测试及E2E指引，排除纯UI组件测试。
需要为Bug修复编写复现测试
开发新功能或工具函数
重构缺乏测试的现有逻辑
npx skills add kdlbs/kandev --skill tdd -g -y
Kandev技能路由指南，提供任务到本地技能的映射表与操作规范。用于在会话开始时或用户询问时，根据具体工作流（如开发、调试、发布）选择并组合最合适的Agent技能，确保执行顺序和范围控制。
用户询问适用哪个技能
会话开始时选择技能
多阶段工作需要技能编排
npx skills add kdlbs/kandev --skill using-agent-skills -g -y
提供按需执行的全局本地验证审计技能，处理测试失败修复、CI/PR 问题排查及资源安全控制，确保代码提交前的质量与合规。
用户显式请求全面本地审计
PR 或 CI 检查发现需要进一步验证的问题
npx skills add kdlbs/kandev --skill verify -g -y
用于创建39种可视化图表（如架构图、流程图、UML等），支持生成自包含HTML/SVG/PNG，具备品牌定制、语义模式及无障碍设计能力。
需要生成架构或数据模型图
需要将绘图源文件重绘为HTML/SVG
npx skills add kdlbs/kandev --skill diagram-design -g -y
确保Kandev UI在移动端采用原生交互模式而非桌面端压缩适配，保持桌面与移动端的体验对等、响应式行为及Playwright E2E覆盖。适用于任何涉及前端或用户界面变更的规划、实现、审查和测试场景。
实施新的功能、页面、组件或工作流
进行UI设计审查或测试
修复涉及布局、触摸行为或视口的Bug
npx skills add kdlbs/kandev --skill mobile-parity -g -y
