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/projection.py

View on GitHub
"""从显式权威源生成安装器运行时投影。

本模块声明 machine-readable stdout protocol:标准输出只包含一个 JSON 构建摘要对象。
"""

# 注解延迟求值保持投影构建器运行时兼容性。
from __future__ import annotations

# argparse 提供显式输入输出参数。
import argparse

# JSON 负责输出投影构建摘要。
import json

# pathlib 统一表达技能根和投影输出路径。
from pathlib import Path

# Any 描述目录驱动的 JSON 映射。
from typing import Any

# 复用包内 JSON 规范化、读取和摘要实现。
from .bundle import BundleError, canonical_json_bytes, read_json, sha256_file

# _status_value 读取投影构建结果的清单状态文本。
def _status_value(dict_manifest: dict[str, Any], str_status_key: str) -> str:
    """读取清单声明的投影状态文本。

    参数:
        dict_manifest: 安装清单对象。
        str_status_key: 状态键。
    返回:
        清单声明的状态文本。
    异常:
        BundleError: 状态键缺失或值为空。
    """

    # 投影构建器不复制状态协议值。
    dict_status_values = dict_manifest.get("status_values", {})  # 清单状态键到机器文本的映射。

    # 缺少状态值时停止生成不完整摘要。
    str_value = dict_status_values.get(str_status_key)  # 当前状态键对应的清单文本。

    # 只有清单提供非空文本时才允许生成摘要。
    if not isinstance(str_value, str) or not str_value.strip():

        # 配置缺失必须在投影写入前终止。
        raise BundleError(f"> ERR: [Python] status value is missing: {str_status_key}")

    # 返回已规范化的清单文本。
    return str_value.strip()

# parse_args 绑定投影构建的所有输入输出路径。
def parse_args(list_arguments: list[str] | None = None) -> argparse.Namespace:
    """解析投影构建的显式输入输出路径。

    参数:
        list_arguments: 可选显式参数列表。
    返回:
        投影构建参数命名空间。
    """

    # 投影构建不猜测当前目录或输出目录。
    parser: argparse.ArgumentParser = argparse.ArgumentParser(  # 投影 CLI 解析器。
        description="Build installer projections from explicit authority files.",  # CLI 用途说明。
    )

    # 技能根是投影输入的 containment 边界。
    parser.add_argument("--skill-root", required=True)

    # manifest 路径绑定安装清单权威源。
    parser.add_argument("--manifest", required=True)

    # catalog 路径绑定平台目录权威源。
    parser.add_argument("--catalog", required=True)

    # output 路径绑定平台投影文件。
    parser.add_argument("--output", required=True)

    # manifest-output 路径绑定清单合并投影。
    parser.add_argument("--manifest-output", required=True)

    # env-output 路径绑定跨语言启动投影。
    parser.add_argument("--env-output", required=True)

    # 返回投影构建参数。
    return parser.parse_args(list_arguments)

# _validate_catalog 确认平台目录可展开为唯一菜单。
def _validate_catalog(dict_catalog: dict[str, Any]) -> list[dict[str, Any]]:
    """验证平台目录的最小结构和唯一身份。

    参数:
        dict_catalog: 平台目录 JSON 对象。
    返回:
        平台对象列表。
    异常:
        BundleError: Schema 或平台身份无效。
    """

    # 顶层平台数组是投影构建的唯一来源。
    list_platforms = dict_catalog.get("platforms")  # 权威平台数组。

    # 空平台目录不能生成任何启动菜单。
    if not isinstance(list_platforms, list) or not list_platforms:

        # 空目录不能生成启动投影。
        raise BundleError("> ERR: [Python] platform catalog is empty")

    # 保存已经占用的规范 ID 和别名。
    set_identifiers: set[str] = set()  # 平台身份集合。

    # 逐条校验对象字段。
    for dict_platform in list_platforms:

        # 每条记录必须是对象且包含可识别 ID。
        if not isinstance(dict_platform, dict) or not str(dict_platform.get("id", "")).strip():

            # 不用默认平台值修复配置。
            raise BundleError("> ERR: [Python] platform catalog record is invalid")

        # 检查规范 ID 和别名的全局唯一性。
        list_names = [str(dict_platform["id"]), *[str(value) for value in dict_platform.get("aliases", [])]]  # 当前平台身份。

        # 逐项确认平台身份没有重复。
        for str_name in list_names:

            # 空或重复标识无法生成唯一菜单。
            if not str_name.strip() or str_name in set_identifiers:

                # 在投影生成阶段就拒绝歧义。
                raise BundleError("> ERR: [Python] platform catalog has duplicate identity")

            # 记录已使用身份。
            set_identifiers.add(str_name)

    # 返回通过结构和身份检查的目录数组。
    return list_platforms

