Skip to content

Eriemon/verilog-generator

readable-verilog-generator

Verified

Use when creating, writing, reviewing, annotating, repairing, refactoring, or validating readable Verilog RTL, including synthesizable Verilog-2001 .v files, existing-RTL analysis, semantic comment annotation, testbench scaffold planning, ASIC-quality review, local or remote Vivado/xsim validation, evidence-backed repair, and workflow trace diagnosis.

FileKindSize
SKILL.mdskill md21.3 KB
agents/openai.yamlconfig363 B
assets/examples/existing_rtl/fsm_without_default.vother761 B
assets/examples/existing_rtl/fsm_without_default_spec.mdmarkdown311 B
assets/examples/existing_rtl/leaf_counter.vother314 B
assets/examples/existing_rtl/missing_output_register.vother423 B
assets/examples/existing_rtl/missing_output_register_spec.mdmarkdown331 B
assets/examples/existing_rtl/ready_valid_slice.vother967 B
assets/examples/existing_rtl/ready_valid_slice_spec.mdmarkdown420 B
assets/examples/existing_rtl/reset_gap_counter.vother319 B
assets/examples/existing_rtl/reset_gap_counter_spec.mdmarkdown212 B
assets/examples/existing_rtl/tb_ready_valid_slice.vother846 B
assets/examples/existing_rtl/top_counter.vother271 B
assets/examples/existing_rtl/traffic_light.vother2.5 KB
assets/examples/existing_rtl/traffic_light_spec.mdmarkdown585 B
assets/examples/readme/axis_packet_meter.vother10.2 KB
assets/examples/remote_fixtures/comb_hierarchy_budget/generated/rtl/comb_hierarchy_budget.vother1.9 KB
assets/examples/remote_fixtures/comb_hierarchy_budget/generated/tb/tb_comb_hierarchy_budget.vother2.5 KB
assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_child_loop.vother447 B
assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_over_budget.vother527 B
assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_q_cut.vother467 B
assets/examples/remote_fixtures/comb_hierarchy_budget/hierarchy_within_budget.vother450 B
assets/examples/remote_fixtures/comb_hierarchy_budget/spec.jsonconfig1.7 KB
assets/examples/remote_fixtures/comb_operation_budget/comb_operation_budget_bad.vother187 B
assets/examples/remote_fixtures/comb_operation_budget/generated/rtl/comb_operation_budget.vother6.1 KB
assets/examples/remote_fixtures/comb_operation_budget/generated/tb/tb_comb_operation_budget.vother5.7 KB
assets/examples/remote_fixtures/comb_operation_budget/spec.jsonconfig2.9 KB
assets/examples/remote_fixtures/comb_parity_mux/generated/rtl/comb_parity_mux.vother2.1 KB
assets/examples/remote_fixtures/comb_parity_mux/generated/tb/tb_comb_parity_mux.vother2.8 KB
assets/examples/remote_fixtures/comb_parity_mux/spec.jsonconfig1.9 KB
assets/examples/remote_fixtures/pipeline_delay/generated/rtl/pipeline_delay.vother4.5 KB
assets/examples/remote_fixtures/pipeline_delay/generated/tb/tb_pipeline_delay.vother2.6 KB
assets/examples/remote_fixtures/pipeline_delay/spec.jsonconfig2.2 KB
assets/examples/remote_fixtures/ready_valid_slice/generated/rtl/ready_valid_slice.vother5.2 KB
assets/examples/remote_fixtures/ready_valid_slice/generated/tb/tb_ready_valid_slice.vother2.9 KB
assets/examples/remote_fixtures/ready_valid_slice/spec.jsonconfig2.6 KB
assets/examples/rtl_erie_verilog_spec.jsonconfig2.1 KB
assets/examples/use_case_templates/jesd_adc.jsonconfig2.4 KB
assets/examples/use_case_templates/jesd_dac.jsonconfig2.5 KB
assets/examples/use_case_templates/mxfe_mixed.jsonconfig2.7 KB
assets/examples/use_case_templates/spi_adc.jsonconfig2.8 KB
assets/examples/use_case_templates/spi_dac.jsonconfig2.7 KB
assets/examples/verilog_pattern_templates/axi4_lite_csr.jsonconfig2.1 KB
assets/examples/verilog_pattern_templates/axi_interconnect_dma.jsonconfig2.3 KB
assets/examples/verilog_pattern_templates/axis_ready_valid.jsonconfig2.3 KB
assets/examples/verilog_pattern_templates/conv_load_store.jsonconfig1.8 KB
assets/external_interface_catalog.jsonconfig2.9 KB
assets/ideal_bad_style_metrics.jsonconfig17.5 KB
assets/installer/manifest.projection.jsonconfig2.8 KB
assets/installer/platforms.jsonconfig1.3 KB
assets/interface_templates/ahb_lite_config.vincother2.3 KB
assets/interface_templates/apb_config.vincother861 B
assets/interface_templates/axi4_full_master.vincother1.8 KB
assets/interface_templates/axi4_full_slave.vincother1.8 KB
assets/interface_templates/axi4_lite_config.vincother1.6 KB
assets/interface_templates/axi_stream_duplex.vincother1.1 KB
assets/interface_templates/catalog.jsonconfig2.6 KB
assets/project_ip_interface_manifest.template.jsonconfig9.4 KB
assets/readme-workflow.pngbinary1.4 MB
assets/readme/design-profile-cn.pngbinary1.4 MB
assets/readme/design-profile.pngbinary1.4 MB
assets/readme/evidence-guard-cn.pngbinary1.4 MB
assets/readme/evidence-guard.pngbinary1.4 MB
assets/readme/hero-overview-cn.pngbinary1.5 MB
assets/readme/hero-overview.pngbinary1.5 MB
assets/readme/project-facts-cn.pngbinary1.2 MB
assets/readme/project-facts.pngbinary1.3 MB
assets/readme/rule-rendering-cn.pngbinary1.4 MB
assets/readme/rule-rendering.pngbinary1.2 MB
assets/style_templates/header_prompt_none_mode.txtmarkdown2.1 KB
assets/style_templates/header_prompt_table_mode.txtmarkdown2.5 KB
assets/style_templates/rtl_bus_grouping.tplother1.0 KB
assets/style_templates/rtl_fsm.tplother832 B
assets/style_templates/rtl_header_bilingual.tplother1.6 KB
assets/style_templates/rtl_instantiation.tplother496 B
assets/style_templates/rtl_region_order.tplother987 B
assets/use_case_templates/catalog.jsonconfig2.8 KB
assets/use_case_templates/jesd_adc/README.mdmarkdown699 B
assets/use_case_templates/jesd_adc/constraints/system_constr.xdcother454 B
assets/use_case_templates/jesd_adc/manifest.jsonconfig1.7 KB
assets/use_case_templates/jesd_adc/tcl/common_bd.tclother4.0 KB
assets/use_case_templates/jesd_adc/tcl/system_bd.tclother920 B
assets/use_case_templates/jesd_adc/tcl/system_project.tclother1.0 KB
assets/use_case_templates/jesd_adc/verilog/system_top.vother2.9 KB
assets/use_case_templates/jesd_dac/README.mdmarkdown745 B
assets/use_case_templates/jesd_dac/constraints/system_constr.xdcother299 B
assets/use_case_templates/jesd_dac/manifest.jsonconfig1.7 KB
assets/use_case_templates/jesd_dac/tcl/common_bd.tclother4.8 KB
assets/use_case_templates/jesd_dac/tcl/system_bd.tclother923 B
assets/use_case_templates/jesd_dac/tcl/system_project.tclother1.1 KB
assets/use_case_templates/jesd_dac/verilog/system_top.vother2.9 KB
assets/use_case_templates/mxfe_mixed/README.mdmarkdown739 B
assets/use_case_templates/mxfe_mixed/constraints/system_constr.xdcother380 B
assets/use_case_templates/mxfe_mixed/manifest.jsonconfig1.8 KB
assets/use_case_templates/mxfe_mixed/tcl/common_bd.tclother5.4 KB
assets/use_case_templates/mxfe_mixed/tcl/system_bd.tclother1.2 KB
assets/use_case_templates/mxfe_mixed/tcl/system_project.tclother1.2 KB
assets/use_case_templates/mxfe_mixed/verilog/system_top.vother3.4 KB
assets/use_case_templates/spi_adc/README.mdmarkdown925 B
assets/use_case_templates/spi_adc/constraints/system_constr.xdcother635 B
assets/use_case_templates/spi_adc/manifest.jsonconfig1.7 KB
assets/use_case_templates/spi_adc/tcl/common_bd.tclother6.3 KB
assets/use_case_templates/spi_adc/tcl/system_bd.tclother1.6 KB
assets/use_case_templates/spi_adc/tcl/system_project.tclother982 B
assets/use_case_templates/spi_adc/verilog/system_top.vother4.2 KB
assets/use_case_templates/spi_dac/README.mdmarkdown757 B
assets/use_case_templates/spi_dac/constraints/system_constr.xdcother546 B
assets/use_case_templates/spi_dac/manifest.jsonconfig1.6 KB
assets/use_case_templates/spi_dac/tcl/common_bd.tclother5.7 KB
assets/use_case_templates/spi_dac/tcl/system_bd.tclother1.0 KB
assets/use_case_templates/spi_dac/tcl/system_project.tclother981 B
assets/use_case_templates/spi_dac/verilog/system_top.vother3.5 KB
assets/verilog_formatter_config/defaults.jsonconfig6.2 KB
assets/verilog_formatter_config/profiles/conservative.jsonconfig283 B
assets/verilog_formatter_config/profiles/example_compat.jsonconfig484 B
assets/verilog_formatter_config/profiles/formatter-lint.jsonconfig121 B
assets/verilog_formatter_config/profiles/formatter-normalize.jsonconfig182 B
assets/verilog_formatter_config/profiles/formatter-preserve.jsonconfig385 B
assets/verilog_formatter_config/profiles/formatting.jsonconfig270 B
assets/verilog_formatter_config/profiles/lint.jsonconfig269 B
assets/verilog_formatter_config/profiles/migration.jsonconfig239 B
assets/verilog_formatter_config/profiles/stress_cases_compat.jsonconfig484 B
assets/verilog_formatter_config/profiles/vitis-wrapper.jsonconfig486 B
assets/verilog_formatter_config/schema.jsonconfig13.7 KB
assets/verilog_formatter_config/templates/task-batch.jsonconfig212 B
assets/verilog_formatter_config/templates/task-inplace.jsonconfig221 B
assets/verilog_formatter_config/templates/task-single-file.jsonconfig220 B
assets/verilog_pattern_templates/axi4_lite_csr_shell.vincother562 B
assets/verilog_pattern_templates/axi_interconnect_port_groups.vincother592 B
assets/verilog_pattern_templates/axis_ready_valid_slice.vincother494 B
assets/verilog_pattern_templates/catalog.jsonconfig2.2 KB
assets/verilog_pattern_templates/conv_load_store_pipeline.vincother457 B
assets/verilog_pattern_templates/counter_state_bridge.vincother443 B
assets/verilog_pattern_templates/equivalence_wrapper_probe.vincother306 B
assets/verilog_pattern_templates/fsm_state_transition.vincother1.0 KB
assets/verilog_pattern_templates/phase_output_registering.vincother404 B
assets/verilog_pattern_templates/wrapper_top_stitching.vincother608 B
assets/verilog_quality_gates.jsonconfig38.2 KB
assets/verilog_style_rules.jsonconfig11.8 KB
assets/xilinx_primitive_semantics.jsonconfig21.4 KB
references/checklists/capability-distillation-checklist.mdmarkdown3.0 KB
references/checklists/lint-checklist.mdmarkdown3.6 KB
references/checklists/verilog-readability-gate.mdmarkdown3.5 KB
references/corpus/verilog-style-observations.mdmarkdown4.6 KB
references/integration/configuration.mdmarkdown19.9 KB
references/integration/host-integration.mdmarkdown10.6 KB
references/rules/asic-verilog-quality.mdmarkdown3.9 KB
references/rules/erie-style.mdmarkdown6.3 KB
references/rules/testbench-patterns.mdmarkdown3.2 KB
references/rules/verilog-code-comment-naming-standard.mdmarkdown55.6 KB
references/rules/verilog-comment-placement.mdmarkdown8.4 KB
references/rules/verilog-pattern-templates.mdmarkdown1.1 KB
references/rules/verilog-quality-gates.mdmarkdown21.4 KB
references/rules/xilinx-primitive-exemptions.mdmarkdown10.6 KB
references/skill/installation.mdmarkdown6.1 KB
references/skill/script-guide.mdmarkdown7.5 KB
references/skill/skill-standards.mdmarkdown2.1 KB
references/workflows/verilog_dispatcher.mdmarkdown6.4 KB
references/workflows/workflow-contracts.mdmarkdown15.1 KB
scripts/__init__.pyscript53 B
scripts/python/__init__.pyscript55 B
scripts/python/corpus/analyze_verilog_style_corpus.pyscript25.3 KB
scripts/python/existing_rtl/existing_rtl.pyscript81.1 KB
scripts/python/existing_rtl/existing_rtl_improvement.pyscript109.9 KB
scripts/python/existing_rtl/intervention.pyscript8.3 KB
scripts/python/existing_rtl/optimizer.pyscript25.8 KB
scripts/python/existing_rtl/reflection.pyscript86.7 KB
scripts/python/existing_rtl/semantic_contract.pyscript45.6 KB
scripts/python/existing_rtl/verifier.pyscript15.3 KB
scripts/python/existing_rtl/verify_repair.pyscript4.6 KB
scripts/python/existing_rtl/verify_repair_core.pyscript45.7 KB
scripts/python/existing_rtl/verify_repair_patch_apply.pyscript23.5 KB
scripts/python/existing_rtl/verify_repair_patch_categories.pyscript35.5 KB
scripts/python/existing_rtl/verify_repair_patch_plan.pyscript25.1 KB
scripts/python/existing_rtl/verify_repair_patching.pyscript2.4 KB
scripts/python/existing_rtl/verify_repair_support.pyscript25.6 KB
scripts/python/existing_rtl/verify_repair_testbench.pyscript45.9 KB
scripts/python/existing_rtl/verify_reporting.pyscript16.1 KB
scripts/python/facade/__init__.pyscript45 B
scripts/python/facade/existing_rtl_api.pyscript14.0 KB
scripts/python/facade/quality_api.pyscript19.9 KB
scripts/python/facade/representative_cases.pyscript38.3 KB
scripts/python/facade/verilog_api.pyscript6.5 KB
scripts/python/facade/workflow_api.pyscript63.2 KB
scripts/python/generation/tb_generator.pyscript54.9 KB
scripts/python/header_contract.pyscript21.1 KB
scripts/python/installation/__init__.pyscript52 B
scripts/python/installation/bundle.pyscript16.3 KB
scripts/python/installation/catalog.pyscript16.6 KB
scripts/python/installation/cli.pyscript26.4 KB
scripts/python/installation/projection.pyscript14.2 KB
scripts/python/installation/receipt.pyscript13.4 KB
scripts/python/installation/transaction.pyscript29.0 KB
scripts/python/quality/clock_name_roles.pyscript1.0 KB
scripts/python/quality/comment_placement.pyscript49.5 KB
scripts/python/quality/declaration_region_policy.pyscript8.0 KB
scripts/python/quality/deliverable_gate.pyscript51.9 KB
scripts/python/quality/external_interface_stubs.pyscript41.5 KB
scripts/python/quality/formatter_ast.pyscript85.0 KB
scripts/python/quality/formatter_ast_instances.pyscript5.4 KB

