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 文件。适用于检查模型能力、测试提示词、对比代理或排查初始化失败等场景。
用户要求探测或比较 Agent 能力
测试特定提示词对 Agent 的效果
检查原始 ACP 网络帧数据
调查 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分支及关联的工作树，保持仓库整洁。
需要清理本地废弃分支
合并PR后整理工作区
npx skills add kdlbs/kandev --skill clean-branches -g -y
用于审查代码质量、安全性和架构合规性。仅在用户明确要求或PR/CI发现 actionable 问题时触发，涵盖本地变更与PR审查流程。
用户显式请求本地代码审查
PR或CI存在需处理的具体问题
npx skills add kdlbs/kandev --skill code-review -g -y
规范 Git 提交操作，依据 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运行时插件。涵盖从模板构建、实现到验证和发布的完整生命周期，适用于修复现有插件bug或提交新插件至市场。
用户请求创建新的Kandev插件
需要修复或更新现有的Kandev插件代码
执行Kandev插件的测试与打包流程
npx skills add kdlbs/kandev --skill create-kandev-plugin -g -y
用于诊断Kandev后端逻辑、运行实例及UI/浏览器故障的调试技能。通过分类分流、安全收集证据和根因分析，为代码修复提供依据。
用户报告意外行为
请求调查问题
需要添加日志或插桩
实施修复前需根因证据
npx skills add kdlbs/kandev --skill debug -g -y
用于维护公开文档，判断代码变更是否影响用户可见内容并更新对应文档。覆盖CLI、API、配置等场景，规范文档路径与分类，确保文档与代码行为同步。
代码或行为变更影响CLI命令、配置键、API或用户界面术语
审查变更是否需要更新公开文档
npx skills add kdlbs/kandev --skill docs-maintainer -g -y
基于Playwright和TDD方法编写及运行Web端到端测试。涵盖测试结构、Fixture配置、页面对象模式及命令行执行规范，确保在隔离环境中进行自动化UI验证与调试。
需要编写或运行Web E2E测试
使用Playwright进行前端自动化验证
npx skills add kdlbs/kandev --skill e2e -g -y
诊断Kandev缺陷，通过复现、归因和需求对齐制定修复计划与工单，随后移交进行TDD实现。强调先规划后编码，确保修复符合系统设计与验收标准。
需要修复软件缺陷或Bug
分析并解决系统错误行为
npx skills add kdlbs/kandev --skill fix -g -y
将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 的浏览器自动化工具，支持页面导航、元素交互、截图及状态管理，适用于 Web 自动化测试与网页操作。
需要自动化执行浏览器操作
进行 Web 界面功能测试
抓取网页截图或 PDF
npx skills add kdlbs/kandev --skill playwright-cli -g -y
自动化处理PR流程，包括等待CI结果、解决合并冲突、修复失败的检查项及回应审查意见，最终提交并推送代码。
用户请求修复PR中的CI失败
需要处理PR合并冲突
响应PR审查评论
npx skills add kdlbs/kandev --skill pr-fixup -g -y
用于在代码提交并推送后，自动检测 Git 主机平台（GitHub/GitLab/Azure），创建 Pull Request 并监控 CI 检查与代码审查反馈，支持草稿模式及修复流程。
用户请求创建 PR
代码提交并推送到分支后
npx skills add kdlbs/kandev --skill pr -g -y
为产品演示生成可信且可丢弃的模拟数据场景，确保UI状态与当前代码一致。用于截图、视频录制前的环境准备，隔离真实数据，提供标准化测试用例和界面流程。
需要制作产品宣传视频或截图
创建可复现的UI演示环境
准备着陆页媒体素材
npx skills add kdlbs/kandev --skill product-demo-seeding -g -y
用于录制、处理、编码和验证 Kandev 产品演示视频及截图的自动化技能。通过 Playwright 和 FFmpeg 生成高质量主文件，支持桌面/移动端捕获、镜头运动模拟及着陆页循环视频，确保素材可复用且格式规范。
用户请求产品演示视频或 GIF
需要捕获桌面或移动设备界面
要求生成着陆页循环媒体或静态海报
需要对现有功能进行重新录制或调整构图
npx skills add kdlbs/kandev --skill product-video-capture -g -y
将已提交且通过检查的分支推送到远程仓库，支持处理 fork PR 场景及 --fixup 选项以继续 CI 和代码审查流程。
用户要求推送已提交的代码到远程
需要验证并推送特定分支
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/CD 构建、多平台分发及版本变更操作。
执行软件版本发布
配置或调试发布流水线
查询版本号与渠道映射规则
npx skills add kdlbs/kandev --skill release -g -y
提供运行时功能标志的添加、发布、推广及移除标准化流程，确保前后端配置一致性与安全回退。
添加新功能开关
灰度发布或全量推广
下线或退役旧功能标志
处理紧急故障转移开关
npx skills add kdlbs/kandev --skill runtime-feature-flags -g -y
对近期变更代码进行简化重构，内联一次性抽象、移除推测性代码、降低嵌套深度并提升可读性，仅在显式请求或PR审查时执行。
收到显式的 /simplify 指令
PR审查中发现需要简化的具体问题
npx skills add kdlbs/kandev --skill simplify -g -y
面向非 trivial 特性的规范驱动开发工作流，涵盖意图澄清、需求定义、系统设计、计划制定及 TDD 实现与 PR 审查，强调通过持久化工件和明确授权门控确保开发质量。
用户请求开发复杂功能或行为变更修复
需要创建或更新软件需求、系统设计和实施计划
npx skills add kdlbs/kandev --skill spec-driven-development -g -y
用于创建或更新Kandev产品的需求文档和系统设计，明确可观察行为与技术路径。适用于新功能、合同变更及规范工作，不适用于实施计划或重构。
需要编写产品需求规格
需要制定系统设计方案
定义新的功能边界或契约
npx skills add kdlbs/kandev --skill spec -g -y
指导基于测试驱动开发（TDD）的红绿重构流程，要求先写失败测试再实现代码。涵盖Go和TypeScript单元测试、集成测试及E2E测试的编写与执行规范，适用于Bug修复、新功能及重构场景。
需要为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
确保Kandev UI在移动端使用原生交互模式而非桌面适配，实现跨端体验一致性与Playwright E2E覆盖。适用于涉及前端UI规划、开发、审查及测试的场景。
实施新功能或页面组件
审查前端UI代码
测试用户界面响应式行为
修复布局或触摸相关Bug
npx skills add kdlbs/kandev --skill mobile-parity -g -y