# _write_atomic 将完整投影原子替换到调用者指定路径。
def _write_atomic(path_target: Path, bytes_content: bytes) -> None:
    """原子写入一个投影文件。

    参数:
        path_target: 目标路径。
        bytes_content: UTF-8 或 JSON 字节。
    返回:
        无。
    异常:
        OSError: 写入或替换失败。
    """

    # 临时文件与目标同目录,保证替换边界一致。
    path_temporary = path_target.with_name(path_target.name + ".tmp")  # 投影临时文件。

    # 输出父目录由显式目标路径决定。
    path_target.parent.mkdir(parents=True, exist_ok=True)

    # 临时文件完整后才进入原子替换。
    path_temporary.write_bytes(bytes_content)

    # 替换动作完成后调用者才看到新文件。
    path_temporary.replace(path_target)

# build_projection 从权威 JSON 生成运行时 JSON 和 env 投影。
def build_projection(namespace_args: argparse.Namespace) -> dict[str, Any]:
    """按显式配置生成 JSON 投影和启动 env 投影。

    参数:
        namespace_args: 投影构建参数。
    返回:
        投影构建摘要。
    异常:
        BundleError: 输入配置、路径或输出合同无效。
    """

    # 技能根决定所有投影输入输出的 containment 边界。
    path_skill_root = Path(namespace_args.skill_root).expanduser().resolve()  # 技能包根。

    # 清单输入来自调用者显式绑定的权威文件。
    path_manifest = Path(namespace_args.manifest).expanduser().resolve()  # 安装清单源。

    # 平台目录输入决定投影的平台记录。
    path_catalog = Path(namespace_args.catalog).expanduser().resolve()  # 平台目录源。

    # 平台投影输出由调用者显式指定。
    path_projection = Path(namespace_args.output).expanduser().resolve()  # 平台投影输出。

    # 清单投影输出保存启动器所需的合并事实。
    path_manifest_projection = Path(namespace_args.manifest_output).expanduser().resolve()  # 清单投影输出。

    # env 输出提供跨语言启动字段。
    path_env = Path(namespace_args.env_output).expanduser().resolve()  # 启动 env 输出。

    # 输入文件必须存在且位于技能根内。
    for path_input in (path_manifest, path_catalog):

        # 统一执行输入存在性和 containment 校验。
        if not path_input.is_file() or not path_input.is_relative_to(path_skill_root):

            # 不允许投影引用技能包外部配置。
            raise BundleError("> ERR: [Python] projection input is missing or outside skill root")

    # 读取安装清单权威对象。
    dict_manifest = read_json(path_manifest)  # 安装清单权威对象。

    # 读取平台目录权威对象。
    dict_catalog = read_json(path_catalog)  # 平台目录权威对象。

    # 验证平台目录并保持其目录顺序。
    list_platforms = _validate_catalog(dict_catalog)  # 已验证平台数组。

    # 计算安装清单摘要供运行时绑定。
    str_manifest_hash = sha256_file(path_manifest)  # 安装清单摘要。

    # 计算平台目录摘要供投影校验。
    str_catalog_hash = sha256_file(path_catalog)  # 平台目录摘要。

    # 平台投影只包含运行时需要的目录事实和来源摘要。
    dict_projection = {  # 运行时平台投影。
        "schema_version": dict_manifest.get("schema_version"),  # 平台投影格式版本。
        "manifest_sha256": str_manifest_hash,  # 平台投影引用的清单摘要。
        "catalog_sha256": str_catalog_hash,  # 平台投影引用的目录摘要。
        "platforms": list_platforms,  # 目录驱动的平台记录。
    }

    # 编码 JSON 投影,排序键保证构建可复现。
    bytes_projection = canonical_json_bytes(dict_projection)  # 平台投影字节。

    # 清单投影保存启动器读取的路径与协议事实。
    dict_manifest_projection = {  # 运行时清单投影。
        "schema_version": dict_manifest.get("schema_version"),  # 投影格式版本。
        "manifest_sha256": str_manifest_hash,  # 清单权威摘要。
        "catalog_sha256": str_catalog_hash,  # 平台目录权威摘要。
        "manifest": dict_manifest,  # 启动器和后端共享清单。
    }

    # 将清单投影编码为稳定的 JSON 字节。
    bytes_manifest_projection = canonical_json_bytes(dict_manifest_projection)  # 清单投影字节。

    # 写入两个 JSON 投影后再计算最终平台摘要。
    _write_atomic(path_projection, bytes_projection)

    # 清单投影与平台投影共享同一构建输入。
    _write_atomic(path_manifest_projection, bytes_manifest_projection)

    # 计算写入后的平台投影摘要。
    str_projection_hash = sha256_file(path_projection)  # 平台投影摘要。

    # 启动器所需 Python 候选来自 manifest。
    list_python_candidates = [str(value) for value in dict_manifest.get("python_candidates", [])]  # 清单排序后的 Python 探测序列。

    # 后端模块名由 manifest 投影声明。
    str_backend_module = str(dict_manifest.get("backend_module", "")).strip()  # 后端模块名。

    # 缺少任一启动字段都不能生成入口投影。
    if not list_python_candidates or not str_backend_module:

        # 缺少启动字段时不生成不可运行的入口。
        raise BundleError("> ERR: [Python] manifest does not declare launcher runtime")

    # 启动失败状态键由清单声明,不复制具体状态文本。
    str_bootstrap_status_key = str(dict_manifest.get("bootstrap_failure_status_key", "")).strip()  # 启动失败状态键。

    # 将状态键解析为清单文本,再读取对应退出码。
    str_bootstrap_status = _status_value(dict_manifest, str_bootstrap_status_key)  # 启动失败状态文本。

    # 读取清单声明的启动退出码。
    object_bootstrap_code = dict_manifest.get("exit_codes", {}).get(str_bootstrap_status)  # 启动失败退出码。

    # 缺少启动退出码时拒绝生成入口投影。
    if not isinstance(object_bootstrap_code, int):

        # 启动器必须拥有可验证的失败返回状态。
        raise BundleError("> ERR: [Python] bootstrap failure exit code is missing")

    # 使用一行一个字段的格式兼容三个启动器。
    list_env_lines = [  # 启动 env 投影行。
        f"MANIFEST_RELATIVE_PATH={dict_manifest['manifest_relative_path']}",  # 清单相对路径。
        f"CATALOG_RELATIVE_PATH={dict_manifest['catalog_relative_path']}",  # 目录相对路径。
        f"PROJECTION_RELATIVE_PATH={dict_manifest['projection_relative_path']}",  # 投影相对路径。
        f"MANIFEST_SHA256={str_manifest_hash}",  # 清单摘要。
        f"CATALOG_SHA256={str_catalog_hash}",  # 目录摘要。
        f"PROJECTION_SHA256={str_projection_hash}",  # 投影摘要。
        f"BACKEND_MODULE={str_backend_module}",  # 启动器执行的后端模块。
        f"PYTHON_CANDIDATES={'|'.join(list_python_candidates)}",  # Python 候选序列。
        f"POWERSHELL_CANDIDATES={'|'.join(str(value) for value in dict_manifest.get('powershell_candidates', []))}",  # Windows 启动候选序列。
        f"POWERSHELL_ENTRY_RELATIVE={dict_manifest['powershell_entry_relative']}",  # PowerShell 入口相对路径。
        f"BOOTSTRAP_FAILURE_EXIT_CODE={object_bootstrap_code}",  # 启动失败状态。
    ]

    # 将跨语言启动字段编码为 UTF-8 文本。
    bytes_env = ("\n".join(list_env_lines) + "\n").encode("utf-8")  # 启动 env 字节。

    # 原子写入启动投影,启动器只把它当作数据读取。
    _write_atomic(path_env, bytes_env)

    # 返回可持久化的构建摘要。
    return {
        "status": _status_value(dict_manifest, "projection_built"),
        "manifest_sha256": str_manifest_hash,
        "catalog_sha256": str_catalog_hash,
        "projection_sha256": str_projection_hash,
        "platform_count": len(list_platforms),
        "output": str(path_projection),
        "manifest_output": str(path_manifest_projection),
        "env_output": str(path_env),
    }

