aigroup-workflow 2.1.1 → 2.2.0

package/skills/django-expert/references/testing-django.md

@@ -1,204 +0,0 @@
-# Testing Django
-
-## APITestCase
-
-```python
-from rest_framework.test import APITestCase
-from rest_framework import status
-from django.urls import reverse
-
-class ProductAPITest(APITestCase):
-    def setUp(self):
-        self.user = User.objects.create_user(
-            email='test@example.com',
-            username='testuser',
-            password='testpass123'
-        )
-        self.category = Category.objects.create(name='Tech', slug='tech')
-        self.product = Product.objects.create(
-            name='Laptop',
-            slug='laptop',
-            price=999.99,
-            stock=10,
-            category=self.category,
-            created_by=self.user
-        )
-
-    def test_list_products(self):
-        url = reverse('product-list')
-        response = self.client.get(url)
-
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assertEqual(len(response.data['results']), 1)
-
-    def test_create_product_authenticated(self):
-        self.client.force_authenticate(user=self.user)
-        url = reverse('product-list')
-        data = {
-            'name': 'Phone',
-            'price': 499.99,
-            'stock': 5,
-            'category_id': self.category.id
-        }
-
-        response = self.client.post(url, data)
-
-        self.assertEqual(response.status_code, status.HTTP_201_CREATED)
-        self.assertEqual(Product.objects.count(), 2)
-
-    def test_create_product_unauthenticated(self):
-        url = reverse('product-list')
-        response = self.client.post(url, {'name': 'Test'})
-
-        self.assertEqual(response.status_code, status.HTTP_401_UNAUTHORIZED)
-```
-
-## Model Tests
-
-```python
-from django.test import TestCase
-from django.core.exceptions import ValidationError
-
-class ProductModelTest(TestCase):
-    def setUp(self):
-        self.user = User.objects.create_user(
-            email='test@example.com',
-            username='test',
-            password='pass'
-        )
-        self.category = Category.objects.create(name='Tech', slug='tech')
-
-    def test_product_creation(self):
-        product = Product.objects.create(
-            name='Test Product',
-            slug='test-product',
-            price=100,
-            category=self.category,
-            created_by=self.user
-        )
-
-        self.assertEqual(str(product), 'Test Product')
-        self.assertEqual(product.stock, 0)  # Default
-
-    def test_product_slug_unique(self):
-        Product.objects.create(
-            name='First', slug='test', price=10,
-            category=self.category, created_by=self.user
-        )
-
-        with self.assertRaises(Exception):
-            Product.objects.create(
-                name='Second', slug='test', price=20,
-                category=self.category, created_by=self.user
-            )
-```
-
-## Fixtures
-
-```python
-# fixtures/products.json
-[
-  {
-    "model": "products.category",
-    "pk": 1,
-    "fields": {"name": "Electronics", "slug": "electronics"}
-  },
-  {
-    "model": "products.product",
-    "pk": 1,
-    "fields": {
-      "name": "Laptop",
-      "slug": "laptop",
-      "price": "999.99",
-      "category": 1
-    }
-  }
-]
-
-# In test
-class ProductTest(TestCase):
-    fixtures = ['products.json']
-
-    def test_with_fixture(self):
-        product = Product.objects.get(slug='laptop')
-        self.assertEqual(product.name, 'Laptop')
-```
-
-## Factory Boy
-
-```python
-import factory
-from factory.django import DjangoModelFactory
-
-class UserFactory(DjangoModelFactory):
-    class Meta:
-        model = User
-
-    email = factory.Sequence(lambda n: f'user{n}@example.com')
-    username = factory.Sequence(lambda n: f'user{n}')
-    password = factory.PostGenerationMethodCall('set_password', 'testpass')
-
-class ProductFactory(DjangoModelFactory):
-    class Meta:
-        model = Product
-
-    name = factory.Faker('word')
-    slug = factory.LazyAttribute(lambda o: slugify(o.name))
-    price = factory.Faker('pydecimal', left_digits=3, right_digits=2, positive=True)
-    created_by = factory.SubFactory(UserFactory)
-
-# Usage
-class ProductTest(TestCase):
-    def test_with_factory(self):
-        product = ProductFactory(price=100)
-        self.assertEqual(product.price, 100)
-```
-
-## Testing JWT
-
-```python
-class JWTAuthTest(APITestCase):
-    def setUp(self):
-        self.user = User.objects.create_user(
-            email='test@example.com',
-            username='test',
-            password='testpass123'
-        )
-
-    def test_obtain_token(self):
-        response = self.client.post('/api/token/', {
-            'email': 'test@example.com',
-            'password': 'testpass123'
-        })
-
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-        self.assertIn('access', response.data)
-        self.assertIn('refresh', response.data)
-
-    def test_access_protected_endpoint(self):
-        response = self.client.post('/api/token/', {
-            'email': 'test@example.com',
-            'password': 'testpass123'
-        })
-        token = response.data['access']
-
-        self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {token}')
-        response = self.client.get('/api/protected/')
-
-        self.assertEqual(response.status_code, status.HTTP_200_OK)
-```
-
-## Quick Reference
-
-| Method | Purpose |
-|--------|---------|
-| `force_authenticate()` | Skip auth |
-| `credentials()` | Set headers |
-| `reverse()` | URL by name |
-| `fixtures` | Load test data |
-
-| Assertion | Check |
-|-----------|-------|
-| `assertEqual()` | Exact match |
-| `assertContains()` | Response contains |
-| `assertRaises()` | Exception raised |

