---
name: CSCI构建规程编写规范
description: 编写符合军用软件标准的CSCI（计算机软件配置项）编译与构建规程文档。当需要详细描述如何从源代码构建可执行软件、确保构建过程可重现、并满足软件产品规范(SPS)要求时使用此技能。
---

# CSCI构建规程编写规范

## 何时使用
- 需要为CSCI编写完整的编译/构建规程文档（如软件设计说明SDS第5.2条）
- 要求构建过程具备可重现性，使具备资质人员能从源文件生成一致的可执行文件
- 构建涉及多个目标环境、配置或版本
- CSCI属于更大系统，需引用或整合系统级构建规程

> **不适用场景**：仅使用预编译二进制文件、无需从源码构建的情况。

## 执行步骤

1. **明确编译/汇编工具**
   - 指定编译器或汇编器的名称及完整版本号（例如：GCC 11.2.0）

2. **列出构建依赖资源**
   - 包括链接器、静态/动态库、操作系统版本、硬件平台等软硬件资源及其版本

3. **定义编译与链接选项**
   - 详细说明使用的设置、开关和约定，例如：
     - 优化级别（-O2）
     - 调试信息开关（-g）
     - 宏定义（-DDEBUG）
     - 警告级别与错误处理策略

4. **提供完整构建流程**
   - a) 编译/汇编各源文件的顺序与命令
   - b) 链接生成最终可执行文件的步骤
   - c) 准备将可执行文件加载至固件或分发介质的操作

5. **处理多配置变更**
   - 描述如何支持不同现场环境、硬件变体或软件版本，例如：
     - 使用条件编译（#ifdef）
     - 切换配置文件或构建脚本参数
     - 管理配置标识符（如target_configurations）

6. **引用系统级规程（如适用）**
   - 若CSCI隶属于更大系统，可在软件产品规范(SPS)中定义系统级构建规程，并在此处明确引用

7. **确保可重现性**
   - 所有步骤必须足够清晰、完整，使具备资质的开发人员能独立复现完全相同的构建结果

## 输出要求
生成符合军用软件文档标准的“5.2 编译/建立规程”章节内容，包含上述全部要素。