Agent Skills
› kdlbs/kandev
kdlbs/kandev
GitHub用于调试 ACP Agent CLI，通过 JSON-RPC 交互并录制帧到 JSONL。适用于探测 Agent 能力、比较模型、测试 Prompt、检查原始协议数据或排查初始化失败等问题。
Install All Skills
npx skills add kdlbs/kandev --all -g -y
Skills in Collection (35)
用于调试 ACP Agent CLI，通过 JSON-RPC 交互并录制帧到 JSONL。适用于探测 Agent 能力、比较模型、测试 Prompt、检查原始协议数据或排查初始化失败等问题。
用户询问如何探测或调试 ACP Agent
需要比较不同 Agent 的能力
测试特定 Prompt 对 Agent 的效果
检查 ACP 原始 wire 帧数据
调查 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
自动清理本地已删除的远程分支及其关联的工作树。通过fetch prune识别[gone]状态，优先移除工作树再强制删除分支，提升仓库整洁度。
清理本地已合并或远程删除的分支
整理包含工作树的Git仓库
npx skills add kdlbs/kandev --skill clean-branches -g -y
用于在用户明确要求或PR/CI发现 actionable 问题时，对Go后端和Vite/React前端代码进行本地审查。涵盖质量、安全及架构合规性检查，要求提供具体文件行号引用、问题解释及修复建议，并支持本地变更与PR分支的差异化分析。
用户明确要求审查代码
PR或CI发现需要人工介入的问题
npx skills add kdlbs/kandev --skill code-review -g -y
指导如何按照 Conventional Commits 规范进行代码暂存与提交，包含类型定义、格式规则及钩子检查步骤。
用户要求提交代码
存在待提交的变更文件
推送 PR 前
npx skills add kdlbs/kandev --skill commit -g -y
指导Agent在编码或调试前精准收集项目上下文，避免信息缺失或冗余。涵盖规则、规范、源码及证据的优先级，确保开发流程符合Kandev约定。
开始新会话
切换代码区域
输出质量漂移
跨后端/前端/文档任务
外部指令与规范冲突
npx skills add kdlbs/kandev --skill context-engineering -g -y
用于创建、修改、调试、测试、打包或发布 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
用于维护公共文档的准确性与时效性，当代码变更影响 CLI、配置、API 或用户界面时，自动判断并更新 docs/public 等目录下的文档。
代码变更影响 CLI 命令、配置键或 API
需要审查变更是否涉及公共文档更新
npx skills add kdlbs/kandev --skill docs-maintainer -g -y
基于 Playwright 和 TDD 模式编写及运行 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会话中的经验教训转化为持久的开发环境配置，包括技能、智能体、命令及跨平台指令文件的更新与维护。
记录会话学习成果
更新或创建技能与智能体
修改AGENTS.md/CLAUDE.md等指导文件
适配不同AI平台的配置文件
npx skills add kdlbs/kandev --skill harness-improvement -g -y
在需求或设计前澄清意图、检查假设，通过压力测试识别未决决策，确保方案可行性。
进行功能规划前的意图澄清
系统设计方案前的假设验证
大型不确定项目的风险压力测试
npx skills add kdlbs/kandev --skill interview-me -g -y
将需求与系统设计转化为实施计划和工作订单，生成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端自动化测试、UI调试及前端功能验证。
需要自动化执行浏览器操作
进行Web页面功能测试或回归测试
需要捕获页面截图或PDF以辅助调试
npx skills add kdlbs/kandev --skill playwright-cli -g -y
自动化处理PR的CI状态与代码审查。包括等待CI、解决冲突、修复失败检查项、处置审查意见并推送，确保PR合规合并。
用户请求处理Pull Request的CI或审查反馈
需要自动修复PR中的CI失败或响应审查评论
npx skills add kdlbs/kandev --skill pr-fixup -g -y
生成PR单文件HTML可视化导览，解释目的、用户影响及实现细节。非代码审查，不输出评审结论。通过JSON数据驱动渲染器构建页面，聚焦问题、结果与兼容性影响，辅助快速理解变更。
需要生成PR的可视化导览
请求以视觉方式解释PR内容
npx skills add kdlbs/kandev --skill pr-walkthrough -g -y
在代码提交并推送后，自动检测 Git 平台（GitHub/GitLab/Azure）并创建 Pull Request。支持草稿模式，并通过 /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 产品演示视频及截图的技能。通过前置种子生成隔离数据，利用 Playwright 和 FFmpeg 捕获桌面/移动端高清母版，并支持重新构图与格式转换，确保可逆性与交付质量。
用户请求制作产品展示视频或功能演示
需要生成着陆页循环媒体或静态截图
要求调整视频帧率、缩放或画幅比例
进行产品界面的录屏与重新捕获
npx skills add kdlbs/kandev --skill product-video-capture -g -y
用于将已验证的提交推送到远程仓库。包含检查未提交更改、任务检查结果及分支安全（非主分支），支持通过 gh CLI 处理跨库 PR 推送，并提供 --fixup 选项以继续 CI 和代码审查流程。
用户希望将本地提交的代码推送到远程仓库
需要处理跨库 Fork 的 PR 推送场景
npx skills add kdlbs/kandev --skill push -g -y
用于在功能实现后进行对抗性验证，主动寻找边界值、错误路径及集成断点等缺陷。通过理解意图、追踪连接、测试正常路径和尝试破坏系统来发现潜在问题并报告结果。
用户明确要求对抗性验证
需要查找可操作的 PR 或 CI 发现问题
npx skills add kdlbs/kandev --skill qa -g -y
用于记录架构决策（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
用于执行会话回顾，分析当前或指定会话中的经验教训与失败原因，筛选出可复用的改进建议，并提议对共享指南进行具体编辑以提升未来Agent效率。
用户运行/retro命令
用户明确要求回顾会话
npx skills add kdlbs/kandev --skill retro -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
用于创建或更新产品需求和系统设计文档的规范。指导如何定位系统、路由工件及遵循模板，明确区分需求与设计的边界，适用于新功能、合同变更等规格制定工作。
创建新产品需求文档
更新现有系统设计方案
定义新的能力边界
npx skills add kdlbs/kandev --skill spec -g -y
指导开发者严格遵循测试驱动开发（TDD）的红-绿-重构流程。规定先写失败测试再实现代码，涵盖单元测试与E2E测试规范，明确Go和TypeScript的测试执行方式及适用场景。
需要编写或修改代码时
进行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发现需要额外验证时
npx skills add kdlbs/kandev --skill verify -g -y
该技能用于生成39种可视化图表（如架构图、流程图、时序图等），输出为自包含的HTML/SVG文件。支持品牌定制、语义模式及多种绘图风格，强调编辑设计与简洁性。
需要创建架构或业务流程图
要求生成带品牌风格的图表
将Mermaid或Draw.io源转换为高质量静态图
npx skills add kdlbs/kandev --skill diagram-design -g -y
确保UI开发遵循原生移动端交互模式，而非桌面端压缩适配。在规划或变更任何用户界面时强制运行，要求制定移动设计契约并包含Playwright E2E测试覆盖，以维持桌面与移动端的能力对等性。
实现新的前端页面、组件或工作流
审查涉及用户界面布局或交互的变更
测试前端功能以确保移动端兼容性
npx skills add kdlbs/kandev --skill mobile-parity -g -y