package/skills/django-expert/references/viewsets-views.md

@@ -1,153 +0,0 @@
-# ViewSets & Views
-
-## ModelViewSet
-
-```python
-from rest_framework import viewsets, status
-from rest_framework.decorators import action
-from rest_framework.response import Response
-from rest_framework.permissions import IsAuthenticatedOrReadOnly
-from django_filters.rest_framework import DjangoFilterBackend
-
-class ProductViewSet(viewsets.ModelViewSet):
-    queryset = Product.objects.select_related('category', 'created_by')
-    serializer_class = ProductSerializer
-    permission_classes = [IsAuthenticatedOrReadOnly]
-    filter_backends = [DjangoFilterBackend, filters.SearchFilter, filters.OrderingFilter]
-    filterset_fields = ['category', 'is_active']
-    search_fields = ['name', 'description']
-    ordering_fields = ['price', 'created_at']
-    lookup_field = 'slug'
-
-    def get_queryset(self):
-        qs = super().get_queryset()
-        if self.action == 'list':
-            return qs.filter(is_active=True)
-        return qs
-
-    def perform_create(self, serializer):
-        serializer.save(created_by=self.request.user)
-
-    @action(detail=True, methods=['post'])
-    def purchase(self, request, slug=None):
-        product = self.get_object()
-        quantity = request.data.get('quantity', 1)
-
-        if product.stock < quantity:
-            return Response(
-                {'error': 'Insufficient stock'},
-                status=status.HTTP_400_BAD_REQUEST
-            )
-
-        product.stock -= quantity
-        product.save()
-        return Response({'message': 'Purchase successful'})
-
-    @action(detail=False, methods=['get'])
-    def featured(self, request):
-        featured = self.get_queryset().filter(is_featured=True)[:10]
-        serializer = self.get_serializer(featured, many=True)
-        return Response(serializer.data)
-```
-
-## Django 5.0 Async Views
-
-```python
-from django.http import JsonResponse
-from asgiref.sync import sync_to_async
-
-# Async function-based view
-async def user_list(request):
-    users = await sync_to_async(list)(
-        User.objects.all()[:100]
-    )
-    return JsonResponse({'users': [u.to_dict() for u in users]})
-
-# Async class-based view
-from django.views import View
-
-class AsyncProductView(View):
-    async def get(self, request, product_id):
-        product = await sync_to_async(
-            Product.objects.select_related('category').get
-        )(pk=product_id)
-        return JsonResponse({
-            'id': product.id,
-            'name': product.name,
-            'category': product.category.name,
-        })
-```
-
-## Generic Views
-
-```python
-from rest_framework import generics
-
-class ProductListCreate(generics.ListCreateAPIView):
-    queryset = Product.objects.all()
-    serializer_class = ProductSerializer
-    permission_classes = [IsAuthenticatedOrReadOnly]
-
-class ProductDetail(generics.RetrieveUpdateDestroyAPIView):
-    queryset = Product.objects.all()
-    serializer_class = ProductSerializer
-    lookup_field = 'slug'
-```
-
-## URL Configuration
-
-```python
-from rest_framework.routers import DefaultRouter
-
-router = DefaultRouter()
-router.register('products', ProductViewSet, basename='product')
-
-urlpatterns = [
-    path('api/', include(router.urls)),
-]
-
-# Generated URLs:
-# GET/POST    /api/products/
-# GET/PUT/DELETE /api/products/{slug}/
-# POST        /api/products/{slug}/purchase/
-# GET         /api/products/featured/
-```
-
-## Pagination
-
-```python
-# settings.py
-REST_FRAMEWORK = {
-    'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.PageNumberPagination',
-    'PAGE_SIZE': 20,
-}
-
-# Custom pagination
-from rest_framework.pagination import PageNumberPagination
-
-class LargeResultsSetPagination(PageNumberPagination):
-    page_size = 100
-    page_size_query_param = 'page_size'
-    max_page_size = 1000
-
-class ProductViewSet(viewsets.ModelViewSet):
-    pagination_class = LargeResultsSetPagination
-```
-
-## Quick Reference
-
-| ViewSet Method | HTTP | Action |
-|---------------|------|--------|
-| `list()` | GET | List all |
-| `create()` | POST | Create new |
-| `retrieve()` | GET | Get one |
-| `update()` | PUT | Full update |
-| `partial_update()` | PATCH | Partial update |
-| `destroy()` | DELETE | Delete |
-
-| Hook | Purpose |
-|------|---------|
-| `get_queryset()` | Filter queryset |
-| `get_serializer_class()` | Dynamic serializer |
-| `perform_create()` | Pre-save logic |
-| `@action()` | Custom endpoints |

