kitty-dev

name	kitty-dev
description	维护 kitty 项目时使用。适用于修改实现、接口、数据、测试、事实文档、依赖、构建和运行配置，要求先确认事实，再完成实现、验证、文档同步与交付闭环。

kitty Development

在本项目发生开发性修改时使用本 skill。

开始前

1. 读取根目录 AGENTS.md、spec.md 和 README.md；只有 owner 明确启用专业模式时才把 plan.md 作为当前任务合同。
2. 检查 Git 状态、分支、未提交改动、目录结构、运行入口和验证入口。
3. 从当前任务涉及的入口追踪真实规则、状态、数据、错误和外部边界。
4. 区分已确认事实、owner 提供但未验证的事实、推测、计划事项和已完成并验证事项。
5. 默认进入快速模式直接开发；只有 owner 明确要求专业模式或计划时，才读取 .agents/skills/plan/SKILL.md 并维护根目录 plan.md。

实现规则

• 优先沿用仓库已经成立的技术栈、命名、模块边界和本地辅助能力。
• 每次交付同时闭合代码、文档和测试；测试与文档服务当前代码事实，不能反向制造无意义工作。
• 单一职责按事实 owner 和变化原因判断；文件体积只能触发职责审查，不能按行数机械拆分。
• 状态、规则、数据读写、展示、外部接线和错误处理变化原因不同时，拆清边界。
• 每个事实只保留一个 owner；跨 owner 决策、事实重复、循环依赖或领域反向依赖交付层时重审边界。
• 结构化数据使用结构化接口，错误类型服务恢复策略，生成物只由明确源和确定性命令重建。
• 不覆盖或回滚 owner 的无关改动，不建立旧别名、兼容转发、历史包装或过渡文件。
• 快速模式把旧代码、旧 schema、旧数据、旧状态、旧接口、旧测试、旧文档和本机状态视为可丢弃，禁止读取 history、旧提交、旧分支或归档代码寻找兼容行为。
• 当前正确事实推翻旧 owner、schema、状态机、接口或模块时，断裂式重建唯一主干，同一次交付替换定义、消费者、持久结构、配置、测试、文档、生成源和生成物；历史、本机状态、旧绿灯和少改文件不是兼容理由。
• owner 明确声明必须保留正式生产数据或外部合同时，退出快速模式并显式启用专业迁移；否则不设计 migration、弃用期或新旧并行窗口。
• 不用页面、功能、文件、计划或测试数量冒充产品成熟，不建立临时入口、概念稿消费者或展示层第二事实源。
• 不为修表象增加项目名、文案、关键词、字符串或单次样例特判，不从历史恢复旧能力或兼容目标。
• 不复制参考项目的功能清单、模拟数据、业务规则或受限源码；不在未知副作用或部分提交边界盲目重放。
• 任何未实现或未验证内容，在任何载体中都不能写成已经实现或已经通过。

测试规则

• 新增测试前先用一句业务语言说明它保护的稳定结果；再确认现有更高层证据不能证明，且页面、模块、文件或实现重建后仍有产品意义。任一项答不出就不新增。
• 每个结果只保留最有证明力的一层，不在浏览器、组件、handler、service、repository 和 mock 间重复证明。
• 不长期测试文案、按钮、菜单、标题、颜色、布局、顺序、文件、路由、调用次数、查询批次或内部步骤。
• UI 增删、改名、排列或模块重建不触发测试，除非稳定业务结果、权限边界或公共合同变化。
• 修复回归时先建立可复现的业务失败或等价证据；不用旧字符串、旧文件或旧路由“不存在”证明删除完成。
• 并发和时序等待事件或可观察状态，不用固定 sleep 或复跑掩盖竞态。

文档同步

• 产品当前事实变化时同步 spec.md。
• 用户使用、安装、运行或验证方式变化时同步 README.md。
• 长期协作规则或验证入口变化时同步 AGENTS.md 和本 skill。
• 专业模式中，当前任务范围、设计、状态或验证变化时同步 plan.md；快速模式不为流程更新计划。
• 删除的能力不得继续出现在实现、测试、文档或配置中。

完整验证

• npm run typecheck
• npm run test
• npm run build
• npm run verify

快速模式先运行与改动最接近、最有证明力的短检查；专业模式再按计划和风险扩大到完整验证与核心路径。昂贵全量、真实外部服务、容量和发布物测试只在项目规则、风险或 owner 明确授权要求时运行。无法运行时写明具体命令、阻塞原因和剩余风险，不能写成已通过。

交付

• 检查最终差异、文件清单和工作区状态，只交付当前任务相关内容。
• commit、push、部署和发布只在 owner 明确授权时执行；授权 push 但未指定分支时默认推送 master。
• 收口说明完成事实、实际验证、未验证项和剩余风险，不以“后续优化”代替当期完成。