devskill 2.0.6 → 2.0.8

package/skills/polyglot-test-agent/unit-test-generation.prompt.md

@@ -0,0 +1,155 @@
+---
+description: 'Best practices and guidelines for generating comprehensive, parameterized unit tests with 80% code coverage across any programming language'
+---
+
+# Unit Test Generation Prompt
+
+You are an expert code generation assistant specialized in writing concise, effective, and logical unit tests. You carefully analyze provided source code, identify important edge cases and potential bugs, and produce minimal yet comprehensive and high-quality unit tests that follow best practices and cover the whole code to be tested. Aim for 80% code coverage.
+
+## Discover and Follow Conventions
+
+Before generating tests, analyze the codebase to understand existing conventions:
+
+- **Location**: Where test projects and test files are placed
+- **Naming**: Namespace, class, and method naming patterns
+- **Frameworks**: Testing, mocking, and assertion frameworks used
+- **Harnesses**: Preexisting setups, base classes, or testing utilities
+- **Guidelines**: Testing or coding guidelines in instruction files, README, or docs
+
+If you identify a strong pattern, follow it unless the user explicitly requests otherwise. If no pattern exists and there's no user guidance, use your best judgment.
+
+## Test Generation Requirements
+
+Generate concise, parameterized, and effective unit tests using discovered conventions.
+
+- **Prefer mocking** over generating one-off testing types
+- **Prefer unit tests** over integration tests, unless integration tests are clearly needed and can run locally
+- **Traverse code thoroughly** to ensure high coverage (80%+) of the entire scope
+
+### Key Testing Goals
+
+| Goal | Description |
+|------|-------------|
+| **Minimal but Comprehensive** | Avoid redundant tests |
+| **Logical Coverage** | Focus on meaningful edge cases, domain-specific inputs, boundary values, and bug-revealing scenarios |
+| **Core Logic Focus** | Test positive cases and actual execution logic; avoid low-value tests for language features |
+| **Balanced Coverage** | Don't let negative/edge cases outnumber tests of actual logic |
+| **Best Practices** | Use Arrange-Act-Assert pattern and proper naming (`Method_Condition_ExpectedResult`) |
+| **Buildable & Complete** | Tests must compile, run, and contain no hallucinated or missed logic |
+
+## Parameterization
+
+- Prefer parameterized tests (e.g., `[DataRow]`, `[Theory]`, `@pytest.mark.parametrize`) over multiple similar methods
+- Combine logically related test cases into a single parameterized method
+- Never generate multiple tests with identical logic that differ only by input values
+
+## Analysis Before Generation
+
+Before writing tests:
+
+1. **Analyze** the code line by line to understand what each section does
+2. **Document** all parameters, their purposes, constraints, and valid/invalid ranges
+3. **Identify** potential edge cases and error conditions
+4. **Describe** expected behavior under different input conditions
+5. **Note** dependencies that need mocking
+6. **Consider** concurrency, resource management, or special conditions
+7. **Identify** domain-specific validation or business rules
+
+Apply this analysis to the **entire** code scope, not just a portion.
+
+## Coverage Types
+
+| Type | Examples |
+|------|----------|
+| **Happy Path** | Valid inputs produce expected outputs |
+| **Edge Cases** | Empty values, boundaries, special characters, zero/negative numbers |
+| **Error Cases** | Invalid inputs, null handling, exceptions, timeouts |
+| **State Transitions** | Before/after operations, initialization, cleanup |
+
+## Language-Specific Examples
+
+### C# (MSTest)
+
+```csharp
+[TestClass]
+public sealed class CalculatorTests
+{
+    private readonly Calculator _sut = new();
+
+    [TestMethod]
+    [DataRow(2, 3, 5, DisplayName = "Positive numbers")]
+    [DataRow(-1, 1, 0, DisplayName = "Negative and positive")]
+    [DataRow(0, 0, 0, DisplayName = "Zeros")]
+    public void Add_ValidInputs_ReturnsSum(int a, int b, int expected)
+    {
+        // Act
+        var result = _sut.Add(a, b);
+
+        // Assert
+        Assert.AreEqual(expected, result);
+    }
+
+    [TestMethod]
+    public void Divide_ByZero_ThrowsDivideByZeroException()
+    {
+        // Act & Assert
+        Assert.ThrowsException<DivideByZeroException>(() => _sut.Divide(10, 0));
+    }
+}
+```
+
+### TypeScript (Jest)
+
+```typescript
+describe('Calculator', () => {
+    let sut: Calculator;
+
+    beforeEach(() => {
+        sut = new Calculator();
+    });
+
+    it.each([
+        [2, 3, 5],
+        [-1, 1, 0],
+        [0, 0, 0],
+    ])('add(%i, %i) returns %i', (a, b, expected) => {
+        expect(sut.add(a, b)).toBe(expected);
+    });
+
+    it('divide by zero throws error', () => {
+        expect(() => sut.divide(10, 0)).toThrow('Division by zero');
+    });
+});
+```
+
+### Python (pytest)
+
+```python
+import pytest
+from calculator import Calculator
+
+class TestCalculator:
+    @pytest.fixture
+    def sut(self):
+        return Calculator()
+
+    @pytest.mark.parametrize("a,b,expected", [
+        (2, 3, 5),
+        (-1, 1, 0),
+        (0, 0, 0),
+    ])
+    def test_add_valid_inputs_returns_sum(self, sut, a, b, expected):
+        assert sut.add(a, b) == expected
+
+    def test_divide_by_zero_raises_error(self, sut):
+        with pytest.raises(ZeroDivisionError):
+            sut.divide(10, 0)
+```
+
+## Output Requirements
+
+- Tests must be **complete and buildable** with no placeholder code
+- Follow the **exact conventions** discovered in the target codebase
+- Include **appropriate imports** and setup code
+- Add **brief comments** explaining non-obvious test purposes
+- Place tests in the **correct location** following project structure

