Development

从其他项目中提取优秀架构设计或功能实现，剥离业务耦合后迁移到 PythonCodeHub。适用于“迁移到 CodeHub”“提取到 PythonCodeHub”“把这个设计迁移过来”“重构后加入 CodeHub”“migrate to codehub”等场景。

在沉淀可复用资产（skill/rule/solution/memory/脚本）之前，先检查证据是否充分、现有覆盖是否已存在、哪个载体最小合适，输出路由结论后再决定是否创建，防止资产泛滥。触发短语包括："沉淀个skill"、"创建一个技能"、"做成规则"、"这个要不要沉淀"、"loop discovery"，或 AI 主动想将重复工作沉淀为持久资产时自动触发。

为前端生成 API 集成指南，将 API 设计文档转化为可直接编码的调用流程文档。适用场景：api-design 完成后需交付给前端时、"生成前端 API 文档"、"API 调用流程"。

为项目生成高质量 README 及子文档。根据项目类型自动选择编写策略，README 作为索引枢纽，详细内容拆分到子文档。适用于"生成 README"、"写项目文档"、"补文档"、"write docs"、"write readme" 等场景。

从设计文档生成代码骨架（文件+类+方法结构），将接口契约、数据模型、异常处理等以契约级注释嵌入代码中，使 AI 编码时无需反复查阅外部文档。大型项目按依赖批次分批生成，同批并行加速。生成前先评估架构风格与设计模式并与用户确认。适用场景：(1) 设计文档完成后准备编码，(2) "生成代码骨架"、"搭骨架"、"按设计生成代码结构"，(3) 设计变更后更新骨架，(4) AI 编码阶段需降低 token 消耗，(5) 修改现有代码时标注 TODO + 契约注释。

在设计前对代码库进行按需调研，只调研与当前需求相关的维度。强制 ki-search 查询项目记忆与资产复用（expert-lookup/solution-lookup）优先，不足时再代码搜索。需搜索维度 ≥ 2 时自动并行搜索加速。适用于"代码调研"、"了解现有代码"、"项目代码风格"、"架构调研"等场景，或在设计前置阶段被调用。

AI 生成 Markdown 文件或代码文件后，自动触发质量审查与修复闭环。审查完成后自动判断是否属于复杂场景，若属于则调用 challenger skill 进行二次质疑。触发条件：每次使用 write_to_file 或 replace_in_file 写入 .md / 代码文件后自动执行。

对代码、设计文档、Skill 文件进行系统化优化分析，发现可优化点并按优先级给出具体改进建议。不关注"有没有 bug"，只关注"能不能更好"。触发短语：'优化这段代码'、'优化这个设计'、'优化这个 skill'、'怎么改进这段代码'、'这个设计有什么优化空间'、'帮我优化一下'、'artifact optimizer'、'质量优化'、'这段代码能更好吗'、'这个设计能优化吗'、'有没有优化空间'、'怎么改进'、'改进一下'。当用户说'看看这段代码'、'review 这个代码'时优先触发 code-review；当用户说'改一下'、'改成'时优先触发 request-guard。

基于需求文档和设计文档，生成包含接口契约、关键代码设计、错误码定义的 API 设计文档。适用于"设计 API"、"接口设计"、"api design"等场景，或 design-craft 完成后需补充 API 设计细节时。

フロントエンド実装のコードレビューを実施する。PR レビュー、コードレビュー、実装チェック、品質確認を依頼されたときに使う。実装レイヤー選定の妥当性から各技術軸の観点まで順に検査する。

D-ZERO の JavaScript/TypeScript コーディング規約。JS/TS を書く・編集する・レビューするときに使う。イベント処理、DOM 操作、状態変更、ライブラリ追加、スクリプト読み込みに適用する。

D-ZERO の CSS コーディング規約。CSS を書く・編集する・レビューするときに使う。コンポーネントのスタイル、レイアウト、レスポンシブ、カスタムプロパティ、セレクタ設計に適用する。

Create and manage git worktrees for isolated working directories. Use when starting a new task that needs its own branch and directory.

PR-specific live behavior QA in ayunis-core — run applicable focused E2E first, then use an isolated seeded stack to verify behaviors, visuals, or edge cases that automated coverage does not prove. Use when the user asks for QA or the repository workflow requires additional live evidence; this supplements rather than replaces required E2E coverage.

Create temporary PR-specific screenshots and short GIF demos without committing scene code to the product branch. Use automatically when a visually meaningful frontend change materially benefits from visual review, and when the user requests PR media. Do not use for backend-only, non-visual, or already-sufficiently-proven changes.

Scaffold a new frontend page in ayunis-core. Use when adding a new route with its page component following Feature-Sliced Design conventions.

Manage Linear issues, projects, cycles, initiatives, and teams via the `linear` CLI (schpet/linear-cli)

Reference implementation for frontend data hooks (queries and mutations). MUST be loaded when creating or modifying any hook in an api/ directory or any use*.ts file that calls the generated API client.

Frontend form patterns — form types in model/, useForm setup, and end-to-end backend validation with field-level error display. Use when adding or modifying any form (page or dialog) that submits to the API.

Fix OpenAPI schema drift between backend and frontend. Use when CI fails with "API Schema Drift" or "API client is out of date", or after adding/changing backend controllers or DTOs.

Start, stop, and manage the local dev stack (Docker infra, backend, frontend). Works in any directory — worktree or main repo.

Analyze Cursor Bugbot PR comments through a root-cause lens: is the finding valid, and is the suggested fix the real fix or a bandaid over a deeper problem? Use when the user asks to check, assess, or triage bugbot comments.

Frontend development in ayunis-core. Use when creating, modifying, or debugging frontend code (React, Feature-Sliced Design, API client).

Genera o actualiza una especificación SDD (spec.md) para HagamosTech. Úsala cuando haya que definir una nueva funcionalidad o vertical antes de tocar código, entrevistando al usuario y produciendo requisitos funcionales en notación EARS. Trigger: crear/actualizar spec, nuevo requisito, /spec.