Agent Skills
› kdlbs/kandev
kdlbs/kandev
GitHub用于调试和探测 ACP Agent CLI 的 Skill。通过执行 acpdbg 工具发起 JSON-RPC 会话，捕获原始帧数据至 JSONL 文件，支持探针、提示测试、矩阵对比及会话恢复等场景，帮助排查初始化失败或分析通信细节。
Install All Skills
npx skills add kdlbs/kandev --all -g -y
Skills in Collection (33)
用于调试和探测 ACP Agent CLI 的 Skill。通过执行 acpdbg 工具发起 JSON-RPC 会话，捕获原始帧数据至 JSONL 文件，支持探针、提示测试、矩阵对比及会话恢复等场景，帮助排查初始化失败或分析通信细节。
用户要求调试或探测 ACP Agent
需要查看原始 JSON-RPC 通信帧或 JSONL 文件
比较多个 Agent 能力或测试特定 Prompt
排查 Agent 无法初始化的问题
npx skills add kdlbs/kandev --skill acp-debug -g -y
指导如何添加新的第三方集成（如Jira/Linear），涵盖后端服务结构、前端Hook复用、健康轮询及Mock测试，确保遵循共享模式。
需要添加新的第三方服务集成
搭建外部服务对接模块
npx skills add kdlbs/kandev --skill add-integration -g -y
清理本地已删除的远程分支及其关联的git worktree。通过fetch prune识别[gone]状态，先移除worktree再强制删除分支，并输出清理报告，适用于合并PR后的仓库整理。
需要清理本地已不存在的远程分支
合并PR后维护仓库整洁
npx skills add kdlbs/kandev --skill clean-branches -g -y
用于在用户明确要求或PR/CI发现 actionable 问题时，对Go后端和Vite/React单体仓库的代码变更进行本地审查，检查质量、安全和架构合规性。
用户明确请求本地代码审查
PR或CI中发现需要人工介入的可行动问题
npx skills add kdlbs/kandev --skill code-review -g -y
指导 Agent 遵循 Conventional Commits 规范提交代码，包含类型定义、格式规则及钩子检查步骤。
用户要求提交更改
存在暂存文件需提交
推送 PR 前
npx skills add kdlbs/kandev --skill commit -g -y
用于在编码或调试前筛选并注入准确项目上下文，防止信息缺失或冗余。涵盖规则加载、源码定位、证据分析及信任分级，确保 Agent 获取正确输入以提升输出质量。
开始新会话
切换代码库区域
输出质量漂移
跨端任务协调
npx skills add kdlbs/kandev --skill context-engineering -g -y
用于创建、修改、调试、测试、打包或发布 Kandev 运行时插件。明确区分插件与宿主/SDK变更，指导从模板构建到验证发布的完整工作流，确保插件独立仓库管理。
用户请求创建新的 Kandev 插件
修复现有 Kandev 插件的 Bug
对 Kandev 插件进行代码重构或功能增强
打包并准备发布 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及UI术语等，遵循Diátaxis分类标准，确保文档准确性与一致性。
代码变更影响CLI命令或安装流程
变更涉及公开API或用户界面术语
需要新增或更新面向用户的文档页面
npx skills add kdlbs/kandev --skill docs-maintainer -g -y
基于 Playwright 和 TDD 模式编写及运行 Web 端到端测试。提供测试结构、执行命令（强制无头模式）、依赖安装指引及调试方法，确保前端功能覆盖与质量保障。
需要编写或运行 Web E2E 测试
使用 Playwright 进行前端自动化测试
npx skills add kdlbs/kandev --skill e2e -g -y
用于诊断Kandev缺陷，通过复现、归因和规格对齐制定修复计划与工作单，随后移交进行TDD实施。确保在修改代码前完成规划检查点。
需要修复软件缺陷或Bug
根据Issue报告进行根因分析并生成修复方案
npx skills add kdlbs/kandev --skill fix -g -y
用于将AI会话经验转化为持久化配置，包括更新技能、代理、命令及跨平台指令文件。通过规范化学习成果并选择合适载体，优化开发环境的行为引导与自动化流程。
用户要求记录会话经验或教训
请求创建或更新技能、代理、命令文件
需要适配不同AI平台的指令配置
npx skills add kdlbs/kandev --skill harness-improvement -g -y
在需求、设计或编码前澄清模糊意图。通过假设、提问和重述确认目标，避免猜测，确保实现前明确用户、成功标准和约束条件。
用户需求描述不完整或缺少关键背景
用户要求进行面试或压力测试
产品或架构假设缺失
npx skills add kdlbs/kandev --skill interview-me -g -y
将需求与系统设计转化为可执行的实施计划和工作订单，明确范围、技术路径及依赖关系。适用于规格确认后、编码前的规划阶段。
收到已批准的需求和系统设计文档
准备开始新功能或重构的实施工作
npx skills add kdlbs/kandev --skill plan -g -y
规范Kandev单会话模型工作流，通过设计、执行和升级检查点管理任务委派。明确用户控制模型选择，维护工作计划与工单状态，确保代码实现、测试及交付在统一会话中有序进行。
需要规划功能开发或修复任务时
涉及多阶段实施委托与工作流协调时
npx skills add kdlbs/kandev --skill planner-orchestration -g -y
Playwright CLI工具使用指南，提供浏览器自动化交互、页面测试及快照生成的命令行操作示例，涵盖核心交互、导航、键盘鼠标事件及状态管理。
需要自动化操作浏览器或网页元素
进行前端页面交互测试或截图
npx skills add kdlbs/kandev --skill playwright-cli -g -y
自动化处理PR流程，包括等待CI、解决合并冲突、修复失败的检查项、审查评论并推送代码。
用户请求处理Pull Request的后续步骤
需要自动修复CI失败或解决PR冲突
npx skills add kdlbs/kandev --skill pr-fixup -g -y
在代码提交并推送后，自动检测 Git 主机（GitHub/GitLab/Azure）并创建 Pull Request。支持草稿模式及后续修复流程，确保 PR 状态正确并持续监控 CI 检查与代码审查反馈。
用户要求创建 Pull Request
任务检查通过后需要发布代码
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
将已提交且通过检查的分支推送至远程仓库。支持处理 fork PR 场景下的安全校验与认证，并可通过 --fixup 选项自动衔接代码审查修复流程。
需要推送代码到远程仓库
执行 git push 操作
PR 分支同步
npx skills add kdlbs/kandev --skill push -g -y
执行对抗性验证，通过理解意图、追踪连接、测试正常路径及尝试破坏系统（边界值、错误路径等）来发现缺陷，并评估测试覆盖率。
用户明确要求对抗性验证
需要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触发、构建、发布及Token管理。
执行软件版本发布
配置或排查多渠道分发问题
询问版本命名规则
npx skills add kdlbs/kandev --skill release -g -y
管理Kandev运行时功能标志的添加、发布、推广或移除。涵盖后端与前端的多层配置同步、安全门禁设置及测试验证，确保功能开关的标准化生命周期管理。
需要新增或修改功能开关
进行灰度发布或全量推广
移除废弃的功能标志
处理紧急熔断开关
npx skills add kdlbs/kandev --skill runtime-feature-flags -g -y
对近期修改的代码进行简化重构，包括内联一次性抽象、移除推测性代码、减少嵌套及提升可读性。仅在显式请求或PR审查时执行，旨在保持行为不变的前提下优化代码质量。
用户显式请求运行 /simplify
PR审查中发现需要简化的问题
npx skills add kdlbs/kandev --skill simplify -g -y
规范驱动开发工作流，涵盖意图澄清、需求、系统设计、计划及工单创建，随后移交实施与验证。强调持久化文档和TDD实现，确保非平凡功能的严谨性。
用户请求非平凡功能或行为变更修复
需要创建需求、系统设计或实施计划时
npx skills add kdlbs/kandev --skill spec-driven-development -g -y
用于创建或更新Kandev产品的需求文档和系统设计文档，明确可观察行为与技术路径。适用于新功能、合同变更或显式规范工作，排除实施计划与重构场景。
需要编写产品需求规格
需要制定系统设计文档
定义新的系统边界或能力
npx skills add kdlbs/kandev --skill spec -g -y
指导开发者严格遵循测试驱动开发（TDD）的红绿重构流程。要求先写失败测试再实现代码，覆盖Bug修复、新功能及重构场景，并指定Go和TypeScript的单元测试范围与规范，跳过纯UI组件测试。
需要新增功能或修改代码
进行Bug修复
对缺乏测试的逻辑进行重构
npx skills add kdlbs/kandev --skill tdd -g -y
作为Kandev本地技能的路由地图，用于发现并选择适合当前任务的Agent技能。支持多阶段工作流编排、技能映射及组合使用，确保遵循最小覆盖集原则和既定工作流规范。
需要确定适用哪个Agent技能时
任务跨越多个阶段或需组合技能时
将上游技能映射到仓库现有技能时
npx skills add kdlbs/kandev --skill using-agent-skills -g -y
提供按需执行的本地全面验证审计技能，处理PR/CI修复、资源安全限制及失败重试，确保代码在推送前通过严格检查。
用户明确要求运行广泛本地审计
PR或CI发现需要修复验证
npx skills add kdlbs/kandev --skill verify -g -y
生成39种专业图表（如架构图、流程图等）为独立HTML/SVG，支持品牌定制与样式门控。
需要创建架构图或流程图
要求输出可编辑的HTML/SVG格式图表
npx skills add kdlbs/kandev --skill diagram-design -g -y
确保Kandev UI在移动端采用原生交互模式，而非桌面版压缩适配。适用于涉及前端或用户界面变更的任务，强制检查响应式行为、移动Playwright E2E覆盖及设计契约，保证桌面与移动端功能对等。
实现新功能页面或组件
修改现有UI布局或交互
修复影响移动端布局的Bug
添加前端行为至后端API工作
npx skills add kdlbs/kandev --skill mobile-parity -g -y