package/skills/documentation/SKILL.md

@@ -1,45 +0,0 @@
----
-name: documentation
-description: 在代码变更落地后更新受影响的文档，确保 docs/ 与代码一致。包含必更新清单、更新原则、文档传感器验证。
----
-
-# 文档更新
-
-代码变更后的文档同步。**只更新受影响的文档**，不做无关改进。
-
-## 协调
-
-直接修改 `docs/` 下的文档；在 session `README.md`（或回报主会话）留变更笔记。完成后运行 `node scripts/hooks/dispatcher.cjs stop` 验证。
-
-## 必更新清单
-
-| 文档 | 触发条件 |
-|------|---------|
-| API 文档 | 接口变更（参数 / 返回值 / 错误码） |
-| README | 安装、使用方式变更 |
-| `docs/ARCHITECTURE.md` | 架构 / 模块边界 / 组件图变更 |
-| 模块 `CLAUDE.md` | 模块行为或入口变更 |
-
-## 按需更新
-
-| 文档 | 触发条件 |
-|------|---------|
-| 代码注释 | 复杂逻辑、关键算法、设计决策 |
-| 配置文档 | 配置项变更（新增 / 默认值 / 移除） |
-| 部署文档 | 部署流程或环境要求变更 |
-
-## 原则
-
-- 只改受影响的文档，不顺手做无关改进
-- 文档描述以代码实际行为为准
-- 删除已不存在功能的描述
-- 沿用现有文档的格式和语气
-
-## Red Flags
-
-| 信号 | 行动 |
-|------|------|
-| 测试未通过就更新文档 | 先完成测试 phase |
-| 文档与代码描述冲突 | 以代码为准修正文档 |
-| dispatcher stop 报错 | 先修 [FAIL] 再 ship |
-| 想跳过文档更新 | 检查是否真的零受影响文档 |

package/skills/dotnet-core-expert/SKILL.md

