tools/community/sustainability-score, a repo/PR-level Sustainability Score reference implementation
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 25/100
- Issue 类型
- 功能
- 描述清晰度
- 需要澄清
- 活跃度
- 冷清
- 技术栈
- docker, github-actions, helm, javascript, python, terraform, typescript
调研方向
首先查看 SCI 规范,以及提案中提到的现有 green-code-skill 条目和已归档的 carbon-ci 条目。提议的入口点是一个新的 GitHub Action/CLI,支持 full-repository 和 PR-delta 模式;完成的标准是实现定义好的 v1 评分标准、带置信度标签的分数和 Markdown 报告,同时不接入云计费或实时电网强度集成。
由索引模型根据 Issue 内容生成。
描述
What it implements
An SCI-grounded (SCI = (E × I + M) / R, per the GSF SCI specification) scoring tool that evaluates a codebase's sustainability posture and produces a single, versioned, trackable score plus a prioritized recommendations report. It treats static-analysis signals (code complexity, dependency weight, Docker image composition, CI/CD pipeline design, IaC configuration) as labeled-confidence proxies for the SCI E term, never presented as audited carbon accounting, following the same estimate-with-disclosed-confidence posture the SCI spec itself recommends.
What form it takes
A GitHub Action / CLI tool that can run in two modes: (1) a one-time full-repo scan producing a baseline score, and (2) a PR-triggered delta scan that comments the sustainability-score change caused by that diff (the same workflow shape as existing coverage/security bots). Deterministic static analyzers do the measurable-fact extraction; an LLM pass (a documented, versioned system prompt) reasons over the structured findings to write the human-readable report and recommendations. The LLM never invents or re-derives numbers itself.
Workload/use case
General-purpose application repositories (language-agnostic core, initial reference implementation targets JS/TS + Python as the two most common ecosystems) that use Docker, a CI/CD pipeline (GitHub Actions initially), and optionally IaC (Terraform/Helm). Not scoped to a specific cloud provider for v1; cloud-billing integration is called out below as an explicit future phase, not part of this proposal.
Scope statement
In scope for v1: static repo scan, weighted rubric across five pillars (code/algorithmic efficiency, containerization, CI/CD, cloud/infra config as declared in code, SRE/ops signals such as health checks and rollback config), single numeric score plus confidence-tagged findings, and a Markdown report with PR-comment delta. Out of scope for v1: live cloud billing/telemetry integration and live grid carbon-intensity API calls (both flagged as data gaps in v1 output, not silently defaulted), and any claim of audited/precise carbon-emissions accounting.
How it relates to existing entries
Complements rather than duplicates tools/gsf/green-code-skill: that project is a design/review-time pattern advisor with no scoring or reporting output (explicitly out of scope per its own README); this project is the scoring/reporting layer that could sit downstream of it, potentially consuming its pattern catalog as one input source. Distinct from the archived Green-Software-Foundation/carbon-ci project, which attempted a narrower static-analysis-only version of PR carbon scoring; this proposal extends that idea to also cover containerization, CI/CD design, and SRE/ops practices in one unified score, and documents the estimate-confidence methodology carbon-ci did not fully specify before archival.
- 主要语言
- Python
- 星标
- 9
- 派生
- 1
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
Green-Software-Foundation/reference-implementations 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 70/100
查看 Green-Software-Foundation/reference-implementations 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 68/100
pyjanitor-devs/pyjanitor#1758 ·
维护者通常 1 天内回复
-
bug ready for review
难度 2/5 1-3 小时 新手友好度 86/100
odysseus-dev/odysseus#6641 ·
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 76/100
happypawspillaro/happypaws#78 ·
维护者通常 4 天内回复
-
pydanty:is-working
难度 2/5 1-3 小时 新手友好度 82/100
pydantic/pydantic-ai#10020 ·
维护者通常 1 天内回复
-
stdlib type-bug
难度 2/5 1-3 小时 新手友好度 68/100
python/cpython#159044 · 4 条评论 ·
维护者通常 1 天内回复