mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-22 02:24:30 +08:00
- 在贡献指南中添加开发环境能力清单链接和说明 - 创建详细的开发环境能力清单文档,记录项目所需的运行时和工具 - 添加 .ai/environment/tools.ai.yaml 文件,为 AI 提供精简的环境能力信息 - 添加 .ai/environment/tools.raw.yaml 文件,存储完整的环境检测数据 - 创建 collect-dev-environment.sh 脚本,用于收集和输出环境信息 - 创建 generate-ai-environment.py 脚本,从原始数据生成 AI 友好的环境清单 - 在 .gitignore 中添加 .venv/ 工具目录忽略规则
63 lines
1.8 KiB
YAML
63 lines
1.8 KiB
YAML
schema_version: 1
|
|
generated_at_utc: "2026-03-21T04:01:27Z"
|
|
generated_from: ".ai/environment/tools.raw.yaml"
|
|
generator: "scripts/generate-ai-environment.py"
|
|
platform:
|
|
family: "wsl-linux"
|
|
os: "Linux"
|
|
distro: "Ubuntu 24.04.4 LTS"
|
|
shell: "bash"
|
|
capabilities:
|
|
dotnet: true
|
|
python: true
|
|
node: true
|
|
bun: true
|
|
docker: true
|
|
fast_search: true
|
|
json_cli: true
|
|
tool_selection:
|
|
search:
|
|
preferred: "rg"
|
|
fallback: "grep"
|
|
use_for: "Repository text search."
|
|
json:
|
|
preferred: "jq"
|
|
fallback: "python3"
|
|
use_for: "Inspecting or transforming JSON command output."
|
|
shell:
|
|
preferred: "bash"
|
|
fallback: "sh"
|
|
use_for: "Repository shell scripts and command execution."
|
|
scripting:
|
|
preferred: "python3"
|
|
fallback: "bash"
|
|
use_for: "Non-trivial local automation and helper scripts."
|
|
docs_package_manager:
|
|
preferred: "bun"
|
|
fallback: "npm"
|
|
use_for: "Installing and previewing the docs site."
|
|
build_and_test:
|
|
preferred: "dotnet"
|
|
fallback: "unavailable"
|
|
use_for: "Build, test, restore, and solution validation."
|
|
python:
|
|
available: true
|
|
helper_packages:
|
|
requests: true
|
|
rich: true
|
|
openai: false
|
|
tiktoken: false
|
|
pydantic: false
|
|
pytest: false
|
|
preferences:
|
|
prefer_project_listed_tools: true
|
|
prefer_python_for_non_trivial_automation: true
|
|
avoid_unlisted_system_tools: true
|
|
rules:
|
|
- "Use rg instead of grep for repository search when rg is available."
|
|
- "Use jq for JSON inspection; fall back to python3 if jq is unavailable."
|
|
- "Prefer python3 over complex bash for non-trivial scripting when python3 is available."
|
|
- "Use bun for docs preview workflows when bun is available; otherwise fall back to npm."
|
|
- "Use dotnet for repository build and test workflows."
|
|
- "Do not assume unrelated system tools are part of the supported project environment."
|