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
用户要求测试特定提示词对 agent 的效果
用户询问原始 ACP 网络帧结构
用户排查 agent 初始化或启动失败问题
npx skills add kdlbs/kandev --skill acp-debug -g -y
指导如何基于现有模式（如Jira/Linear）快速添加新的第三方服务集成，涵盖后端服务结构、前端组件复用及Mock测试配置。
需要添加新的第三方服务集成
搭建外部服务对接功能
npx skills add kdlbs/kandev --skill add-integration -g -y
清理本地已标记为[gone]的Git分支及其关联的worktree，适用于合并PR后的仓库整理。
需要清理本地过期分支
合并PR后维护仓库整洁
npx skills add kdlbs/kandev --skill clean-branches -g -y
用于代码质量、安全和架构合规性的本地审查。仅在用户明确要求或PR/CI发现问题时触发。支持本地变更和PR场景，要求提供文件行号引用、原因解释及具体修复方案，并关联测试逻辑验证。
用户明确要求代码审查
PR或CI发现 actionable 问题
npx skills add kdlbs/kandev --skill code-review -g -y
规范 Git 提交操作，依据 Conventional Commits 标准格式化提交信息，确保符合项目规范并支持自动化变更日志生成。
用户请求提交代码更改
存在已暂存的文件待提交
推送 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/浏览器故障的技能。通过分诊、收集证据和根因分析定位问题，为修复提供依据，确保生产环境安全。
报告意外行为
请求调查问题
需要添加日志或仪器化
修复前需根因证据
npx skills add kdlbs/kandev --skill debug -g -y
负责维护Kandev公开文档，根据代码变更判断并更新CLI、配置、API等用户可见内容，确保文档准确性与规范性。
代码变更影响CLI命令或配置键
需要审查变更是否涉及公开文档更新
新增或修改用户-facing的功能说明
npx skills add kdlbs/kandev --skill docs-maintainer -g -y
基于Playwright和TDD模式编写及运行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 会话中的经验教训转化为持久的开发工具链改进，包括技能、代理、命令及多平台配置文件。支持跨 Claude/Cursor 等环境迁移与标准化。
记录会话学习成果
更新或创建 Agent 技能
跨平台配置迁移
修改 AGENTS.md/CLAUDE.md
npx skills add kdlbs/kandev --skill harness-improvement -g -y
在需求不明确时通过假设、提问和复述澄清用户意图，避免盲目实现。适用于产品架构讨论前的规格确认阶段。
ask is underspecified
user says interview me
grill me
stress-test my thinking
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 页面功能测试
需要截取网页截图或生成 PDF
npx skills add kdlbs/kandev --skill playwright-cli -g -y
自动化处理PR的CI检查失败和Review评论，包括状态监控、冲突解决、代码修复及推送验证。
用户要求等待并修复PR的CI失败
用户要求根据Review评论进行代码修正
npx skills add kdlbs/kandev --skill pr-fixup -g -y
自动化在代码提交并推送后，根据目标平台（GitHub/GitLab/Azure）创建Pull Request。支持草稿模式，并集成CI检查与代码审查反馈的修复流程，确保PR状态就绪。
用户请求创建PR
任务检查通过后需要发布分支
npx skills add kdlbs/kandev --skill pr -g -y
为产品演示生成可复现的隔离环境数据，确保截图和视频基于最新代码构建，保障内容真实性和安全性。
需要录制产品演示视频
生成营销用截图
准备着陆页媒体素材
npx skills add kdlbs/kandev --skill product-demo-seeding -g -y
自动化生成产品演示视频、GIF及截图。通过Playwright录制桌面/移动端操作，结合FFmpeg编码与相机配置验证，确保素材可逆且高质量，适用于功能展示和落地页媒体制作。
需要产品演示视频或GIF
生成功能演示的静态截图
调整视频裁剪或节奏
制作着陆页循环媒体
npx skills add kdlbs/kandev --skill product-video-capture -g -y
用于将已验证通过的提交分支推送到远程仓库。支持检查未提交更改、任务检查结果及安全性，并处理无上游分支时的PR关联逻辑。可选--fixup参数以继续CI和代码审查流程。
用户要求推送已提交的代码到远程
完成代码修改后需要触发CI或审查流程
npx skills add kdlbs/kandev --skill push -g -y
用于在功能实现后进行对抗性验证，主动寻找边界值、错误路径和集成问题等缺陷。
用户明确要求对抗性验证
需要可操作的 PR/CI 发现
npx skills add kdlbs/kandev --skill qa -g -y
规范 Kandev 版本管理与发布流程，涵盖 Stable SemVer 及 npm Nightly 策略。支持多平台（npm、Homebrew、Scoop）发布，自动化 CI/CD 构建与分发，处理 PR 规则绕过及 Token 安全轮换。
执行软件版本发布
配置或调试多渠道分发流程
询问版本命名与渠道规则
npx skills add kdlbs/kandev --skill release -g -y
管理运行时功能标志的添加、发布、推广及移除。提供全栈（Go/TS）配置绑定、前端契约、测试及注册表管理的标准化检查清单，确保开关安全与一致性。
需要添加或修改功能标志
执行灰度发布或金丝雀部署
实现功能开关或紧急关闭机制
处理功能标志的生命周期管理
npx skills add kdlbs/kandev --skill runtime-feature-flags -g -y
对近期代码变更进行简化重构，包括内联一次性抽象、移除推测性代码、减少嵌套及提升可读性，仅在显式请求或PR审查时执行。
收到 /simplify 命令
PR审查中发现需要简化的代码
npx skills add kdlbs/kandev --skill simplify -g -y
规范驱动开发工作流，通过澄清意图、创建持久化规格说明、计划和任务文件，引导用户进行显式实施请求，随后执行顺序TDD实现、PR审查及报告，确保非平凡功能的严谨交付。
需要开发非平凡功能或行为变更修复
用户希望遵循结构化设计-实施流程
npx skills add kdlbs/kandev --skill spec-driven-development -g -y
用于在编码前编写产品功能规格说明，明确功能的‘做什么’和‘为什么’。确保需求无歧义，使新代理能仅凭文档实现或测试功能。排除缺陷修复、重构及基础设施变更等场景。
需要编写新功能的行为规格说明
从 /fix 命令创建行为修复规格
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技能组合。用于会话启动、技能选择及多阶段工作映射，确保遵循最小覆盖集和既定工作流规则。
用户询问适用哪个技能
开始新会话时
工作需要跨越多个阶段
需要将现有技能引用映射到仓库实际技能
npx skills add kdlbs/kandev --skill using-agent-skills -g -y
仅在用户显式请求或 PR/CI 修复需要时，执行广泛的本地验证审计。涵盖测试运行、失败修复及沙箱权限处理，确保代码质量与合规性。
用户显式请求全面本地审计
PR 或 CI 流程发现需要修复的问题
npx skills add kdlbs/kandev --skill verify -g -y
确保 UI 工作遵循原生移动端交互模式，而非桌面端压缩适配。在规划或修改涉及用户界面的新功能、组件或样式时强制运行，需同时设计桌面与移动端行为，并通过 Playwright E2E 测试验证移动端路径的一致性。
实现新的前端页面、组件或表单
修改现有 UI 布局、导航或视觉样式
修复影响触摸行为或视口宽度的 bug
进行涉及用户界面的代码审查
npx skills add kdlbs/kandev --skill mobile-parity -g -y
自动记录架构决策（ADR）并同步产品规格，确保长期约束与代码一致。在涉及持久边界、公共契约或重大权衡时触发，创建标准化文档并更新索引。
建立或变更长期架构边界
定义公共契约或数据所有权规则
用户明确要求记录决策或创建 ADR
npx skills add kdlbs/kandev --skill record -g -y