@@ -1,138 +0,0 @@
----
-name: dotnet-core-expert
-description: Use when building .NET 8 applications with minimal APIs, clean architecture, or cloud-native microservices. Invoke for Entity Framework Core, CQRS with MediatR, JWT authentication, AOT compilation.
-license: MIT
-metadata:
-  author: https://github.com/Jeffallan
-  version: "1.1.0"
-  domain: backend
-  triggers: .NET Core, .NET 8, ASP.NET Core, C# 12, minimal API, Entity Framework Core, microservices .NET, CQRS, MediatR
-  role: specialist
-  scope: implementation
-  output-format: code
-  related-skills: fullstack-guardian, microservices-architect, cloud-architect, test-master
----
-
-# .NET Core Expert
-
-## Core Workflow
-
-1. **Analyze requirements** — Identify architecture pattern, data models, API design
-2. **Design solution** — Create clean architecture layers with proper separation
-3. **Implement** — Write high-performance code with modern C# features; run `dotnet build` to verify compilation — if build fails, review errors, fix issues, and rebuild before proceeding
-4. **Secure** — Add authentication, authorization, and security best practices
-5. **Test** — Write comprehensive tests with xUnit and integration testing; run `dotnet test` to confirm all tests pass — if tests fail, diagnose failures, fix the implementation, and re-run before continuing; verify endpoints with `curl` or a REST client
-
-## Reference Guide
-
-Load detailed guidance based on context:
-
-| Topic | Reference | Load When |
-|-------|-----------|-----------|
-| Minimal APIs | `references/minimal-apis.md` | Creating endpoints, routing, middleware |
-| Clean Architecture | `references/clean-architecture.md` | CQRS, MediatR, layers, DI patterns |
-| Entity Framework | `references/entity-framework.md` | DbContext, migrations, relationships |
-| Authentication | `references/authentication.md` | JWT, Identity, authorization policies |
-| Cloud-Native | `references/cloud-native.md` | Docker, health checks, configuration |
-
-## Constraints
-
-### MUST DO
-- Use .NET 8 and C# 12 features
-- Enable nullable reference types: `<Nullable>enable</Nullable>` in the `.csproj`
-- Use async/await for all I/O operations — e.g., `await dbContext.Users.ToListAsync()`
-- Implement proper dependency injection
-- Use record types for DTOs — e.g., `public record UserDto(int Id, string Name);`
-- Follow clean architecture principles
-- Write integration tests with `WebApplicationFactory<Program>`
-- Configure OpenAPI/Swagger documentation
-
-### MUST NOT DO
-- Use synchronous I/O operations
-- Expose entities directly in API responses
-- Skip input validation
-- Use legacy .NET Framework patterns
-- Mix concerns across architectural layers
-- Use deprecated EF Core patterns
-
-## Code Examples
-
-### Minimal API Endpoint
-```csharp
-// Program.cs
-var builder = WebApplication.CreateBuilder(args);
-builder.Services.AddEndpointsApiExplorer();
-builder.Services.AddSwaggerGen();
-builder.Services.AddMediatR(cfg => cfg.RegisterServicesFromAssembly(typeof(Program).Assembly));
-
-var app = builder.Build();
-app.UseSwagger();
-app.UseSwaggerUI();
-
-app.MapGet("/users/{id}", async (int id, ISender sender, CancellationToken ct) =>
-{
-    var result = await sender.Send(new GetUserQuery(id), ct);
-    return result is null ? Results.NotFound() : Results.Ok(result);
-})
-.WithName("GetUser")
-.Produces<UserDto>()
-.ProducesProblem(404);
-
-app.Run();
-```
-
-### MediatR Query Handler
-```csharp
-// Application/Users/GetUserQuery.cs
-public record GetUserQuery(int Id) : IRequest<UserDto?>;
-
-public sealed class GetUserQueryHandler : IRequestHandler<GetUserQuery, UserDto?>
-{
-    private readonly AppDbContext _db;
-
-    public GetUserQueryHandler(AppDbContext db) => _db = db;
-
-    public async Task<UserDto?> Handle(GetUserQuery request, CancellationToken ct) =>
-        await _db.Users
-            .AsNoTracking()
-            .Where(u => u.Id == request.Id)
-            .Select(u => new UserDto(u.Id, u.Name))
-            .FirstOrDefaultAsync(ct);
-}
-```
-
-### EF Core DbContext with Async Query
-```csharp
-// Infrastructure/AppDbContext.cs
-public sealed class AppDbContext(DbContextOptions<AppDbContext> options) : DbContext(options)
-{
-    public DbSet<User> Users => Set<User>();
-
-    protected override void OnModelCreating(ModelBuilder modelBuilder)
-    {
-        modelBuilder.ApplyConfigurationsFromAssembly(typeof(AppDbContext).Assembly);
-    }
-}
-
-// Usage in a service
-public async Task<IReadOnlyList<UserDto>> GetAllAsync(CancellationToken ct) =>
-    await _db.Users
-        .AsNoTracking()
-        .Select(u => new UserDto(u.Id, u.Name))
-        .ToListAsync(ct);
-```
-
-### DTO with Record Type
-```csharp
-public record UserDto(int Id, string Name);
-public record CreateUserRequest(string Name, string Email);
-```
-
-## Output Templates
-
-When implementing .NET features, provide:
-1. Project structure (solution/project files)
-2. Domain models and DTOs
-3. API endpoints or service implementations
-4. Database context and migrations if applicable
-5. Brief explanation of architectural decisions