Agent Skills
› kdlbs/kandev
kdlbs/kandev
GitHub用于调试 ACP agent CLI，通过 JSON-RPC 会话捕获原始数据帧至 JSONL 文件。适用于探测 Agent 能力、对比模型、测试 Prompt 或排查初始化失败等场景。
安装全部 Skills
npx skills add kdlbs/kandev --all -g -y
集合内 Skills (32)
用于调试 ACP agent CLI，通过 JSON-RPC 会话捕获原始数据帧至 JSONL 文件。适用于探测 Agent 能力、对比模型、测试 Prompt 或排查初始化失败等场景。
用户要求探测 Agent 能力或对比不同 Agent
用户希望测试特定 Prompt 对 Agent 的效果
用户需要检查原始 ACP 网络帧或排查启动故障
npx skills add kdlbs/kandev --skill acp-debug -g -y
指导如何基于现有模式快速搭建新的第三方集成（如Jira/Linear），涵盖后端服务、前端UI组件及Mock测试的标准化实现。
需要添加新的第三方服务集成
参考Jira或Linear集成模式
npx skills add kdlbs/kandev --skill add-integration -g -y
自动清理本地已无远程对应的废弃 Git 分支及其关联的工作树。通过 fetch prune 识别 [gone] 状态，优先删除工作树再强制删除分支，并输出清理报告，适用于 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
规范 Git 提交，遵循 Conventional Commits 标准。用于暂存并创建符合规范的提交信息，支持自动生成变更日志，确保 PR 标题合规及 CI 验证通过。
用户明确请求提交代码
存在已暂存的修改文件
推送 PR 前的检查阶段
npx skills add kdlbs/kandev --skill commit -g -y
规范在编码或调试前收集项目上下文的方法，确保信息准确且适量。包含上下文优先级、Kandev加载清单、选择性模式及信任等级，防止API虚构并提升代码质量。
开始新会话
切换代码区域
输出质量下降
跨前后端任务
协调外部指令
npx skills add kdlbs/kandev --skill context-engineering -g -y
用于在独立仓库中创建、修改、调试、测试、打包或发布 Kandev 运行时插件的完整工作流，涵盖从模板初始化到市场发布的生命周期管理。
用户请求创建新的 Kandev 插件
修复现有 Kandev 插件的 Bug
对 Kandev 插件进行代码重构或功能迭代
执行 Kandev 插件的打包与发布操作
npx skills add kdlbs/kandev --skill create-kandev-plugin -g -y
用于诊断Kandev应用中的Bug、运行时问题及UI故障。通过分诊、证据收集与根因分析定位问题，必要时移交修复任务，确保生产环境安全。
用户报告意外行为或Bug
需要调查系统异常
请求添加日志或监控以获取证据
npx skills add kdlbs/kandev --skill debug -g -y
用于判断代码变更是否影响公开文档，并负责在docs/public目录下更新CLI、配置、API等用户可见内容的技能。
代码变更涉及CLI命令、配置键或安装流程
发布前检查文档一致性
新增面向用户的公开页面
npx skills add kdlbs/kandev --skill docs-maintainer -g -y
基于 Playwright 和 TDD 模式编写及运行 Web 端到端测试。提供测试结构、命令执行（如 make test-e2e）及调试指南，支持在对话中直接创建和验证 E2E 覆盖用例。
需要编写或运行 Web E2E 测试
使用 Playwright 进行前端自动化测试
遵循 TDD 流程进行端到端功能验证
npx skills add kdlbs/kandev --skill e2e -g -y
用于诊断Kandev缺陷，通过复现证据、分析根因并核对需求与设计文档，生成可审查的修复计划和工作订单。强调在实施前完成规划，支持TDD实现与PR审查，确保修复符合规范且可追溯。
用户报告系统Bug或错误行为
需要修复已知缺陷并遵循严格开发流程
npx skills add kdlbs/kandev --skill fix -g -y
将AI会话经验转化为持久化的开发环境配置，包括技能、代理、命令及跨平台指令文件。
用户要求记录学习心得或更新技能
需要创建或适配Agent/Command配置
跨平台工具（如Claude/Cursor）的迁移与优化
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 页面功能测试
前端 UI 交互调试
npx skills add kdlbs/kandev --skill playwright-cli -g -y
自动化处理PR的CI失败与Review意见。流程包括获取PR状态、解决合并冲突、修复CI检查、分类并回应评论，最终提交推送并验证结果，确保PR顺利合入。
用户要求等待或监控PR更新
PR出现CI检查失败需要修复
PR有Review评论需要处理
npx skills add kdlbs/kandev --skill pr-fixup -g -y
自动创建代码合并请求，支持 GitHub、GitLab 和 Azure Repos。包含提交检查、推送及后续修复流程，支持草稿模式，确保 PR 就绪后持续监控并处理 CI 和审查反馈。
需要创建 Pull Request
提交代码后发起合并请求
npx skills add kdlbs/kandev --skill pr -g -y
为产品演示生成可复现的隔离测试环境，确保使用最新代码构建纯净状态，填充模拟数据以支持截图和视频录制。
准备产品宣传素材
录制产品演示视频
需要干净的演示环境
npx skills add kdlbs/kandev --skill product-demo-seeding -g -y
用于录制、处理并验证 Kandev 产品演示视频、GIF 及截图。通过种子数据隔离环境，使用 Playwright 和 FFmpeg 捕获高分辨率主文件，支持多端适配与镜头配置调整，确保素材可复用且流程可控。
用户请求生成产品展示视频或功能演示
需要制作着陆页循环动画或静态截图
要求从不同视角或缩放比例重新录制产品界面
npx skills add kdlbs/kandev --skill product-video-capture -g -y
将已验证的提交分支推送到远程仓库。执行前检查未提交更改、任务定义的检查是否通过，并验证当前分支非主分支以防止误推。支持处理无上游分支的 Fork PR 场景及跨库推送的安全认证逻辑。
用户要求推送已提交的代码分支
完成代码修改后需要更新远程仓库
npx skills add kdlbs/kandev --skill push -g -y
用于在功能实现后执行对抗性验证，主动寻找边界值、错误路径及集成断点等缺陷。通过理解意图、追踪连接、测试正常路径及尝试破坏系统来发现潜在问题，并评估测试覆盖率，最终输出质量报告。
用户明确要求对抗性验证
需要针对PR或CI的可操作发现
npx skills add kdlbs/kandev --skill qa -g -y
用于记录架构决策（ADR）并同步更新相关需求与系统设计，确保长期约束、边界和契约的一致性。在建立或变更重要系统约定时自动触发，涵盖从创建 ADR 到验证规范同步的完整流程。
需要记录具有持久影响的架构决策
变更了系统边界、公共契约或所有权规则
显式请求创建 ADR 或记录规格说明
npx skills add kdlbs/kandev --skill record -g -y
说明 Kandev 的发布与版本管理规范，涵盖 Stable SemVer 及 npm Nightly 策略。指导维护者通过 CI/CD 执行版本升级、构建多平台制品并发布至 GitHub、npm、Homebrew 和 Scoop，同时包含安全令牌管理规则。
执行软件版本发布
配置或调试 CI/CD 发布流程
查询版本通道规范
管理发布相关的安全令牌
npx skills add kdlbs/kandev --skill release -g -y
管理Kandev运行时特性标志的生命周期，涵盖添加、灰度发布、提升或移除。确保前后端配置一致性，遵循后端权威原则及Fail-Closed安全规范，防止未授权访问。
需要添加新的特性开关
进行特性的灰度发布或全量推广
移除废弃的特性标志
处理Kill Switch场景
npx skills add kdlbs/kandev --skill runtime-feature-flags -g -y
对最近修改的代码进行简化重构，包括行内化一次性抽象、移除推测性代码、降低嵌套层级及提升可读性，旨在优化代码清晰度与可维护性。
显式请求简化
PR审查中需要修复的可操作发现
npx skills add kdlbs/kandev --skill simplify -g -y
规范驱动开发工作流，通过意图澄清、需求定义、系统设计、计划制定及TDD实施，确保复杂功能的严谨交付。
非平凡功能开发
行为变更修复
npx skills add kdlbs/kandev --skill spec-driven-development -g -y
用于创建或更新产品需求与系统设计文档，明确可观测行为与技术路径。适用于新功能、合同变更及规范工作，通过路由规则定位所属系统并遵循特定模板撰写，确保需求清晰且可追溯。
需要编写新的产品需求文档
需要创建或更新系统设计文档
涉及新功能的规格定义
合同或接口行为的变更说明
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
用于在用户显式请求或PR/CI修复时执行广泛的本地验证审计。支持全量或变更范围模式，处理长运行检查重试、失败修复及沙箱权限问题，确保提交前的代码质量与合规性。
用户显式要求进行全面本地审计
PR或CI流程中发现需要验证的问题
npx skills add kdlbs/kandev --skill verify -g -y
确保 Kandev UI 在移动端使用原生交互模式而非桌面适配，实现响应式设计与 Playwright E2E 测试覆盖。适用于涉及前端或用户界面变更的任务，强制检查布局、触摸行为及视口表现，保障多端体验一致性与质量。
实施新功能或页面组件
审查 UI 变更设计
测试前端用户界面
修复布局或触摸相关 Bug
npx skills add kdlbs/kandev --skill mobile-parity -g -y
