zhuge-workflow 0.1.0

package/templates/claude/skills/bash-style/SKILL.md

@@ -0,0 +1,244 @@
+---
+name: bash-style
+description: 当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件，或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。
+---
+
+# Bash 编写规范
+
+版本：v1.0
+更新：2026-01
+
+---
+
+## 1. 注释规范
+
+### 禁止行尾注释
+
+- ❌ **禁止行尾注释**（如 `command # 注释`）
+- ✅ 注释应独占一行，放在代码上方
+
+**适用范围**：
+- Shell 脚本文件（.sh）
+- Markdown 文档中的 bash 代码块
+- Dockerfile、Makefile 中的 shell 命令
+
+```bash
+# ❌ 错误：行尾注释
+curl -X POST https://api.example.com/data # 发送请求
+docker run -d nginx # 启动容器
+cp -r src/ dist/ # 复制文件
+
+# ✅ 正确：注释独占一行
+# 发送请求
+curl -X POST https://api.example.com/data
+
+# 启动容器
+docker run -d nginx
+
+# 复制文件
+cp -r src/ dist/
+```
+
+**原因**：
+- 复制粘贴时容易带上注释导致命令出错
+- 长命令 + 注释 = 超长行，可读性差
+- Heredoc 块内 `#` 不是注释而是内容
+
+---
+
+## 2. 文件写入方式
+
+### 推荐方式：tee 命令
+
+```bash
+# ✅ 推荐：简洁、无嵌套引号
+sudo tee /etc/fail2ban/jail.d/docker-nginx.local > /dev/null << 'EOF'
+[docker-nginx]
+enabled = true
+filter = docker-nginx
+logpath = /var/log/nginx/access.log
+maxretry = 5
+EOF
+```
+
+### 追加内容
+
+```bash
+# ✅ 追加到文件
+sudo tee -a /etc/hosts > /dev/null << 'EOF'
+192.168.1.100 myserver
+EOF
+
+# ✅ 单行追加
+echo '192.168.1.100 myserver' | sudo tee -a /etc/hosts
+```
+
+### 避免的写法
+
+```bash
+# ❌ 避免：嵌套引号复杂，易出错
+sudo bash -c 'cat > /etc/xxx << EOF
+content
+EOF'
+
+# ❌ 避免：需要转义内容中的特殊字符
+sudo sh -c "echo 'line1\nline2' > /etc/xxx"
+```
+
+### 方式对比
+
+| 方式 | 优点 | 缺点 | 推荐场景 |
+|------|------|------|---------|
+| `sudo tee` | 简洁、无嵌套 | 需 `> /dev/null` 抑制输出 | **首选** |
+| `sudo bash -c 'cat >'` | 无需 tee | 嵌套引号复杂 | 不推荐 |
+| 临时文件 + mv | 可先验证 | 步骤多 | 复杂配置 |
+
+---
+
+## 3. Heredoc 引号规则
+
+### 禁止变量展开（推荐默认）
+
+```bash
+# ✅ 'EOF' 带引号：内容原样输出，不解析变量
+sudo tee /etc/xxx > /dev/null << 'EOF'
+$HOME 不会被展开
+$(command) 不会被执行
+EOF
+```
+
+### 需要变量展开
+
+```bash
+# EOF 不带引号：变量会被展开
+sudo tee /etc/xxx > /dev/null << EOF
+当前用户: $USER
+当前目录: $(pwd)
+EOF
+```
+
+### 选择原则
+
+| 场景 | 用法 | 原因 |
+|------|------|------|
+| 配置文件 | `<< 'EOF'` | 避免意外展开 |
+| 模板生成 | `<< EOF` | 需要插入变量 |
+| 不确定时 | `<< 'EOF'` | 更安全 |
+
+---
+
+## 4. 权限与路径
+
+### 需要 root 权限
+
+```bash
+# ✅ 正确：tee 配合 sudo
+echo 'content' | sudo tee /etc/xxx
+
+# ❌ 错误：重定向在 sudo 之外，权限不足
+sudo echo 'content' > /etc/xxx
+```
+
+### 路径带空格
+
+```bash
+# ✅ 正确：双引号包裹路径
+sudo tee "/etc/my config/file.conf" > /dev/null << 'EOF'
+content
+EOF
+```
+
+---
+
+## 5. 脚本规范
+
+### 文件头
+
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+
+# 脚本说明（一句话）
+```
+
+### set 选项说明
+
+| 选项 | 作用 |
+|------|------|
+| `-e` | 命令失败时退出 |
+| `-u` | 使用未定义变量时报错 |
+| `-o pipefail` | 管道中任一命令失败则整体失败 |
+
+### 变量使用
+
+```bash
+# ✅ 推荐：使用 ${} 包裹
+echo "Hello, ${name}"
+
+# ✅ 推荐：设置默认值
+db_host="${DB_HOST:-localhost}"
+
+# ❌ 避免：裸变量（易与后续字符混淆）
+echo "Hello, $name_suffix"
+```
+
+---
+
+## 6. 常用模式
+
+### 检查命令是否存在
+
+```bash
+if ! command -v docker &> /dev/null; then
+    echo "docker 未安装"
+    exit 1
+fi
+```
+
+### 检查文件/目录
+
+```bash
+# 文件存在
+[[ -f /path/to/file ]] && echo "文件存在"
+
+# 目录存在
+[[ -d /path/to/dir ]] || mkdir -p /path/to/dir
+```
+
+### 安全删除
+
+```bash
+# ✅ 使用变量时防止误删
+rm -rf "${dir:?}"/*
+
+# ❌ 危险：变量为空时会删除根目录
+rm -rf $dir/*
+```
+
+---
+
+## 7. 文档中的代码块
+
+在 Markdown 文档中编写 bash 命令时，同样遵循以上规范：
+
+````markdown
+## 安装配置
+
+创建配置文件：
+
+```bash
+sudo tee /etc/myapp/config.yml > /dev/null << 'EOF'
+server:
+  port: 8080
+  host: 0.0.0.0
+EOF
+```
+````
+
+---
+
+## 参考资料
+
+- [Google Shell Style Guide](https://google.github.io/styleguide/shellguide.html)
+- [Bash Pitfalls](https://mywiki.wooledge.org/BashPitfalls)
+- [ShellCheck](https://www.shellcheck.net/)

package/templates/claude/skills/brainstorming/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: brainstorming
+description: "在任何创意工作之前必须使用此技能 - 包括头脑风暴、功能设计、需求分析、创建功能、构建组件、添加功能或修改行为或提及想开发一个/想做一个等相关语义相近时。任何跟功能设计探讨时需使用。在实现之前探索用户意图、需求和设计。"
+---
+
+# 头脑风暴：从想法到设计
+
+## 概述
+
+通过自然的协作对话，帮助将想法转化为完整的设计和规格说明。
+
+首先了解当前项目上下文，然后逐一提问以完善想法。一旦理解要构建的内容，分小节（200-300 词）呈现设计，每节之后确认目前是否正确。
+
+## 流程
+
+**理解想法：**
+- 首先查看当前项目状态（文件、文档、最近提交）
+- 逐一提问以完善想法
+- 尽可能使用选择题，开放式问题也可以
+- 每条消息只问一个问题 - 如果某个主题需要深入探索，拆分为多个问题
+- 聚焦于理解：目的、约束条件、成功标准
+
+**探索方案：**
+- 提出 2-3 种不同方案及其权衡取舍
+- 以对话方式呈现选项，附上你的推荐和理由
+- 先给出推荐方案并解释原因
+
+**呈现设计：**
+- 一旦你认为理解了要构建的内容，呈现设计
+- 分成 200-300 词的小节
+- 每节之后询问目前是否正确
+- 涵盖：架构、组件、数据流、错误处理、测试
+- 如有不清楚的地方，随时返回澄清
+
+## 设计完成后
+
+**文档：**
+
+- 将验证通过的设计写入 `.claude/brainstorming-plan/YYYY-MM-DD-<主题>-design.md`
+
+## 核心原则
+
+- **一次一问** - 不要用多个问题让人应接不暇
+- **优先选择题** - 在可能的情况下，比开放式问题更容易回答
+- **严格遵循 YAGNI** - 从所有设计中移除不必要的功能
+- **探索替代方案** - 在确定之前始终提出 2-3 种方案
+- **增量验证** - 分节呈现设计，逐节验证
+- **保持灵活** - 当某处不合理时，返回澄清

package/templates/claude/skills/dotnet-dev/SKILL.md

@@ -0,0 +1,250 @@
+---
+name: dotnet-dev
+description: .NET Core 开发规范，包含命名约定、异常处理、Furion + SqlSugar 最佳实践等
+version: v3.0
+paths:
+  - "**/*.cs"
+  - "**/*.csproj"
+  - "**/*.sln"
+  - "**/appsettings.json"
+  - "**/appsettings.*.json"
+---
+
+# .NET Core 开发规范
+
+> 参考来源: Microsoft C# 编码约定、Furion 官方文档
+
+---
+
+## 工具链
+
+```bash
+# dotnet CLI
+dotnet build                         # 编译
+dotnet test                          # 运行测试
+dotnet run                           # 运行项目
+dotnet publish -c Release            # 发布
+
+# 格式化与分析
+dotnet format                        # 格式化代码
+dotnet build /p:TreatWarningsAsErrors=true  # 严格检查
+```
+
+---
+
+## 命名约定
+
+| 类型 | 规则 | 示例 |
+|------|------|------|
+| 命名空间 | PascalCase，公司.产品.模块 | `MyCompany.Project.Services` |
+| 类/接口 | PascalCase，名词/名词短语 | `UserService`, `IUserRepository` |
+| 方法名 | PascalCase，动词开头 | `FindById`, `IsValid` |
+| 常量 | PascalCase | `MaxRetryCount` |
+| 私有字段 | _camelCase 前缀下划线 | `_userRepository` |
+| 布尔属性 | Is/Has/Can 前缀 | `IsActive`, `HasPermission` |
+
+---
+
+## 类成员顺序
+
+```csharp
+public class Example
+{
+    // 1. 常量
+    public const string DefaultName = "value";
+
+    // 2. 静态字段
+    private static readonly ILogger<Example> _logger;
+
+    // 3. 实例字段
+    private readonly IUserRepository _userRepository;
+    private long _id;
+
+    // 4. 构造函数
+    public Example(IUserRepository userRepository)
+    {
+        _userRepository = userRepository;
+    }
+
+    // 5. 属性
+    public long Id { get; set; }
+
+    // 6. 公共方法
+    public void DoSomething() { }
+
+    // 7. 私有方法
+    private void HelperMethod() { }
+}
+```
+
+---
+
+## 异常处理
+
+```csharp
+// ✅ 好：捕获具体异常，添加上下文
+try
+{
+    user = await _userRepository.FindByIdAsync(id);
+}
+catch (DbException ex)
+{
+    throw new ServiceException($"Failed to find user: {id}", ex);
+}
+
+// ✅ 好：资源自动释放
+await using var stream = File.OpenRead(filePath);
+
+// ❌ 差：捕获过宽
+catch (Exception ex) { Console.WriteLine(ex); }
+```
+
+---
+
+## 空值处理
+
+```csharp
+// ✅ 使用 Nullable Reference Types
+public User? FindById(long id)
+{
+    return _userRepository.FindById(id);
+}
+
+// ✅ 参数校验
+public void UpdateUser(User user)
+{
+    ArgumentNullException.ThrowIfNull(user);
+}
+
+// ✅ 安全的空值处理
+var name = user?.Name ?? "Unknown";
+```
+
+---
+
+## 异步编程
+
+```csharp
+// ✅ 使用 async/await
+public async Task<User> GetUserAsync(long id)
+{
+    return await _userRepository.FindByIdAsync(id);
+}
+
+// ✅ 并行执行
+var tasks = userIds.Select(id => GetUserAsync(id));
+var users = await Task.WhenAll(tasks);
+
+// ❌ 差：阻塞异步调用
+var user = GetUserAsync(id).Result;  // 可能死锁
+```
+
+---
+
+## 测试规范 (xUnit)
+
+```csharp
+public class UserServiceTests
+{
+    [Fact]
+    public async Task FindById_WhenUserExists_ReturnsUser()
+    {
+        // Arrange
+        var mockRepo = new Mock<IUserRepository>();
+        mockRepo.Setup(r => r.FindByIdAsync(1L))
+            .ReturnsAsync(new User { Id = 1, Name = "test" });
+        var service = new UserService(mockRepo.Object);
+
+        // Act
+        var result = await service.FindByIdAsync(1L);
+
+        // Assert
+        Assert.NotNull(result);
+        Assert.Equal("test", result.Name);
+    }
+}
+```
+
+---
+
+## Furion 框架规范
+
+```csharp
+// ✅ 动态 API（自动生成路由）
+[DynamicApiController]
+public class UserService : IDynamicApiController
+{
+    private readonly ISqlSugarRepository<User> _repository;
+
+    public UserService(ISqlSugarRepository<User> repository)
+    {
+        _repository = repository;
+    }
+
+    // GET /api/user/{id}
+    public async Task<User> GetAsync(long id)
+    {
+        return await _repository.GetByIdAsync(id);
+    }
+
+    // POST /api/user
+    public async Task<long> AddAsync(UserDto dto)
+    {
+        var user = dto.Adapt<User>();
+        return await _repository.InsertReturnIdentityAsync(user);
+    }
+}
+
+// ✅ 传统 Controller（需要更多控制时）
+[ApiController]
+[Route("api/[controller]")]
+public class UsersController : ControllerBase
+{
+    [HttpGet("{id}")]
+    public async Task<ActionResult<UserDto>> GetById(long id)
+    {
+        var user = await _userService.GetAsync(id);
+        return user is null ? NotFound() : Ok(user);
+    }
+}
+```
+
+---
+
+## 性能优化
+
+| 陷阱 | 解决方案 |
+|------|---------|
+| N+1 查询 | 使用 Includes() 或导航属性 |
+| 循环拼接字符串 | 使用 `StringBuilder` |
+| 频繁装箱拆箱 | 使用泛型集合 |
+| 未使用异步 IO | 使用 async/await |
+
+---
+
+## 日志规范
+
+```csharp
+// ✅ 结构化日志
+_logger.LogDebug("Finding user by id: {UserId}", userId);
+_logger.LogInformation("User {Username} logged in", username);
+_logger.LogError(exception, "Failed to process order {OrderId}", orderId);
+
+// ❌ 差：字符串拼接
+_logger.LogDebug("Finding user by id: " + userId);
+```
+
+---
+
+## 详细参考
+
+完整规范见 `references/dotnet-style.md`，包含：
+- 完整命名约定和示例
+- 详细异常处理模式
+- Furion 动态 API 最佳实践
+- 异步编程详解
+- SqlSugar ORM 使用
+
+---
+
+> 📋 本回复遵循：`dotnet-dev` - [具体章节]