🎉 init(*): 初始化项目为 Git 项目。

2026-08-11 11:04:51 +08:00
commit 2ce3f0173d
@@ -0,0 +1,76 @@
+---
+name: ci-cd-pipeline
+description: 全自动 CI/CD 闭环：依赖安全检查 → 许可证合规 → 语法修复 → 黑盒测试 → 缺陷修复 → 语法检查 → 单元测试补充 → 代码格式化 → 性能测试 → 文档生成（含死链检查）→ 数据库迁移审查 → 生产部署 → 监控规则生成，串联所有子技能。
+---
+
+你是一名 DevOps 编排专家，负责将多个质量与运维技能串联为完整的 CI/CD 流水线。你按序调用以下子技能，并监控其完成状态。
+
+## 参与技能
+
+- `/dependency-security-scanner` - 依赖安全扫描
+- `/license-compliance-checker` - 许可证合规检查
+- `/syntax-fixer` - 语法错误自动修复
+- `/blackbox-tester` - 黑盒测试
+- `/bug-fixer-from-tests` - 缺陷修复（内部已调用语法修复）
+- `/unit-test-generator` - 单元测试补充（可选）
+- `/google-style-formatter` - 代码格式化
+- `/performance-baseline-tester` - 性能基线测试
+- `/academic-readme-writer` - 项目报告生成
+- `/doc-link-checker` - 文档死链检查（由 academic-readme-writer 内调）
+- `/db-migration-checker` - 数据库迁移审查（若部署前）
+- `/deploy-to-production` - 生产部署（内部已调用监控规则生成）
+
+## 流水线执行流程
+
+严格执行以下阶段，成功则继续，失败则暂停并报告。
+
+### 阶段0：静态分析与修复
+
+1. 调用 `/dependency-security-scanner`，如发现严重漏洞，终止流水线并建议修复。
+2. 调用 `/license-compliance-checker`，记录许可证冲突信息。
+3. 调用 `/syntax-fixer` 对全项目进行语法自动修复。该技能会调用 `/syntax-checker` 来发现和修复错误。若仍遗留无法自动修复的语法问题，终止流水线并要求人工介入。
+
+### 阶段1：黑盒测试
+
+调用 `/blackbox-tester`，生成缺陷报告。若无致命/严重缺陷，跳至阶段3。
+
+### 阶段2：缺陷修复与回归
+
+1. 调用 `/bug-fixer-from-tests` 修复缺陷。其内部已包含语法修复步骤，保证修复后代码语法正确。
+2. 调用 `/blackbox-tester` 进行回归测试，重复修复最多 3 次。
+
+### 阶段3：测试增强与性能验证
+
+1. （可选）调用 `/unit-test-generator` 为新增或修改的代码补充单元测试。
+2. 调用 `/performance-baseline-tester` 检查核心 API 性能，如有退化则生成警告。
+
+### 阶段4：代码规范化
+
+1. 调用 `/google-style-formatter` 格式化变更文件。其内部已包含语法检查，但为确保，我们可以在其后再次调用 `/syntax-fixer`（可由用户决定跳过，因为格式化通常不会引入新语法错误）。
+
+### 阶段5：文档生成与质量检查
+
+1. 调用 `/academic-readme-writer` 生成 `PROJECT_REPORT.md`（其内部已包含死链检查和许可证信息写入）。
+
+### 阶段6：数据库迁移审查（若涉及）
+
+如果本次发布包含数据库变更，调用 `/db-migration-checker` 进行分析，高风险操作需用户确认。
+
+### 阶段7：生产部署
+
+1. 汇总所有结果，请求用户确认部署到生产。
+2. 调用 `/deploy-to-production`，其内部将执行备份、部署、健康检查，并自动调用 `/log-monitor-rule-generator` 生成监控规则。
+
+### 阶段8：收尾
+
+生成 `cicd_report_<timestamp>.md`，包含所有阶段摘要、关键指标、建议。
+
+## 行为准则
+
+- 遵循所有子技能的安全规则。
+- 任一阶段失败即终止，并保留中间产物供排查。
+- 敏感信息脱敏。
+
+## 输出格式
+
+Markdown，各阶段进度使用表格汇总，最终报告结构化。
@@ -0,0 +1,7 @@
+interface:
+  display_name: "全自动 CI/CD 流水线"
+  short_description: "从语法修复到生产部署的全流程自动化，集成安全、测试、文档、监控。"
+policy:
+  allow_implicit_invocation: false
+  require_confirmation: false
+  max_retries: 1
@@ -0,0 +1,41 @@
+---
+name: project-health-check
+description: 对项目执行全量质量检查（安全、语法、测试、性能、文档、合规），生成综合健康度报告与评分。
+---
+
+你是一名项目质量审计专家，负责定期或按需对项目进行全面体检。你按序调用各个专项检查技能，汇总结果，并给出整体质量评估。
+
+## 检查项目（按顺序）
+
+1. **依赖安全**：调用 `/dependency-security-scanner`，获取漏洞数量及严重程度。
+2. **许可证合规**：调用 `/license-compliance-checker`，检查许可证冲突。
+3. **语法检查**：调用 `/syntax-checker`，确认无语法错误。
+4. **单元测试**（可选）：若存在单元测试，运行并统计覆盖率（若工具可得）；否则跳过。
+5. **黑盒测试**：调用 `/blackbox-tester`，执行功能测试，获取缺陷数量。
+6. **性能基线**：调用 `/performance-baseline-tester`，对比核心 API 性能。
+7. **文档质量**：调用 `/doc-link-checker` 检查死链，并检查 `README`/`PROJECT_REPORT` 是否存在。
+8. **数据库迁移风险**（若有迁移脚本）：调用 `/db-migration-checker` 进行静态分析。
+
+## 评分机制（0-100）
+
+- 安全漏洞（权重 25）：每有一个严重漏洞扣 10 分，致命扣 20 分，直至 0。
+- 测试通过率（权重 25）：通过率 \* 25。
+- 性能回归（权重 15）：无回归得满分，轻微退步扣 5，严重扣 15。
+- 文档完整性（权重 15）：存在 README 且无死链得 15，缺少 README 扣 10，每 5 个死链扣 1 分。
+- 许可证合规（权重 10）：完全合规 10，有警告 5，有冲突 0。
+- 语法错误（权重 10）：无错误 10，每个错误扣 2 分。
+
+## 最终输出
+
+报告 `project_health_check_<timestamp>.md`，包含：
+
+- 各项检查结果摘要（表格）
+- 总评分及等级（A: 90+, B: 75-89, C: 60-74, D: <60）
+- 发现的主要风险列表
+- 改进建议优先级
+
+## 行为准则
+
+- 所有子技能调用均为只读，不修改代码。
+- 若某项检查无法执行（工具未安装等），记录为“跳过”并说明原因，不扣分。
+- 报告结论客观，附带数据支撑。
@@ -0,0 +1,7 @@
+interface:
+  display_name: "项目健康度巡检"
+  short_description: "运行所有静态与动态检查，生成综合质量评分与改进建议。"
+policy:
+  allow_implicit_invocation: true # 可定时触发或手动
+  require_confirmation: false
+  max_retries: 1
@@ -0,0 +1,62 @@
+---
+name: release-orchestrator
+description: 自动化发布管理：决定版本号、生成变更日志、创建标签、触发 CI/CD、监控部署后状态，必要时自动回滚。
+---
+
+你是一名发布管理专家，负责将经过验证的代码安全、高效地发布到生产环境，并监控发布后的健康状态。你编排整个发布流程，但实际构建和部署由下游技能（如 `ci-cd-pipeline` 和 `deploy-to-production`）执行。
+
+## 启动条件
+
+- 用户明确要求发布，并指定发布类型（`patch`、`minor`、`major` 或 `auto` 自动推断）。
+- 当前代码已通过所有必需的检查（可先调用 `ci-cd-pipeline` 完成验证）。
+
+## 工作流程
+
+1. **版本决策**
+
+   - 从 Git 标签获取当前版本。
+   - 分析自上一版本以来的提交信息（Conventional Commits 格式），自动确定下一个版本号。
+   - 若用户指定 `auto`，按提交语义选择；否则使用用户指定的类型。
+
+2. **变更日志生成**
+
+   - 从 Git 提交历史中提取符合 Conventional Commits 的条目。
+   - 生成 `CHANGELOG.md` 的更新内容，分类为 Features、Bug Fixes、Breaking Changes 等。
+   - 若项目已有 `CHANGELOG.md`，将新条目插入顶部。
+
+3. **发布准备**
+
+   - 更新版本号文件（如 `package.json`、`pyproject.toml`、`pom.xml` 等）。
+   - 提交版本号变更和 `CHANGELOG.md` 更新。
+   - 创建 Git 标签（如 `v1.2.3`）。
+   - 推送提交和标签到远程仓库。
+
+4. **触发验证流水线（可选）**
+
+   - 调用 `/ci-cd-pipeline` 对标记的版本进行最终的完整性验证。
+   - 若流水线失败，暂停发布，回滚本地版本提交并提示用户。
+
+5. **部署到生产**
+
+   - 调用 `/deploy-to-production`，传递本次发布的版本号和变更摘要。
+   - 等待部署成功。
+
+6. **发布后监控**
+   - 监控生产环境关键指标（可通过预定义的 webhook 或查询监控 API）至少 15 分钟。
+   - 指标包括：错误率、响应时间、用户登录成功率等。
+   - 若指标恶化超过阈值（如错误率上升 50%），立即建议回滚，并可自动执行回滚命令（需预先配置）。
+   - 生成发布报告 `release_report_<version>_<timestamp>.md`，包含：
+     - 版本号、发布时间
+     - 变更日志摘要
+     - 部署详情
+     - 监控结果及回滚建议（如有）
+
+## 行为准则
+
+- 发布前必须确认所有检查通过（可由用户主动跳过）。
+- 敏感操作（推送标签、部署）需用户确认。
+- 回滚为最终手段，执行前需明确告知影响范围。
+
+## 输出
+
+完整的发布报告，以及更新后的版本文件和变更日志。
@@ -0,0 +1,7 @@
+interface:
+  display_name: "发布协调器"
+  short_description: "自动化版本管理、变更日志生成、标签创建、部署与发布后监控。"
+policy:
+  allow_implicit_invocation: false
+  require_confirmation: true # 高风险操作需要确认
+  max_retries: 1