# main 提供投影构建的单对象 CLI 协议。
def main(list_arguments: list[str] | None = None) -> int:
    """执行投影构建 CLI。

    参数:
        list_arguments: 可选显式参数列表。
    返回:
        成功为 0,配置错误为非零。
    """

    # 解析显式投影构建参数。
    namespace_args = parse_args(list_arguments)  # 当前投影构建请求。

    # 构建成功输出单对象 JSON,便于 registry/脚本调用。
    try:

        # 投影构建器只写调用者指定的三个输出文件。
        dict_result = build_projection(namespace_args)  # 投影构建结果。

    # 领域错误以单对象协议输出,避免回溯污染 stdout。
    except (BundleError, OSError, KeyError) as object_error:

        # 错误结果包含固定 Python 错误前缀。
        print(json.dumps({"status_key": "failed", "message": f"> ERR: [Python] {object_error}"}, ensure_ascii=False))

        # 构建失败返回清单声明的错误码无法读取时的进程失败状态。
        return 1

    # 输出完整但单一的投影构建摘要。
    print(json.dumps(dict_result, ensure_ascii=False, sort_keys=True))

    # 投影构建完成。
    return 0

# 直接执行模块时输出投影构建的最终状态。
if __name__ == "__main__":

    # SystemExit 保留投影构建状态。
    raise SystemExit(main())
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