scripts/python/installation/receipt.py

View on GitHub
"""校验发布收据并生成安装事务摘要。"""

# 注解延迟求值保持收据模块运行时兼容性。
from __future__ import annotations

# JSON 负责读取发布收据对象。
import json

# pathlib 统一表达发布根和相对文件身份。
from pathlib import Path

# Any 描述发布收据的可扩展字段。
from typing import Any

# 复用包投影的规范 JSON 和摘要实现。
from .bundle import BundleError, canonical_json_bytes, sha256_bytes, sha256_file

# _relative_file_map 收集收据覆盖范围内的普通载荷。
def _relative_file_map(path_root: Path, path_receipt: Path) -> dict[str, Path]:
    """收集发布根中的普通文件。

    参数:
        path_root: 发布目录根。
        path_receipt: 发布收据路径。
    返回:
        相对路径到普通文件的映射。
    异常:
        BundleError: 发现符号链接或越界路径。
    """

    # 保存发布载荷的相对路径索引。
    dict_files: dict[str, Path] = {}  # 发布文件索引。

    # 递归遍历发布目录,收据自身不参与自引用摘要。
    for path_file in path_root.rglob("*"):

        # 符号链接不能成为可安装载荷。
        if path_file.is_symlink():

            # 立即阻止链接逃逸或链接语义差异。
            raise BundleError("> ERR: [Python] release payload contains a symbolic link")

        # 只把普通文件放入摘要索引。
        if not path_file.is_file():

            # 目录由其内部文件间接表达,不单独记录。
            continue

        # 收据文件不加入自身文件摘要清单。
        if path_file.resolve() == path_receipt.resolve():

            # 保留收据外部存在性检查。
            continue

        # 将路径转换为使用正斜杠的包内相对身份。
        str_relative = path_file.relative_to(path_root).as_posix()  # 发布文件相对路径。

        # 路径重复意味着平台大小写或目录结构发生歧义。
        if str_relative in dict_files:

            # 不接受同一路径被不同实体覆盖。
            raise BundleError("> ERR: [Python] release payload contains duplicate relative paths")

        # 记录相对路径和文件对象。
        dict_files[str_relative] = path_file  # 相对路径到普通文件的索引。

    # 返回文件索引供收据校验和复制流程共享。
    return dict_files

