Standards 是面向中文开发者、项目发起者、研究者、维护者与采用者的工程与组织规范体系,把适用条件、实施要求、失败恢复和验收接口连在一起,供人类、Agent及混合团队在研发、科研、产品、商业履约、开放协作和生产运营中选用。
项目治理覆盖仓库与维护过程;L0–L3组织体系、治理、协作和通用工程;L4提供十六技术领域;L5适配技术栈;L6把选定条款转成项目采用与实现验收合同。已有行业标准按准确版本和有限命题引用。
发行集合版本为 0.1.2,162 份现行规范全部已采用。 单份规范的准确版本与摘要以登记为准。 从规范目录查看文档身份与适用领域,按采用接口选择项目需要的条款,使用项目采用模板记录项目选择。正式发行记录见 GitHub Releases。
运行工具需要 Python 3.12,仅使用标准库。在线阅读不需要安装;正式发行包解压即用,无需账号、凭据或环境变量。
- 从 Standards v0.1.2 下载
Standards-v0.1.2-source.zip和SHA256SUMS.txt。 - 按离线使用说明核对 SHA-256 并解压。
- 在解压后的
Standards-v0.1.2/运行包级校验,再进入源码目录执行一次最小查询:
python -X utf8 -B verify.py
cd source
python -X utf8 -B tools/skill_lookup.py --document-id STD-PG-005 --clause-id PGE-05两条命令均应以退出码 0 结束;查询结果包含 STD-PG-005、PGE-05、准确版本、文件路径和正文行段。校验失败时不要使用该副本,重新从同一 Release 取得文件并核对摘要。
- 找到任务。 从下方领域或项目治理总则选择相关内容,先读适用与不适用范围。
- 固定要求。 记录文档ID、准确版本、内容摘要与条款ID;按采用接口说明项目输入、责任人、判据和不适用理由。
- 实施并留证。 执行适用要求,分别记录通过、失败、未知和未执行;不要用文档检查代替目标系统验收。
维护仓库时,在仓库根目录使用 Python 3.12(非优化模式)检查当前文档、登记和工具:
python -X utf8 -B checks/validate_all.py
python -X utf8 -B -m unittest discover -s tests -v第一条核对当前目录、链接、schema和合同绑定;第二条运行测试。各类目标、可选环境和结果说明见验证指南。
-
原生平台验收: 编码、路径与离线消费者
项目按实际组成选择相应领域。
- Web前端与用户交互
- 后端与分布式系统
- 数据库与数据工程
- 云基础设施与DevOps
- AI应用与Agent系统
- 模型训练与AI科研
- 桌面与跨平台软件
- 移动应用
- 游戏开发与数字内容
- CLI、SDK与开发工具
- 网络与实时通信
- 安全工程与身份系统
- 自动化与系统集成
- 嵌入式与边缘计算
- 商业交易与计费系统
- 开源项目与公共技术生态
这些领域正文目前以中文提供;已具备英文全文的项目治理专项见语言可用性。
工具采用 Python 3.12 标准库,规范以 Markdown 编制,登记与合同使用 JSON 和有限的 JSON Schema 校验。消费包提供 Source 与 Agent Skill 两种形态。
RFC 与 SSDF 徽章表示已说明范围的参考。中文规范性用语由本体系定义,SSDF 仅引用选定实践。徽章的对象、证据与维护方式见徽章说明。
standards/是正式规范正文的唯一入口,registry/登记文档身份、条款和关系,sources/说明引用依据,guides/与templates/提供使用方法。采用时使用文档 ID、版本与内容摘要定位准确对象。
从贡献指南开始,针对具体条款提出问题、机制或可复验案例。贡献授权与材料来源按实际条款确认,不以提交动作自动推定额外协议。行为准则说明协作边界。
请按安全报告说明处理敏感缺陷,不在普通公开讨论中粘贴秘密。该页列报告字段、可用渠道与支持范围。
Standards 采用双许可证分域:项目自有的规范、文档、译文、模板、治理/规范数据与视觉资源主要采用 CC BY 4.0;校验器、工具、测试、自动化、可执行示例与软件型 Schema 主要采用 Apache-2.0。主仓及正式 Source/Agent Skill 消费包按对应许可授权公开再分发;第三方材料仍适用自身条件。见根许可分配、许可状态与权属、第三方材料及贡献授权。