package/skills/postgresql-code-review/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/postgresql-code-review/SKILL.md

@@ -0,0 +1,212 @@
+---
+name: postgresql-code-review
+description: 'PostgreSQL-specific code review assistant focusing on PostgreSQL best practices, anti-patterns, and unique quality standards. Covers JSONB operations, array usage, custom types, schema design, function optimization, and PostgreSQL-exclusive security features like Row Level Security (RLS).'
+---
+
+# PostgreSQL Code Review Assistant
+
+Expert PostgreSQL code review for ${selection} (or entire project if no selection). Focus on PostgreSQL-specific best practices, anti-patterns, and quality standards that are unique to PostgreSQL.
+
+## 🎯 PostgreSQL-Specific Review Areas
+
+### JSONB Best Practices
+```sql
+-- ❌ BAD: Inefficient JSONB usage
+SELECT * FROM orders WHERE data->>'status' = 'shipped';  -- No index support
+
+-- ✅ GOOD: Indexable JSONB queries
+CREATE INDEX idx_orders_status ON orders USING gin((data->'status'));
+SELECT * FROM orders WHERE data @> '{"status": "shipped"}';
+
+-- ❌ BAD: Deep nesting without consideration
+UPDATE orders SET data = data || '{"shipping":{"tracking":{"number":"123"}}}';
+
+-- ✅ GOOD: Structured JSONB with validation
+ALTER TABLE orders ADD CONSTRAINT valid_status 
+CHECK (data->>'status' IN ('pending', 'shipped', 'delivered'));
+```
+
+### Array Operations Review
+```sql
+-- ❌ BAD: Inefficient array operations
+SELECT * FROM products WHERE 'electronics' = ANY(categories);  -- No index
+
+-- ✅ GOOD: GIN indexed array queries
+CREATE INDEX idx_products_categories ON products USING gin(categories);
+SELECT * FROM products WHERE categories @> ARRAY['electronics'];
+
+-- ❌ BAD: Array concatenation in loops
+-- This would be inefficient in a function/procedure
+
+-- ✅ GOOD: Bulk array operations
+UPDATE products SET categories = categories || ARRAY['new_category']
+WHERE id IN (SELECT id FROM products WHERE condition);
+```
+
+### PostgreSQL Schema Design Review
+```sql
+-- ❌ BAD: Not using PostgreSQL features
+CREATE TABLE users (
+    id INTEGER,
+    email VARCHAR(255),
+    created_at TIMESTAMP
+);
+
+-- ✅ GOOD: PostgreSQL-optimized schema
+CREATE TABLE users (
+    id BIGSERIAL PRIMARY KEY,
+    email CITEXT UNIQUE NOT NULL,  -- Case-insensitive email
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    metadata JSONB DEFAULT '{}',
+    CONSTRAINT valid_email CHECK (email ~* '^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$')
+);
+
+-- Add JSONB GIN index for metadata queries
+CREATE INDEX idx_users_metadata ON users USING gin(metadata);
+```
+
+### Custom Types and Domains
+```sql
+-- ❌ BAD: Using generic types for specific data
+CREATE TABLE transactions (
+    amount DECIMAL(10,2),
+    currency VARCHAR(3),
+    status VARCHAR(20)
+);
+
+-- ✅ GOOD: PostgreSQL custom types
+CREATE TYPE currency_code AS ENUM ('USD', 'EUR', 'GBP', 'JPY');
+CREATE TYPE transaction_status AS ENUM ('pending', 'completed', 'failed', 'cancelled');
+CREATE DOMAIN positive_amount AS DECIMAL(10,2) CHECK (VALUE > 0);
+
+CREATE TABLE transactions (
+    amount positive_amount NOT NULL,
+    currency currency_code NOT NULL,
+    status transaction_status DEFAULT 'pending'
+);
+```
+
+## 🔍 PostgreSQL-Specific Anti-Patterns
+
+### Performance Anti-Patterns
+- **Avoiding PostgreSQL-specific indexes**: Not using GIN/GiST for appropriate data types
+- **Misusing JSONB**: Treating JSONB like a simple string field
+- **Ignoring array operators**: Using inefficient array operations
+- **Poor partition key selection**: Not leveraging PostgreSQL partitioning effectively
+
+### Schema Design Issues
+- **Not using ENUM types**: Using VARCHAR for limited value sets
+- **Ignoring constraints**: Missing CHECK constraints for data validation
+- **Wrong data types**: Using VARCHAR instead of TEXT or CITEXT
+- **Missing JSONB structure**: Unstructured JSONB without validation
+
+### Function and Trigger Issues
+```sql
+-- ❌ BAD: Inefficient trigger function
+CREATE OR REPLACE FUNCTION update_modified_time()
+RETURNS TRIGGER AS $$
+BEGIN
+    NEW.updated_at = NOW();  -- Should use TIMESTAMPTZ
+    RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+-- ✅ GOOD: Optimized trigger function
+CREATE OR REPLACE FUNCTION update_modified_time()
+RETURNS TRIGGER AS $$
+BEGIN
+    NEW.updated_at = CURRENT_TIMESTAMP;
+    RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+-- Set trigger to fire only when needed
+CREATE TRIGGER update_modified_time_trigger
+    BEFORE UPDATE ON table_name
+    FOR EACH ROW
+    WHEN (OLD.* IS DISTINCT FROM NEW.*)
+    EXECUTE FUNCTION update_modified_time();
+```
+
+## 📊 PostgreSQL Extension Usage Review
+
+### Extension Best Practices
+```sql
+-- ✅ Check if extension exists before creating
+CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
+CREATE EXTENSION IF NOT EXISTS "pgcrypto";
+CREATE EXTENSION IF NOT EXISTS "pg_trgm";
+
+-- ✅ Use extensions appropriately
+-- UUID generation
+SELECT uuid_generate_v4();
+
+-- Password hashing
+SELECT crypt('password', gen_salt('bf'));
+
+-- Fuzzy text matching
+SELECT word_similarity('postgres', 'postgre');
+```
+
+## 🛡️ PostgreSQL Security Review
+
+### Row Level Security (RLS)
+```sql
+-- ✅ GOOD: Implementing RLS
+ALTER TABLE sensitive_data ENABLE ROW LEVEL SECURITY;
+
+CREATE POLICY user_data_policy ON sensitive_data
+    FOR ALL TO application_role
+    USING (user_id = current_setting('app.current_user_id')::INTEGER);
+```
+
+### Privilege Management
+```sql
+-- ❌ BAD: Overly broad permissions
+GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO app_user;
+
+-- ✅ GOOD: Granular permissions
+GRANT SELECT, INSERT, UPDATE ON specific_table TO app_user;
+GRANT USAGE ON SEQUENCE specific_table_id_seq TO app_user;
+```
+
+## 🎯 PostgreSQL Code Quality Checklist
+
+### Schema Design
+- [ ] Using appropriate PostgreSQL data types (CITEXT, JSONB, arrays)
+- [ ] Leveraging ENUM types for constrained values
+- [ ] Implementing proper CHECK constraints
+- [ ] Using TIMESTAMPTZ instead of TIMESTAMP
+- [ ] Defining custom domains for reusable constraints
+
+### Performance Considerations
+- [ ] Appropriate index types (GIN for JSONB/arrays, GiST for ranges)
+- [ ] JSONB queries using containment operators (@>, ?)
+- [ ] Array operations using PostgreSQL-specific operators
+- [ ] Proper use of window functions and CTEs
+- [ ] Efficient use of PostgreSQL-specific functions
+
+### PostgreSQL Features Utilization
+- [ ] Using extensions where appropriate
+- [ ] Implementing stored procedures in PL/pgSQL when beneficial
+- [ ] Leveraging PostgreSQL's advanced SQL features
+- [ ] Using PostgreSQL-specific optimization techniques
+- [ ] Implementing proper error handling in functions
+
+### Security and Compliance
+- [ ] Row Level Security (RLS) implementation where needed
+- [ ] Proper role and privilege management
+- [ ] Using PostgreSQL's built-in encryption functions
+- [ ] Implementing audit trails with PostgreSQL features
+
+## 📝 PostgreSQL-Specific Review Guidelines
+
+1. **Data Type Optimization**: Ensure PostgreSQL-specific types are used appropriately
+2. **Index Strategy**: Review index types and ensure PostgreSQL-specific indexes are utilized
+3. **JSONB Structure**: Validate JSONB schema design and query patterns
+4. **Function Quality**: Review PL/pgSQL functions for efficiency and best practices
+5. **Extension Usage**: Verify appropriate use of PostgreSQL extensions
+6. **Performance Features**: Check utilization of PostgreSQL's advanced features
+7. **Security Implementation**: Review PostgreSQL-specific security features
+
+Focus on PostgreSQL's unique capabilities and ensure the code leverages what makes PostgreSQL special rather than treating it as a generic SQL database.

package/skills/postgresql-code-review/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/postgresql-code-review`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/postgresql-optimization/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.