lisätty category ja impact meta tiedot ai varten

This commit is contained in:
moilanik 2026-04-18 06:49:24 +03:00
parent 881ccd79dd
commit 5c4f49f608
18 changed files with 42 additions and 5 deletions

View File

@ -1,6 +1,8 @@
--- ---
name: analysis name: analysis
description: Analyze user requests, evaluate requirements, and propose AI action plans. Use when analyzing code, errors, or planning tasks. description: Analyze user requests, evaluate requirements, and propose AI action plans. Use when analyzing code, errors, or planning tasks.
category: workflow
impact: high
--- ---
# Analysis Instructions # Analysis Instructions

View File

@ -1,6 +1,8 @@
--- ---
name: clean-architecture name: clean-architecture
description: Enforce clean architecture principles and Hexagonal/Onion patterns. Use when designing system architecture, domains, or defining module boundaries. description: Enforce clean architecture principles and Hexagonal/Onion patterns. Use when designing system architecture, domains, or defining module boundaries.
category: code
impact: medium
--- ---
# Clean Architecture # Clean Architecture

View File

@ -1,6 +1,8 @@
--- ---
name: clean-code name: clean-code
description: Apply clean code principles, SOLID, and DRY practices. Use when writing, reviewing, or refactoring application code. description: Apply clean code principles, SOLID, and DRY practices. Use when writing, reviewing, or refactoring application code.
category: code
impact: medium
--- ---
# Clean Code Guidelines # Clean Code Guidelines

View File

@ -2,6 +2,7 @@
name: core-principles name: core-principles
description: The absolute foundational behavior, etiquette, and operational methodology for the AI assistant. Use when discussing AI behavior, rules, speed vs quality, or making decisions. description: The absolute foundational behavior, etiquette, and operational methodology for the AI assistant. Use when discussing AI behavior, rules, speed vs quality, or making decisions.
category: meta category: meta
impact: high
--- ---
> **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** AI Behavior, Ethics & Operational Methodology > **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** AI Behavior, Ethics & Operational Methodology

View File

@ -1,7 +1,8 @@
--- ---
name: docs name: docs
description: Rules for maintaining the project's documentation folder (ai-context.md and architecture.md). Use when editing or creating project documentation files. description: Rules for maintaining the project's documentation folder (ai-context.md and architecture.md). Use when editing or creating project documentation files.
category: meta category: workflow
impact: low
--- ---
> **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** Project Documentation Management > **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** Project Documentation Management

View File

@ -1,6 +1,8 @@
--- ---
name: documentation name: documentation
description: Rules and structures for writing project documentation in Markdown. Use when creating, formatting, or updating markdown docs. description: Rules and structures for writing project documentation in Markdown. Use when creating, formatting, or updating markdown docs.
category: workflow
impact: low
--- ---
# Documentation Instructions # Documentation Instructions

View File

@ -1,6 +1,8 @@
--- ---
name: file-editing name: file-editing
description: Rules for sandbox file editing into tmp/ topics to avoid root pollution. Use when creating temporary files, drafts, scratchpads, or experimenting. description: Rules for sandbox file editing into tmp/ topics to avoid root pollution. Use when creating temporary files, drafts, scratchpads, or experimenting.
category: workflow
impact: low
--- ---
# File Editing Instructions # File Editing Instructions

View File

@ -1,6 +1,8 @@
--- ---
name: git name: git
description: Enforce semantic versioning and strict Git commit message formats (topic-level). Use when committing code, parsing git history, or writing commit messages. description: Enforce semantic versioning and strict Git commit message formats (topic-level). Use when committing code, parsing git history, or writing commit messages.
category: workflow
impact: medium
--- ---
# Git Instructions # Git Instructions

View File

@ -1,6 +1,8 @@
--- ---
name: grill-me name: grill-me
description: Active interrogator mode to clarify fuzzy requirements before starting work. Use when the user asks to be grilled, questioned, or needs to flesh out an idea. description: Active interrogator mode to clarify fuzzy requirements before starting work. Use when the user asks to be grilled, questioned, or needs to flesh out an idea.
category: workflow
impact: medium
--- ---
# Grill Me Instructions # Grill Me Instructions

View File

@ -1,6 +1,8 @@
--- ---
name: helm name: helm
description: Helm chart guidelines focusing on explicit resource naming over complex umbrellas. Use when creating, modifying, or reviewing Helm charts and Kubernetes manifests. description: Helm chart guidelines focusing on explicit resource naming over complex umbrellas. Use when creating, modifying, or reviewing Helm charts and Kubernetes manifests.
category: infra
impact: medium
--- ---
# Helm Chart Development Guidelines # Helm Chart Development Guidelines

View File

@ -1,6 +1,8 @@
--- ---
name: iac name: iac
description: Best practices for Infrastructure as Code, GitOps, minimizing configuration drift, and avoiding imperative infrastructure operations. description: Best practices for Infrastructure as Code, GitOps, minimizing configuration drift, and avoiding imperative infrastructure operations.
category: infra
impact: high
--- ---
# Infrastructure as Code (IaC) # Infrastructure as Code (IaC)

View File

@ -1,6 +1,8 @@
--- ---
name: kubernetes-access name: kubernetes-access
description: Defines workflows for interacting with Kubernetes clusters, depending on whether a valid kubeconfig is present. Emphasizes read-only access and strict IaC adherence. description: Defines workflows for interacting with Kubernetes clusters, depending on whether a valid kubeconfig is present. Emphasizes read-only access and strict IaC adherence.
category: infra
impact: high
--- ---
# Kubernetes & Helm Access # Kubernetes & Helm Access

