Skip to content
ranzevorPublic

About

面向人类、AI Agent 与混合团队的工程和组织规范体系,提供可采用条款、项目治理、离线检索与可验证发行。

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ranzevor Standards:工程与组织规范体系,文档和协作模块的连接插画

Documents: 162 adopted Version: 0.1.2 Docs & data: CC BY 4.0 Software: Apache-2.0 Python: 3.12 Documents: Markdown Contracts: JSON Schema Distribution: Agent Skill

Standards

English · 规范目录 · 快速开始 · 语言可用性

用途

Standards 是面向中文开发者、项目发起者、研究者、维护者与采用者的工程与组织规范体系,把适用条件、实施要求、失败恢复和验收接口连在一起,供人类、Agent及混合团队在研发、科研、产品、商业履约、开放协作和生产运营中选用。

项目治理覆盖仓库与维护过程;L0–L3组织体系、治理、协作和通用工程;L4提供十六技术领域;L5适配技术栈;L6把选定条款转成项目采用与实现验收合同。已有行业标准按准确版本和有限命题引用。

当前版本

发行集合版本为 0.1.2,162 份现行规范全部已采用。 单份规范的准确版本与摘要以登记为准。 从规范目录查看文档身份与适用领域,按采用接口选择项目需要的条款,使用项目采用模板记录项目选择。正式发行记录见 GitHub Releases。

快速开始

运行工具需要 Python 3.12,仅使用标准库。在线阅读不需要安装;正式发行包解压即用,无需账号、凭据或环境变量。

从正式发行包开始

  1. 从 Standards v0.1.2 下载 Standards-v0.1.2-source.zip 和 SHA256SUMS.txt。
  2. 按离线使用说明核对 SHA-256 并解压。
  3. 在解压后的 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 取得文件并核对摘要。

将规范用于项目

  1. 找到任务。 从下方领域或项目治理总则选择相关内容,先读适用与不适用范围。
  2. 固定要求。 记录文档ID、准确版本、内容摘要与条款ID;按采用接口说明项目输入、责任人、判据和不适用理由。
  3. 实施并留证。 执行适用要求,分别记录通过、失败、未知和未执行;不要用文档检查代替目标系统验收。

维护仓库时,在仓库根目录使用 Python 3.12(非优化模式)检查当前文档、登记和工具:

python -X utf8 -B checks/validate_all.py
python -X utf8 -B -m unittest discover -s tests -v

第一条核对当前目录、链接、schema和合同绑定;第二条运行测试。各类目标、可选环境和结果说明见验证指南。

按任务找入口

十六技术领域

项目按实际组成选择相应领域。

  1. Web前端与用户交互
  2. 后端与分布式系统
  3. 数据库与数据工程
  4. 云基础设施与DevOps
  5. AI应用与Agent系统
  6. 模型训练与AI科研
  7. 桌面与跨平台软件
  8. 移动应用
  9. 游戏开发与数字内容
  10. CLI、SDK与开发工具
  11. 网络与实时通信
  12. 安全工程与身份系统
  13. 自动化与系统集成
  14. 嵌入式与边缘计算
  15. 商业交易与计费系统
  16. 开源项目与公共技术生态

这些领域正文目前以中文提供;已具备英文全文的项目治理专项见语言可用性。

技术与规范关系

工具采用 Python 3.12 标准库,规范以 Markdown 编制,登记与合同使用 JSON 和有限的 JSON Schema 校验。消费包提供 Source 与 Agent Skill 两种形态。

References: RFC 2119 / RFC 8174 References: SSDF 1.1

RFC 与 SSDF 徽章表示已说明范围的参考。中文规范性用语由本体系定义,SSDF 仅引用选定实践。徽章的对象、证据与维护方式见徽章说明。

版本与维护

变更记录 · 离线使用 · 发行政策 · 维护支持

standards/是正式规范正文的唯一入口,registry/登记文档身份、条款和关系,sources/说明引用依据,guides/与templates/提供使用方法。采用时使用文档 ID、版本与内容摘要定位准确对象。

参与改进

从贡献指南开始,针对具体条款提出问题、机制或可复验案例。贡献授权与材料来源按实际条款确认,不以提交动作自动推定额外协议。行为准则说明协作边界。

安全问题

请按安全报告说明处理敏感缺陷,不在普通公开讨论中粘贴秘密。该页列报告字段、可用渠道与支持范围。

权属与许可

Standards 采用双许可证分域:项目自有的规范、文档、译文、模板、治理/规范数据与视觉资源主要采用 CC BY 4.0;校验器、工具、测试、自动化、可执行示例与软件型 Schema 主要采用 Apache-2.0。主仓及正式 Source/Agent Skill 消费包按对应许可授权公开再分发;第三方材料仍适用自身条件。见根许可分配、许可状态与权属、第三方材料及贡献授权。

About

面向人类、AI Agent 与混合团队的工程和组织规范体系,提供可采用条款、项目治理、离线检索与可验证发行。

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages