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 (35)
用于调试和探测 ACP Agent CLI，通过启动会话、发送 JSON-RPC 请求并捕获原始数据帧到 JSONL 文件，支持探针测试、提示词评估、会话恢复及故障排查。
用户询问代理能力或模型列表
需要对比多个 Agent 性能
测试特定 Prompt 对 Agent 的效果
检查 ACP 原始通信帧数据
调查 Agent 初始化失败原因
npx skills add kdlbs/kandev --skill acp-debug -g -y
指导如何添加第三方集成（如Jira/Linear），涵盖后端服务结构、健康轮询、前端Hooks及Mock测试，强调复用共享组件与模式。
需要添加新的第三方服务集成
创建外部服务对接功能
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 在编码或调试前收集恰当的项目上下文，避免信息过载或不足。涵盖规则、规范、源码及错误证据的优先级，确保开发流程符合 Kandev 约定。
开始新会话
切换代码区域
输出质量下降
跨后端/前端/文档任务
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环境中的Bug、运行实例异常及UI/浏览器故障。通过分类分流、安全收集证据并定位根因，为后续修复提供依据。
用户报告意外行为
请求调查问题原因
需要添加日志或插桩
实施修复前需获取根因证据
npx skills add kdlbs/kandev --skill debug -g -y
用于维护公开文档，确保代码或行为变更时 CLI、配置、API 及截图等用户可见内容同步更新。判断文档影响范围并执行相应编辑。
代码变更涉及 CLI 命令、配置键或公共 API
UI 标签、截图或安装部署流程发生变化
审查变更是否需要同步更新公开文档
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
用于诊断Bug、复现问题、审查需求与设计，制定修复计划和工作订单，并指导TDD实施。强调先规划后编码，确保修复符合规范。
需要诊断和修复软件缺陷
需要为Bug制定详细的修复方案和工作分解
npx skills add kdlbs/kandev --skill fix -g -y
将 AI 会话中的经验教训转化为持久的开发环境配置，包括技能、代理、命令及跨平台指令文件。支持记录学习、更新指南或适配不同 IDE 的 harness 文件。
用户要求记录会话经验教训
需要创建或更新技能/代理/命令
请求跨平台迁移或适配 AGENTS.md/CLAUDE.md
npx skills add kdlbs/kandev --skill harness-improvement -g -y
在需求或设计规划前进行假设检查与意图澄清。通过识别已确认、已验证及未决事项，按依赖顺序向用户提问以消除不确定性，确保关键决策明确后再推进开发。
开始功能或修复方案规划前
需求或系统设计存在重大不确定性时
需要澄清核心业务逻辑或技术选型意图时
npx skills add kdlbs/kandev --skill interview-me -g -y
将需求与系统设计转化为实施计划和工作订单，生成docs/plans目录下的plan.md及任务文件。通过映射变更、明确范围与技术路径，输出可执行的交付方案供审查。
需要将需求分解为具体实施步骤
创建项目或功能的交付计划
根据系统设计文档生成工作订单
npx skills add kdlbs/kandev --skill plan -g -y
规范Kandev平台单会话模型工作流，通过设计、执行和升级检查点管理任务委派。强制用户控制模型切换，维护工作计划与工作订单状态，确保多阶段开发过程的连贯性与可追溯性。
需要规划功能实现或修复流程时
在多模型间切换需保持上下文连贯时
执行TDD或代码审查等开发任务前
npx skills add kdlbs/kandev --skill planner-orchestration -g -y
提供 Playwright CLI 工具的使用指南，涵盖浏览器自动化、页面交互、截图及状态管理等命令，用于测试网页或执行 Web 操作。
需要自动化浏览网页
进行前端页面测试
使用 Playwright 命令行工具
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
生成PR可视化HTML说明文件，解释PR目的、用户影响及兼容性风险。专注于快速理解变更而非代码审查。
请求生成PR可视化 walkthrough
需要直观展示PR变更细节
npx skills add kdlbs/kandev --skill pr-walkthrough -g -y
在提交并推送分支后，根据检查通过情况自动创建 Pull Request。支持 GitHub、GitLab 和 Azure Repos，可处理草稿或就绪状态，并通过 /pr-fixup 持续监控 CI 和代码审查反馈以进行修复。
用户请求创建 PR
任务完成后的自动化发布流程
npx skills add kdlbs/kandev --skill pr -g -y
为产品演示生成可复现的隔离数据环境，确保截图和视频录制使用最新代码和可信状态，支持桌面与移动端场景，严格隔离生产数据。
需要拍摄产品演示视频或截图
生成着陆页媒体素材
创建可复现的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
用于将已提交并通过检查的分支推送到远程仓库。支持在PR上下文中安全推送，包含变更检测、任务检查验证及跨仓库权限处理，可选--fixup继续CI和Review流程。
用户要求推送代码到远程
完成代码修改后需要提交并推送
npx skills add kdlbs/kandev --skill push -g -y
用于在功能实现后进行对抗性验证，主动寻找缺陷。涵盖理解意图、追踪链路、测试正常路径及尝试破坏（边界值、错误路径等），旨在发现断连代码和潜在Bug，而非确认功能可用。
用户明确要求对抗性验证
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 执行版本递增、构建、发布及通知贡献者等任务。
执行软件版本发布
配置或修改发布渠道
排查发布制品问题
询问版本与渠道规则
npx skills add kdlbs/kandev --skill release -g -y
用于执行会话回顾，分析当前会话中的教训、失败尝试及成功技巧，并据此提出具体的共享规则编辑建议以提升未来效率。
用户运行 /retro 命令
用户明确要求回顾
npx skills add kdlbs/kandev --skill retro -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
用于创建或更新产品需求与系统设计文档的规范，指导如何路由请求、定位归属系统及遵循模板，适用于新行为定义、合同变更等场景。
需要编写新产品需求
需要更新系统设计方案
涉及明确的规格说明工作
npx skills add kdlbs/kandev --skill spec -g -y
指导基于测试驱动开发（TDD）进行代码变更，遵循红绿重构流程。适用于新增功能、重构及修复Bug，强调先写失败测试再生成代码，并规范测试范围与断言逻辑。
需要增加代码覆盖率时
执行代码重构且缺乏测试时
修复Bug需先编写复现测试时
npx skills add kdlbs/kandev --skill tdd -g -y
Kandev本地技能路由地图，用于根据任务类型匹配并选择最合适的Agent技能，支持多技能组合与执行顺序规划。
用户询问适用哪个技能
工作涉及多个阶段或需映射技能
会话开始时进行技能发现
npx skills add kdlbs/kandev --skill using-agent-skills -g -y
提供/opt-in本地全面验证审计技能，用于用户明确要求或PR/CI修复时。涵盖执行流程、失败修复、资源安全及影响范围判定，确保代码质量与合规交付。
用户显式请求广泛本地审计
PR或CI发现需要验证
npx skills add kdlbs/kandev --skill verify -g -y
用于生成39种专业架构图、流程图及数据可视化图表，支持自定义品牌风格并输出独立HTML/SVG/PNG文件。
需要创建架构或流程图
要求定制化品牌视觉风格
npx skills add kdlbs/kandev --skill diagram-design -g -y
确保UI实现遵循原生移动端交互模式，而非桌面端压缩适配。在规划、开发、审查或测试涉及前端及用户界面变更时强制运行，保障桌面与移动端的体验一致性及Playwright E2E覆盖。
实现新的功能、页面或组件
进行UI代码审查
测试前端或用户界面变更
npx skills add kdlbs/kandev --skill mobile-parity -g -y