View File

@ -1,6 +1,8 @@
--- ---
name: mermaid name: mermaid
description: Safe Mermaid diagram generation avoiding raw HTML entities and newlines. Use when generating, formatting, or updating Mermaid graphs or diagrams. description: Safe Mermaid diagram generation avoiding raw HTML entities and newlines. Use when generating, formatting, or updating Mermaid graphs or diagrams.
category: workflow
impact: low
--- ---
# Mermaid Diagram Instructions # Mermaid Diagram Instructions

View File

@ -2,6 +2,7 @@
name: project-context name: project-context
description: Establish how the AI should fetch, create, and interact with a project's individual ai-context.md file. Use when setting up a new project or looking for project repo context. description: Establish how the AI should fetch, create, and interact with a project's individual ai-context.md file. Use when setting up a new project or looking for project repo context.
category: meta category: meta
impact: low
--- ---
> **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** AI Internal Operations & Context Discovery > **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** AI Internal Operations & Context Discovery

View File

@ -2,6 +2,7 @@
name: readme name: readme
description: Guidelines for creating or updating README files. Use when generating, formatting, or editing the project's root README.md. description: Guidelines for creating or updating README files. Use when generating, formatting, or editing the project's root README.md.
category: meta category: meta
impact: low
--- ---
> **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** Project Documentation Management > **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** Project Documentation Management

View File

@ -2,6 +2,7 @@
name: root-skill name: root-skill
description: The absolute master configuration and state machine for the AI. This is the entry point that governs how the AI operates, changes states, and loads other skills. description: The absolute master configuration and state machine for the AI. This is the entry point that governs how the AI operates, changes states, and loads other skills.
category: meta category: meta
impact: high
--- ---
> **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** Global AI State Machine & Workflow > **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** Global AI State Machine & Workflow

View File

@ -1,6 +1,8 @@
--- ---
name: use-cases name: use-cases
description: Structure use case documentation following rigid outlines to prevent bloat. Use when defining application use cases, stories, or functional requirements. description: Structure use case documentation following rigid outlines to prevent bloat. Use when defining application use cases, stories, or functional requirements.
category: workflow
impact: low
--- ---
# Use Cases Instructions # Use Cases Instructions

View File

@ -1,7 +1,8 @@
--- ---
name: write-skill name: write-skill
description: Create new agent skills with proper structure and AI superpower constraints. Use when user wants to create, write, or build a new skill, rule, or instruction. description: Create new agent skills with proper structure and AI superpower constraints. Use when user wants to create, write, or build a new skill, rule, or instruction.
category: meta category: workflow
impact: medium
--- ---
> **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** AI Internal Operations & Context Discovery > **🏷️ Category:** `Meta-Skill` | **⚙️ Applies to:** AI Internal Operations & Context Discovery
@ -15,7 +16,7 @@ Force the AI to structure all new knowledge files into the strict, restrictive,
## 🚨 Prohibitions (Thou Shalt Not) ## 🚨 Prohibitions (Thou Shalt Not)
- **NEVER create a new skill without YAML frontmatter.** It MUST contain `name` and `description` (with "Use when [triggers]"). - **NEVER create a new skill without YAML frontmatter.** It MUST contain `name`, `categoy`, `impact` and `description` (with "Use when [triggers]").
- **NEVER create a skill longer than 100 lines.** If it's too long, split the theory/examples into `REFERENCE.md` or `EXAMPLES.md`. - **NEVER create a skill longer than 100 lines.** If it's too long, split the theory/examples into `REFERENCE.md` or `EXAMPLES.md`.
- **NEVER write text-heavy prose.** Use bullet points, bold text, and "Negative Prompting" (`🚨 Prohibitions: NEVER...`). - **NEVER write text-heavy prose.** Use bullet points, bold text, and "Negative Prompting" (`🚨 Prohibitions: NEVER...`).
- **NEVER skip the `ai-root-instructions.md` integration.** The skill does not exist until it's registered in the router. - **NEVER skip the `ai-root-instructions.md` integration.** The skill does not exist until it's registered in the router.
@ -31,13 +32,20 @@ Force the AI to structure all new knowledge files into the strict, restrictive,
- Run `create_file` to save `SKILL.md`. - Run `create_file` to save `SKILL.md`.
- Run `replace_string_in_file` to add a new trigger line to `.ai/skills/ai-root-instructions/SKILL.md`. - Run `replace_string_in_file` to add a new trigger line to `.ai/skills/ai-root-instructions/SKILL.md`.
## Impact Selection Criteria:
- high: Foundational rules. Security, state machines (root-skill), core ethics, or infrastructure integrity (IaC). If this rule is broken, the project or AI logic fails.
- medium: Workflow & Quality. Coding standards, Git practices, architectural patterns. Important for long-term health, but doesn't crash the system immediately.
- low: Formatting & Tools. Mermaid syntax, README structures, or temporary file handling. Purely aesthetic or helper-level instructions.
## ✅ / ❌ Examples ## ✅ / ❌ Examples
### The Mandatory SKILL.md Template ### The Mandatory SKILL.md Template
```md ```md
--- ---
name: [skill-name] name: <skill-name>
description: [1st sentence: what it does. 2nd sentence: "Use when [specific triggers]."] description: <what it does> <clear-description-for-ai-to-understand-when-to-load>
category: <meta|workflow|code|infra>
impact: <high|medium|low>
--- ---
# [Skill Name] # [Skill Name]