# _is_valid_receipt_size 判断可选大小字段是否满足兼容合同。
def _is_valid_receipt_size(obj_expected_size: object, bool_size_declared: bool) -> bool:
    """判断发布 receipt 的可选文件大小字段是否有效。

    参数:
        obj_expected_size: 收据声明的文件大小对象。
        bool_size_declared: 收据是否显式包含 ``size`` 字段。
    返回:
        缺失大小或显式非负整数时返回 True。
    """

    # 外部 agents-md receipt 可以只绑定路径和文件摘要。
    if not bool_size_declared:

        # 缺失大小不削弱路径和 SHA-256 校验。
        return True

    # 显式大小必须是非布尔的非负整数。
    return (
        isinstance(obj_expected_size, int)
        and not isinstance(obj_expected_size, bool)
        and obj_expected_size >= 0
    )

# _validate_receipt_files 逐项比对收据文件与源载荷摘要。
def _validate_receipt_files(
    dict_receipt: dict[str, Any],
    str_receipt_name: str,
    dict_source_files: dict[str, Path],
) -> dict[str, dict[str, Any]]:
    """验证收据文件项并返回已确认条目。

    参数:
        dict_receipt: 发布收据对象。
        str_receipt_name: 清单声明的收据文件名。
        dict_source_files: 发布源文件索引。
    返回:
        相对路径到收据条目的映射。
    异常:
        BundleError: 任一条目路径、重复项或摘要不一致。
    """

    # 保存收据列出的相对路径,检查重复和额外文件。
    dict_declared_files: dict[str, dict[str, Any]] = {}  # 收据文件清单。

    # 逐条校验收据中的路径和摘要。
    for dict_entry in dict_receipt["files"]:

        # 文件条目必须是对象。
        if not isinstance(dict_entry, dict):

            # 非对象条目无法验证文件身份。
            raise BundleError("> ERR: [Python] release receipt file entry is invalid")

        # 收据路径统一使用正斜杠。
        str_relative = str(dict_entry.get("path", "")).replace("\\", "/").strip()  # 收据相对路径。

        # 收据摘要字段决定逐文件完整性比较。
        str_expected_hash = str(dict_entry.get("sha256", "")).strip()  # 收据文件摘要。

        # 收据大小字段存在时绑定复制前的字节级载荷事实。
        bool_size_declared = "size" in dict_entry  # 当前收据是否声明文件大小。

        # agents-md release receipt 可只声明路径和摘要,缺失大小由 backend 兼容接受。
        obj_expected_size: object = dict_entry.get("size")  # 收据文件大小。

        # 缺失大小表示外部 receipt 合同,显式大小仍必须是非负整数。
        bool_size_valid = _is_valid_receipt_size(obj_expected_size, bool_size_declared)  # 当前收据大小字段合法性。

        # 空路径、绝对路径、缺摘要或非法显式大小均失败。
        bool_path_valid = bool(str_relative) and not Path(str_relative).is_absolute()  # 当前收据路径合法性。

        # 路径、摘要和大小必须同时满足当前 receipt 兼容合同。
        if not bool_path_valid or not str_expected_hash or not bool_size_valid:

            # 不允许收据把摘要指向包外。
            raise BundleError("> ERR: [Python] release receipt contains an invalid file path")

        # 收据不允许自引用,否则无法稳定生成摘要。
        if str_relative == str_receipt_name.replace("\\", "/"):

            # 保持收据和载荷摘要的单向关系。
            raise BundleError("> ERR: [Python] release receipt must not list itself")

        # 重复路径会让摘要语义不唯一。
        if str_relative in dict_declared_files:

            # 立即拒绝重复收据项。
            raise BundleError("> ERR: [Python] release receipt repeats a file path")

        # 收据路径必须能在源索引中找到。
        path_file = dict_source_files.get(str_relative)  # 收据条目对应的真实文件。

        # 缺失文件不能由收据条目虚构。
        if path_file is None:

            # 不接受声明不存在的文件。
            raise BundleError("> ERR: [Python] release receipt lists a missing file")

        # 计算文件真实摘要并比较。
        str_actual_hash = sha256_file(path_file)  # 发布文件真实摘要。

        # 真实摘要必须与发布收据逐项一致。
        if str_actual_hash != str_expected_hash:

            # 任何单文件失配都阻止复制。
            raise BundleError("> ERR: [Python] release file hash mismatch")

        # 显式声明大小时必须与源文件真实字节数一致。
        if bool_size_declared and path_file.stat().st_size != int(obj_expected_size):

            # 大小失配表示收据和载荷不是同一发布身份。
            raise BundleError("> ERR: [Python] release file size mismatch")

        # 保存通过校验的收据条目。
        dict_declared_files[str_relative] = dict_entry  # 已校验的收据条目。

    # 返回逐文件校验完成的收据条目集合。
    return dict_declared_files

