feat: add new OpenSpec skills for change management and onboarding

- Created `openspec-ff-change` skill for fast-forward artifact creation. - Introduced `openspec-new-change` skill for structured change creation. - Developed `openspec-onboard` skill for guided onboarding through OpenSpec workflow. - Added `openspec-sync-specs` skill for syncing delta specs to main specs. - Implemented `openspec-verify-change` skill for verifying implementation against change artifacts. - Updated `.gitignore` to exclude OpenSpec generated files. - Added `skills-lock.json` to manage skill dependencies.
2026-03-13 13:18:03 +08:00
parent 21539772ef
commit bbb2f41591
144 changed files with 16027 additions and 1 deletions
--- a/.agents/skills/tailwindcss/references/features-dark-mode.md
+++ b/.agents/skills/tailwindcss/references/features-dark-mode.md
@@ -0,0 +1,137 @@
+---
+name: features-dark-mode
+description: Implementing dark mode with Tailwind's dark variant and custom dark mode strategies
+---
+
+# Dark Mode
+
+Tailwind includes a `dark` variant that lets you style your site differently when dark mode is enabled.
+
+## Overview
+
+Use the `dark:` variant to apply styles in dark mode:
+
+```html
+<div class="bg-white dark:bg-gray-800 text-gray-900 dark:text-white">
+  Content
+</div>
+```
+
+## Default Behavior
+
+By default, the `dark` variant uses the `prefers-color-scheme` CSS media feature:
+
+```css
+@media (prefers-color-scheme: dark) {
+  .dark\:bg-gray-800 {
+    background-color: rgb(31 41 55);
+  }
+}
+```
+
+## Manual Toggle with Class
+
+Override the `dark` variant to use a class selector:
+
+```css
+@import "tailwindcss";
+
+@custom-variant dark (&:where(.dark, .dark *));
+```
+
+Now dark mode utilities apply when the `dark` class is present:
+
+```html
+<html class="dark">
+  <body>
+    <div class="bg-white dark:bg-black">Content</div>
+  </body>
+</html>
+```
+
+## Manual Toggle with Data Attribute
+
+Use a data attribute instead:
+
+```css
+@import "tailwindcss";
+
+@custom-variant dark (&:where([data-theme=dark], [data-theme=dark] *));
+```
+
+```html
+<html data-theme="dark">
+  <body>
+    <div class="bg-white dark:bg-black">Content</div>
+  </body>
+</html>
+```
+
+## Three-Way Theme Toggle
+
+Support light mode, dark mode, and system preference:
+
+```js
+// On page load
+document.documentElement.classList.toggle(
+  "dark",
+  localStorage.theme === "dark" ||
+    (!("theme" in localStorage) && 
+     window.matchMedia("(prefers-color-scheme: dark)").matches)
+);
+
+// Set light mode
+localStorage.theme = "light";
+document.documentElement.classList.remove("dark");
+
+// Set dark mode
+localStorage.theme = "dark";
+document.documentElement.classList.add("dark");
+
+// Respect system preference
+localStorage.removeItem("theme");
+document.documentElement.classList.toggle(
+  "dark",
+  window.matchMedia("(prefers-color-scheme: dark)").matches
+);
+```
+
+## Common Patterns
+
+### Cards
+
+```html
+<div class="bg-white dark:bg-gray-800 rounded-lg shadow-lg dark:shadow-none">
+  <h2 class="text-gray-900 dark:text-white">Title</h2>
+  <p class="text-gray-500 dark:text-gray-400">Description</p>
+</div>
+```
+
+### Borders
+
+```html
+<div class="border border-gray-200 dark:border-gray-700">
+  Content
+</div>
+```
+
+### Buttons
+
+```html
+<button class="bg-blue-500 hover:bg-blue-600 dark:bg-blue-600 dark:hover:bg-blue-700 text-white">
+  Button
+</button>
+```
+
+## Key Points
+
+- Use `dark:` variant for dark mode styles
+- Default uses `prefers-color-scheme` media query
+- Override with `@custom-variant` for manual toggles
+- Can use class or data attribute selectors
+- Combine with responsive variants: `dark:md:bg-gray-800`
+
+<!--
+Source references:
+- https://tailwindcss.com/docs/dark-mode
+-->