structure-projects
Organizationstructure-projects 开源生态的 多技术栈 AI 规则集合。
Categories
Indexed Skills (50)
api-design
当用户要求"设计接口/定 API/写 OpenAPI/定义接口"时触发。 产出符合 RESTful 规范的 API 契约，含 OpenAPI 文档。 MUST 含版本号、幂等性、错误码、分页约定。
ci-pipeline-design
当用户要求"写流水线/加 CI/CD/GitHub Actions/构建流水线"时触发。 按生态三件套模板（build-and-push / release-maven / publish-npm）生成 GitHub Actions 流水线。 MUST 手动触发（workflow_dispatch），禁止自动触发发布。
database-design
当用户要求"设计表/加字段/写迁移/改表结构/设计索引"时触发。 产出数据库表设计与 Flyway 迁移脚本。 MUST 含审计字段、合适索引、逻辑删除。
database-migration-cd
当用户要求"数据库迁移 CD/Flyway 部署/数据库变更/数据库持续部署"时触发。 在 CI/CD 流水线中安全执行数据库迁移（Flyway），含回滚策略。
detailed-design
当用户要求"详细设计/LLD/类图/接口设计/时序图"时触发。 用于功能级详细设计：类图 + 接口定义 + 数据模型 + 时序图 + 错误处理。 产出 changes/proposals/<id>/design.md。
docker-cli
当用户要求"docker 命令/docker 操作/docker 构建/docker 运行/docker 日志"时触发。 提供 docker CLI 常用命令的安全使用方式。
docker-compose-design
当用户要求"写 docker-compose/编排服务/编写部署文件"时触发。 按生态规范生成 docker-compose.yml：统一网络 + 三件套 + 健康检查。
gh-release
当用户要求"打 tag/发 Release/发布版本/GitHub Release"时触发。 用 gh CLI 创建 GitHub Release，配合 changelog 生成 notes。 这是 SDLC 的最后一步：archive-change 之后可选调用。
helm-ops
当用户要求"helm 命令/helm 安装/helm 升级/helm 回滚/helm chart"时触发。 提供 helm 常用命令的安全使用方式，遵循生态 Helm Chart 双 workload 模板。
high-level-design
当用户要求"概要设计/HLD/架构设计/系统上下文/容器图/技术选型"时触发。 用于**新项目**或大版本重构：完成系统级架构设计。 产出系统上下文图 + 容器图 + 技术选型 + 数据流图。
hotfix-release
当用户要求"热修复/hotfix/紧急上线/线上 bug 修复"时触发。 按 Hotfix 快速通道 6 步流程执行，跳过完整 SDLC 但保留质量门禁。
jenkins-pipeline
当用户要求"Jenkins 流水线/Jenkinsfile/Jenkins 构建"时触发。 编写 Jenkins 声明式流水线，替代 GitHub Actions 场景。
k8s-deployment
当用户要求"写 K8s 部署/编写 K8s manifest/编写 Deployment/Service/Ingress"时触发。 按生态 Helm Chart 双 workload 模板生成 K8s manifest。 支持原生 YAML 和 Helm Chart 两种方式。
k8s-verification
当用户要求"验证 K8s 部署/检查 K8s 状态/K8s 健康检查"时触发。 验证 K8s 部署的健康状态：Pod / Service / Ingress / HPA / 日志。
kubectl-ops
当用户要求"kubectl 命令/k8s 操作/查看 pod/查看日志/k8s 部署"时触发。 提供 kubectl 常用命令的安全使用方式。
legacy-onboarding
当用户要求"接入老项目/老项目改造/项目迁移/规范接入/现状审计"时触发。 这是老项目接入的**核心技能**（第 7 个核心技能），串联完整接入流程： codebase-audit → migration-planning → retro-document（可选）→ 进入正常 SDLC。
module-decomposition
当用户要求"拆分模块/微服务划分/DDD 设计/模块划分/服务拆分"时触发。 按 DDD 7+1 或单体 4 模块规范拆分模块，产出模块依赖图。 MUST 识别 bounded context，禁止凭直觉拆分。
npm-publish
当用户要求"发布 npm 包/发 npm/npm publish"时触发。 按生态规范发布 npm 包到 npmjs.com：@structure-projects scope + 校验 + 验证。
requirement-analysis
当用户提出"新需求/新功能/新增/做个/实现/想要/feature"时触发。 MUST 在任何编码动作前调用本技能产出变更提案。 未产出 proposal 时禁止进入编码阶段。
scaffold-project
当用户要求"初始化项目/新建项目/搭建项目/scaffold/创建工程"时触发。 MUST 询问用户项目形态（DDD 7+1 / 单体多模块 / 单体单模块），禁止默认。 按 stack-constraints 和 project-scaffolding wiki 初始化项目结构。
rollback
当用户要求"回滚/回退/撤销发布"时触发。 按回滚决策树判断回滚方式并执行。
api-documentation
当用户要求"生成 API 文档/Swagger 文档/OpenAPI 文档"时触发。 生成符合 OpenAPI 规范的 API 文档。
archive-change
当变更完成（编码+测试+评审+部署）后触发。 MUST 归档提案到 changes/archive/，更新 changelog，检查并更新 README。 这是 SDLC 的最后一环，禁止跳过。
changelog-generation
当用户要求"生成 changelog/写变更日志/补 changelog"时触发。 按 Keep a Changelog 规范生成变更日志。
ci-gate
当用户要求"提交/commit/推送/push/合并/merge"时触发。 MUST 执行本地预检 + 物理拦截 + CI 监控。 紧急 hotfix 走快速 CI 通道（仅 MUST 检查）。
codebase-audit
当用户要求"扫描现状/代码审计/项目评估"时触发（legacy-onboarding 子技能）。 扫描老项目现状，产出 audit-report.md（规范符合性 + 测试覆盖 + CI/CD + 文档）。
coding
当用户要求"按提案实现/开始编码/写代码/实现"时触发。 MUST 在 changes/proposals/ 存在当前提案时才能执行。 按 tasks.md 逐项实现 + 写单测 + 本地验证。
create-feature
当用户要求"新建特性/新增子目录/新建功能模块/新建目录"时触发。 按目录类型识别结果创建对应结构：特性目录 / 子包 / 非代码目录。 MUST 先询问目录类型，禁止默认按"子包"处理。
debug-issue
当用户报告"报错/异常/不工作/有问题/bug/为什么 X"时触发。 系统性调试问题：收集信息 → 复现 → 定位 → 修复 → 验证。 禁止凭直觉猜测。
deployment-verification
当用户要求"部署/上线/发版/deploy/release/验证"时触发。 MUST 执行部署前检查 + 健康检查 + 回滚预案。 生产操作 MUST 用户确认。
dockerfile-writing
当用户要求"写 Dockerfile/Docker 化/容器化"时触发。 按生态双模板（后端 Spring Boot + 前端 Nginx）生成 Dockerfile。 MUST 含健康检查、时区、三件套（JAVA_OPTS/PARAMS/APP_PATH）。
e2e-testing
当用户要求"写 E2E 测试/端到端测试/Playwright/Cypress"时触发。 编写端到端用户场景测试。
expert-review
当用户要求"评审/看一下/检查/review/CR/审查代码"时触发。 MUST 对照变更提案评审代码，产出评审报告。 AI 自检 ≠ 专家评审：关键项目 MUST 引入人类评审。
gh-pr-workflow
当用户要求"提 PR/创建 PR/请求评审/合并 PR/关闭 PR"时触发。 用 gh CLI 完成 GitHub PR 全流程：创建 → 评审 → 修复 → 合并 → 清理。 MUST 用 gh 命令行（不用 Web 界面），保持留痕。
git-commit
按 Conventional Commits 规范生成提交信息并提交。当用户请求 commit/提交代码/总结变更/提交代码时触发。禁止跳过本技能直接执行裸 git commit。
git-workflow-decision
当用户要求"开始新任务/创建分支/新建功能"时触发。 按团队规模 + 任务时长判断走哪种 Git 流程：单人短线 / 单人长线 / 多人协作。 禁止默认推送 feat 分支到远程。
iac-terraform
当用户要求"Terraform/IaC/基础设施即代码/云资源编排"时触发。 编写 Terraform 配置，管理云资源。
integration-testing
当用户要求"写集成测试/IT/跨模块测试/Testcontainers"时触发。 编写跨模块 / 跨服务的集成测试，使用 Testcontainers 真实中间件。
maven-publish
当用户要求"发布 Maven 包/发 maven/maven deploy/发布到 Maven Central"时触发。 按生态规范发布 Java 包到 Maven Central（Sonatype OSSRH）。
migration-planning
当用户要求"制定迁移计划/规划迁移/迁移策略"时触发（legacy-onboarding 子技能）。 基于 audit-report 制定迁移计划：范围 + 策略 + 阶段 + 风险。
model-design
当用户要求"设计模型/建表/设计实体/加字段/设计 DTO/设计 VO"时触发。 产出领域模型与数据模型设计文档，融入当前变更提案。 MUST 按 DDD Entity/PO/DTO/VO ���层规范设计。
monitoring-setup
当用户要求"配置监控/接入 Prometheus/配置告警/接入 Grafana"时触发。 为服务配置监控、指标暴露、告警规则。
performance-testing
当用户要求"性能测试/压力测试/负载测试/JMeter/K6/Gatling"时触发。 编写性能测试，验证系统在高负载下的表现。
retro-document
当用户要求"反向生成文档/补架构图/补 ADR"时触发（legacy-onboarding 子技能，可选）。 为老项目反向生成架构文档、ADR、时序图，补充技术债。
review-fix-loop
当 expert-review 产出评审报告且包含 MUST fix 项时触发。 MUST 询问用户"是否修复"，确认后回到 coding 修复并复评。 形成"评审 → 修复 → 复评"的完整闭环。
sandbox-usage
当用户要求"使用沙箱/e2b/agentsphere/opensandbox/代码执行环境"时触发。 安全使用各类沙箱环境执行 AI 生成的代码。
unit-testing
当用户要求"写测试/补测试/跑测试/单测/write test/UT"时触发。 MUST 为新代码编写单元测试并验证覆盖率。 与 coding 技能并行执行。
log-analysis
当用户要求"分析日志/查日志/日志排查"时触发。 系统性分析应用日志定位问题。
performance-tuning
当用户要求"性能调优/性能优化/接口太慢/系统太慢"时触发。 系统性诊断与优化性能问题。
security-audit
当用户要求"安全审计/安全扫描/安全检查"时触发。 系统性检查代码 / 配置 / 依赖的安全问题。
Bio shown is the top-scored skill's repo description as a fallback — real GitHub bios land in a future update.