feat(language): 增加 Java 与 Python 技术提供方

2026-09-03 17:12:33 +08:00
parent 127bc4e7c1
commit 199a14daea
20 changed files with 208 additions and 0 deletions
@@ -0,0 +1,22 @@
+---
+name: profile
+description: 根据项目中的 Python、包管理、FastAPI 和测试工具证据提供版本匹配的设计、实现、测试和审查资料。适用于核心工作流请求 Python 技术能力；通用业务实现或无法确认 Python 项目时不应触发。
+---
+
+# Python Profile
+
+读取自身[能力清单](references/manifest.json)，根据目标模块的项目清单、锁文件和项目画像返回匹配能力。
+
+## 工作流
+
+1. 从 `pyproject.toml`、依赖文件、锁文件、版本文件和 `.craftkit/project.json` 提取证据。
+2. 只选择版本范围匹配的 Profile；版本未知时只使用版本中性资料。
+3. Ruff、mypy、pyright、Black 等工具只有在项目配置或依赖中存在时才作为可用命令。
+4. 按请求能力读取对应资料并返回逻辑资料标识、适用版本和证据。
+5. 缺失能力或版本不匹配时返回明确状态，不写项目文件。
+
+## 边界
+
+- 不默认最新 Python、FastAPI 或 Pydantic 版本。
+- 不安装解释器、包管理器、质量工具或项目依赖。
+- 不调用 `dev`，最终设计、实现、测试和审查由核心 Skill 负责。
@@ -0,0 +1,4 @@
+interface:
+  display_name: "Python Profile（python:profile）"
+  short_description: "按项目版本提供 Python 与 FastAPI 技术资料"
+  default_prompt: "使用 $profile 获取当前项目适用的 Python 技术能力。"
@@ -0,0 +1,7 @@
+# Python 后端设计资料
+
+- 从项目清单和锁文件确认 Python、框架、Pydantic 与数据访问工具版本。
+- 协议模型、领域输入输出和 ORM 模型保持边界，避免框架对象扩散到核心业务。
+- 同步与异步调用链必须一致；阻塞 I/O 不能未经处理进入异步请求路径。
+- 事务、幂等和外部调用失败恢复需要明确数据库约束与提交顺序。
+- 配置和依赖通过项目已有机制注入，不能在模块导入时连接真实外部资源。
@@ -0,0 +1,7 @@
+# Python 后端实现资料
+
+- 遵循项目现有包结构、类型标注和异常边界。
+- 资源使用上下文管理器或项目已有生命周期机制可靠释放。
+- 不混用不兼容的 Pydantic、FastAPI 或 ORM 版本写法。
+- 新增依赖前确认项目包管理工具、锁文件和用户授权。
+- 实现后运行项目已有的聚焦测试与检查命令。
@@ -0,0 +1,6 @@
+# Python 命令选择
+
+1. 从锁文件和 `pyproject.toml` 确定 uv、Poetry、PDM、Pipenv 或 pip。
+2. 优先使用项目脚本、任务入口和 CI 已执行命令。
+3. Ruff、mypy、pyright、Black 只有存在配置或依赖证据时才返回。
+4. Profile 不安装工具，也不把建议命令视为执行授权。
@@ -0,0 +1,3 @@
+# Python 回退
+
+版本未知时只使用 Python 版本中性规则。FastAPI、Pydantic、测试插件或包管理工具无法确认时不加载其专属写法，并说明缺少的项目证据。
@@ -0,0 +1,20 @@
+{
+  "schemaVersion": 1,
+  "provider": { "id": "python", "kind": "language", "displayName": "Python" },
+  "profiles": [
+    {
+      "id": "python/default",
+      "version": { "scheme": "pep440", "range": ">=3.9,<3.14" },
+      "priority": 10,
+      "detect": { "manifests": ["pyproject.toml", "requirements.txt"], "lockFiles": ["uv.lock", "poetry.lock", "pdm.lock", "Pipfile.lock"] },
+      "capabilities": {
+        "backend-design": "references/backend/design.md",
+        "backend-implementation": "references/backend/implementation.md",
+        "backend-testing": "references/testing/index.md",
+        "language-review": "references/review/index.md",
+        "command-resolution": "references/commands/index.md"
+      },
+      "fallback": "references/fallback.md"
+    }
+  ]
+}
@@ -0,0 +1,7 @@
+# Python 专项审查资料
+
+- 检查类型与空值、异常边界、资源生命周期、可变默认值和导入副作用。
+- 检查同步与异步混用、任务泄漏、取消处理和阻塞 I/O。
+- FastAPI 项目检查依赖生命周期、请求模型、响应序列化和后台任务边界。
+- ORM 代码检查事务所有权、会话生命周期、延迟加载和查询数量。
+- 只报告有代码证据和明确影响的问题。
@@ -0,0 +1,6 @@
+# Python 后端测试资料
+
+- 优先使用项目已配置的 pytest 或 unittest，不自行引入测试框架。
+- 异步代码只有在项目已配置对应插件和事件循环策略时使用异步测试写法。
+- 测试客户端、依赖覆盖和数据库隔离方式必须匹配当前 FastAPI 及相关依赖版本。
+- 外部依赖使用项目已有替身或隔离边界，不连接真实生产资源。
@@ -0,0 +1,24 @@
+---
+name: review-python
+description: 按项目 Python、框架和工具版本审查类型、异常、资源、异步、生命周期、事务和测试隔离问题。适用于 Python 专项代码审查；通用审查、直接实现或无法确认 Python 项目时不应触发。
+---
+
+# Python 专项审查
+
+先从项目清单、锁文件、源码和 `.craftkit/project.json` 确认 Python、框架及数据访问工具版本。
+
+## 工作流
+
+1. 确认审查范围、目标模块、Python 版本、框架、包管理工具和相关测试。
+2. 请求 `python:profile` 的 `language-review`；当前会话未发现提供方时说明缺口并使用本 Skill 的最小检查项。
+3. 检查类型与空值、异常边界、资源生命周期、可变默认值、导入副作用和公开契约。
+4. 异步代码检查阻塞 I/O、任务生命周期、取消处理及同步/异步边界。
+5. 框架和 ORM 代码按已确认版本检查依赖、请求、会话与事务生命周期。
+6. 只报告可复现、有代码证据且影响明确的问题，按严重度给出最小修复建议。
+7. 未运行静态检查或测试时明确说明，不自动修改代码。
+
+## 边界
+
+- 不默认最新 Python、FastAPI、Pydantic 或 ORM 行为。
+- 项目未配置 Ruff、mypy、pyright 或 Black 时，不把缺少这些工具本身报告为缺陷。
+- 不安装工具、修改依赖或连接真实外部资源。
@@ -0,0 +1,4 @@
+interface:
+  display_name: "Python Review（python:review-python）"
+  short_description: "按项目版本专项审查 Python 代码"
+  default_prompt: "使用 $review-python 按当前项目版本审查这段 Python 代码。"