# load_release_receipt 验证发布收据与实际载荷逐项一致。
def load_release_receipt(path_source: Path, dict_manifest: dict[str, Any]) -> tuple[dict[str, Any], dict[str, Path]]:
    """校验版本化发布目录的收据和逐文件摘要。

    参数:
        path_source: 待安装的版本化发布目录。
        dict_manifest: 安装器清单。
    返回:
        收据对象以及发布文件相对路径索引。
    异常:
        BundleError: 收据缺失、身份不匹配、文件清单失配或摘要错误。
    """

    # 收据文件名必须来自安装清单。
    str_receipt_name = str(dict_manifest.get("release_receipt_filename", "")).strip()  # 发布收据文件名。

    # 没有收据名就无法锁定发布身份。
    if not str_receipt_name:

        # 清单没有收据名时不能验证发布来源。
        raise BundleError("> ERR: [Python] release receipt filename is not configured")

    # 发布根必须是目录且不允许符号链接。
    path_root = path_source.expanduser().resolve()  # 发布目录根。

    # 源目录必须是真实可读目录。
    if not path_root.is_dir() or path_root.is_symlink():

        # 源路径不满足目录载荷合同。
        raise BundleError("> ERR: [Python] release source is not a directory")

    # 收据只能位于发布根的直接子项。
    path_receipt = (path_root / str_receipt_name).resolve()  # 发布收据路径。

    # 收据越界或缺失时拒绝源码安装。
    if not path_receipt.is_file() or not path_receipt.is_relative_to(path_root):

        # 缺收据时拒绝把源码目录当发布包。
        raise BundleError("> ERR: [Python] release receipt is missing")

    # 读取收据 JSON,保持其自描述内容不执行。
    try:

        # 收据必须使用 UTF-8 对象格式。
        dict_receipt = json.loads(path_receipt.read_text(encoding="utf-8"))  # 发布收据对象。

    # 读取或解析失败都属于完整性错误。
    except (OSError, json.JSONDecodeError) as object_error:

        # 统一返回收据不可用的诊断。
        raise BundleError(f"> ERR: [Python] release receipt is unreadable: {object_error}") from object_error

    # 顶层和文件数组必须满足最小收据结构。
    if not isinstance(dict_receipt, dict) or not isinstance(dict_receipt.get("files"), list):

        # 不接受没有逐文件证据的自制收据。
        raise BundleError("> ERR: [Python] release receipt has no file manifest")

    # 读取收据声明的技能身份。
    str_expected_skill = str(dict_receipt.get("skill_name", "")).strip()  # 收据技能身份。

    # 读取收据声明的发布版本。
    str_expected_version = str(dict_receipt.get("version", "")).strip()  # 收据发布版本。

    # 读取当前包的运行时技能身份。
    str_actual_skill = str(dict_manifest.get("_runtime_skill_id", "")).strip()  # 当前包技能身份。

    # 读取当前包的运行时发布版本。
    str_actual_version = str(dict_manifest.get("_runtime_version", "")).strip()  # 当前包发布版本。

    # 只有身份和版本同时一致才允许继续校验文件。
    if str_expected_skill != str_actual_skill or str_expected_version != str_actual_version:

        # 收据与运行时身份不一致时阻止安装。
        raise BundleError("> ERR: [Python] release receipt identity does not match package metadata")

    # 建立源文件索引并跳过收据自引用。
    dict_source_files = _relative_file_map(path_root, path_receipt)  # 收据校验使用的源文件索引。

    # 读取清单声明的禁止载荷名称,防止缓存或临时目录进入安装包。
    list_forbidden_names = dict_manifest.get("source_policy", {}).get("forbidden_names", [])  # 清单禁止名称列表。

    # 将禁止名称规范化为集合。
    set_forbidden_names = {str(value).strip() for value in list_forbidden_names if str(value).strip()}  # 禁止源名称集合。

    # 逐项检查源相对路径的每一层目录。
    for str_relative in dict_source_files:

        # 路径命中禁止名称时在复制前拒绝载荷。
        if any(str_part in set_forbidden_names for str_part in Path(str_relative).parts):

            # 保留清单驱动的源策略错误边界。
            raise BundleError("> ERR: [Python] release source contains a forbidden path")

    # 逐项校验收据声明的源文件。
    dict_declared_files = _validate_receipt_files(  # 已确认的收据条目。
        dict_receipt,  # 当前发布收据。
        str_receipt_name,  # 收据文件名。
        dict_source_files,  # 源文件索引。
    )

    # 收据清单必须覆盖全部普通载荷文件。
    if set(dict_declared_files) != set(dict_source_files):

        # 额外或遗漏文件都意味着发布包被篡改或收据过期。
        raise BundleError("> ERR: [Python] release receipt file set does not match source payload")

    # 返回收据和已校验的文件索引。
    return dict_receipt, dict_source_files

# tree_digest 为安装收据生成排序稳定的目录摘要。
def tree_digest(path_root: Path) -> str:
    """计算目录中文件路径和摘要的规范化摘要。

    参数:
        path_root: 待摘要目录。
    返回:
        规范化 JSON 的 SHA-256 摘要。
    异常:
        OSError: 目录内容不可读。
    """

    # 文件身份和内容摘要共同决定目录摘要。
    dict_files = _relative_file_map(path_root, path_root / "__never__")  # 安装后目录文件索引。

    # 使用排序列表保证不同遍历顺序得到相同摘要。
    list_entries = [  # 目录摘要条目。
        {"path": str_relative, "sha256": sha256_file(path_file)}  # 当前文件摘要条目。
        for str_relative, path_file in sorted(dict_files.items())  # 以路径顺序生成摘要。
    ]

    # 将目录摘要条目编码为稳定字节。
    bytes_payload = canonical_json_bytes({"files": list_entries})  # 目录摘要 JSON。

    # 返回目录级摘要供安装收据绑定。
    return sha256_bytes(bytes_payload)
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall