Agent Skills
› kdlbs/kandev
kdlbs/kandev
GitHub用于调试 ACP agent CLI，通过启动进程、发送 JSON-RPC 并捕获帧至 JSONL 文件。适用于探测代理能力、对比代理、测试提示词、检查原始数据帧或排查初始化失败等场景。
Install All Skills
npx skills add kdlbs/kandev --all -g -y
Skills in Collection (32)
用于调试 ACP agent CLI，通过启动进程、发送 JSON-RPC 并捕获帧至 JSONL 文件。适用于探测代理能力、对比代理、测试提示词、检查原始数据帧或排查初始化失败等场景。
探测代理模型或能力
对比多个代理
测试提示词对代理的效果
检查原始 ACP 数据帧
排查代理初始化失败
npx skills add kdlbs/kandev --skill acp-debug -g -y
指导如何添加新的第三方集成（如Jira/Linear），涵盖后端服务结构、健康轮询、前端钩子及UI组件复用，支持Mock测试与E2E验证。
需要接入新的第三方外部服务
实现类似Jira或Linear的集成模块
npx skills add kdlbs/kandev --skill add-integration -g -y
清理本地已合并或远程删除的 Git 分支，包括关联的工作树。通过 fetch --prune 同步状态，识别并移除 [gone] 标记的分支及其 worktree，保持仓库整洁。
PR 合并后需要清理本地分支
远程分支已删除但本地仍残留
需要批量删除标记为 [gone] 的分支
npx skills add kdlbs/kandev --skill clean-branches -g -y
用于审查代码质量、安全性和架构合规性。仅在用户明确要求或PR发现需要时触发，针对Go后端和Vite/React单体仓库进行变更分析，提供具体修复建议。
用户显式请求本地代码审查
PR流程中检测到需要人工介入的审查项
npx skills add kdlbs/kandev --skill code-review -g -y
指导 Agent 使用 Conventional Commits 规范进行代码暂存和提交，确保符合项目格式要求及 CI 校验。
用户发出 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
用于判断公共文档是否需要更新并执行维护的 Skill。涵盖 CLI、配置、API 及 UI 等变更，规范文档目录结构、更新流程及 Diátaxis 内容分类标准。
代码变更影响 CLI、配置或 API 时
审查变更是否需更新公共文档时
npx skills add kdlbs/kandev --skill docs-maintainer -g -y
基于 TDD 模式编写和运行 Web E2E 测试（Playwright），涵盖测试结构、执行命令及调试流程，支持无头模式与隔离环境。
需要编写或运行端到端测试
使用 Playwright 进行 UI 自动化验证
npx skills add kdlbs/kandev --skill e2e -g -y
系统化缺陷修复技能，遵循证据收集、根因分析、规范修订、计划制定及TDD实现的严谨流程。旨在通过可审查的工件和明确的阶段检查点，确保修复质量与回归测试覆盖，避免盲目修改代码。
诊断并修复软件缺陷
处理Issue Tracker中的Bug报告
执行基于TDD的代码修正
npx skills add kdlbs/kandev --skill fix -g -y
将AI会话经验转化为持久化的开发环境配置，包括更新技能、代理、命令及跨平台指令文件。
用户要求记录会话经验或最佳实践
请求创建或更新SKILL.md等Agent配置文件
需要跨平台迁移或同步AI工具配置
npx skills add kdlbs/kandev --skill harness-improvement -g -y
在需求模糊时通过假设、提问和复述澄清用户意图，避免盲目实施。适用于缺乏明确目标或约束的场景。
用户要求“interview me”或“grill me”
需求描述缺失关键背景、成功标准或边界
npx skills add kdlbs/kandev --skill interview-me -g -y
将功能规格转化为分阶段实施计划，探索代码库并生成结构化的 plan.md 及独立任务文件，用于指导后续开发实现。
需要制定新功能实施计划时
根据已有功能规格设计技术方案时
npx skills add kdlbs/kandev --skill plan -g -y
规范Kandev单会话工作流，通过模型检查点和任务文件实现用户主导的规划、执行与交付。确保设计、实施及升级阶段由用户控制模型切换，维持上下文连贯性。
需要规划功能开发或修复任务时
涉及多模型切换的复杂实现流程
npx skills add kdlbs/kandev --skill planner-orchestration -g -y
基于 Playwright CLI 的浏览器自动化工具，支持页面导航、元素交互、截图及状态管理。用于 Web 自动化测试与网页操作。
需要自动化执行浏览器操作
进行 Web 页面功能测试
npx skills add kdlbs/kandev --skill playwright-cli -g -y
自动化监控PR的CI状态和代码审查意见，处理合并冲突，修复失败的检查项及有效评论，验证后推送更新。
用户要求等待并修复PR的CI失败或审查评论
需要自动处理PR合并冲突
npx skills add kdlbs/kandev --skill pr-fixup -g -y
自动化创建代码审查请求，支持 GitHub、GitLab 和 Azure Repos。包含分支检查、推送及后续修复流程，旨在简化版本发布前的 PR 提交流程。
用户需要提交代码变更并创建 Pull Request
任务完成后自动触发 PR 创建与监控
npx skills add kdlbs/kandev --skill pr -g -y
为产品演示视频和截图生成可复现、隔离的虚假数据场景，确保UI状态真实且与当前主分支一致，严格隔离开发环境。
需要录制产品演示视频
需要生成营销用截图或媒体素材
需要创建可复现的UI捕获场景
npx skills add kdlbs/kandev --skill product-demo-seeding -g -y
用于生成 Kandev 产品演示视频、GIF 及截图的自动化技能。通过种子数据准备、Playwright 录制和 FFmpeg 处理，确保高质量交付。
请求产品演示视频
需要 GIF 动图
请求不同景别或帧率的产品展示
npx skills add kdlbs/kandev --skill product-video-capture -g -y
将已验证提交的分支推送到远程仓库。支持自动检查提交状态、任务检查结果及分支安全性，并可通过--fixup参数衔接PR修复流程，确保推送操作的安全与规范。
需要推送已验证的Git分支到远程
执行完代码修改和测试后需要发布变更
在PR工作流中完成修复后重新推送
npx skills add kdlbs/kandev --skill push -g -y
执行对抗性验证，主动寻找功能实现中的缺陷。涵盖意图理解、链路追踪、正常路径测试及边界/错误/并发等破坏性测试，并检查测试覆盖率，最终输出评估报告。
用户明确要求对抗性验证
需要 actionable PR/CI 发现时
npx skills add kdlbs/kandev --skill qa -g -y
定义Kandev版本规范与发布流程，涵盖Stable SemVer及npm Nightly渠道。指导维护者通过CI执行版本递增、构建、发布至GitHub/npm/Homebrew及调试制品。
执行软件版本发布
配置或修改发布渠道
排查发布制品问题
咨询版本命名规则
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
用于编写功能规格说明书（Spec），明确产品功能的“做什么”与“为什么”，在编码前确立可测试的行为定义。适用于新功能开发或修复前的行为规范制定，排除重构、事故复盘及基础设施工作。
需要编写新功能的功能规格说明
通过 /fix 命令创建或修订行为修复规范
npx skills add kdlbs/kandev --skill spec -g -y
指导使用测试驱动开发（红绿重构）流程进行代码变更，确保先写失败测试再实现功能。适用于Bug修复、新功能及重构，涵盖Go/TS单元测试及E2E集成规范。
需要添加测试覆盖的代码修改
Bug修复需先复现问题
重构缺乏测试的逻辑
npx skills add kdlbs/kandev --skill tdd -g -y
作为Kandev本地技能的路由地图，用于发现并选择适合特定任务的Agent技能。当需要澄清意图、开始新会话或工作涉及多阶段时触发，指导用户优先使用仓库现有技能而非上游名称。
用户询问适用哪个技能
任务开始时选择技能
工作跨越多个阶段
npx skills add kdlbs/kandev --skill using-agent-skills -g -y
提供本地全面验证审计能力，支持按PR范围或全量模式运行测试。处理CI/CD修复、沙箱权限不足及验证失败场景，确保代码在推送前通过质量检查。
用户显式请求全面本地审计
PR或CI流程需要修复验证问题
npx skills add kdlbs/kandev --skill verify -g -y
确保UI变更兼顾移动端原生交互与桌面端能力对等，涵盖设计规划、代码审查及Playwright E2E测试，防止仅依赖响应式CSS。
实现或计划新功能/页面/组件
进行UI相关的代码审查
测试涉及布局、触摸行为或视口的功能
npx skills add kdlbs/kandev --skill mobile-parity -g -y
记录架构决策并同步产品规格。在建立持久边界或契约时自动触发，创建ADR文档以记录上下文、决策及权衡，并更新相关规格说明，确保长期决策与实现一致。
建立或变更持久架构边界
定义公共契约或数据所有权规则
用户明确请求记录决策或创建ADR
npx skills add kdlbs/kandev --skill record -g -y
