commit 309002f77898941047c91477174e37e20c6f5cff Author: kuangji <819823900@qq.com> Date: Mon May 18 13:54:23 2026 +0800 init rep diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..4722912 --- /dev/null +++ b/.gitignore @@ -0,0 +1,5 @@ + +.configs/api_config.yaml.bak +.test + + diff --git a/GJB438C-2021_prd_skills/as-built-software-design-documentation/SKILL.md b/GJB438C-2021_prd_skills/as-built-software-design-documentation/SKILL.md new file mode 100644 index 0000000..d8a46c1 --- /dev/null +++ b/GJB438C-2021_prd_skills/as-built-software-design-documentation/SKILL.md @@ -0,0 +1,31 @@ +--- +name: as-built-software-design-documentation +description: 在编写CSCI支持文档且需提供“已构建”软件设计信息时，决定是内嵌设计信息还是引用外部文档（如SDD/IDD/DBDD），确保所呈现内容真实反映实际构建的软件结构，而非原始设计意图。 +--- + +# “已构建”软件设计信息提供规则 + +## 何时使用 +当满足以下条件时应用本技能： +- 正在编写CSCI（计算机软件配置项）的支持文档； +- 需要在文档第5.1条中提供“已构建”状态下的软件设计信息； +- CSCI已完成构建，且存在SDD（软件设计说明）、IDD（接口设计说明）或DBDD（数据库设计说明）等文档或其等价物。 + +## 如何执行 +1. **判断设计文档是否随CSCI交付**： + - 若SDD、IDD、DBDD或其等价文档已随“已构建”CSCI一同交付，则在支持文档第5.1条中直接引用这些文档，**不得重复其内容**。 + - 若未交付，则必须在第5.1条中**完整提供**与SDD/IDD/DBDD要求一致的设计信息。 + +2. **允许引用源代码中的设计信息**： + - 可引用头文件、注释或代码本身所包含的设计信息，前提是这些信息足以准确描述“已构建”CSCI的实际设计。 + +3. **附录引用规范**： + - 若以附录形式包含SDD/IDD/DBDD全文，**不得更改原始条号与页码**，以维持文档一致性。 + +4. **确保信息真实性**： + - 所有提供或引用的信息必须真实反映**实际构建的CSCI**，而非初始设计意图。 + +5. **目的说明**： + - 此信息用于支持后续对已部署软件的维护、修改和结构理解。 + +> **注意**：本规则适用于“已构建CSCI”、“软件设计说明(SDD)”、“接口设计说明(IDD)”和“数据库设计说明(DBDD)”等对象。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/corrective-action-system-implementation/SKILL.md b/GJB438C-2021_prd_skills/corrective-action-system-implementation/SKILL.md new file mode 100644 index 0000000..17ddc5c --- /dev/null +++ b/GJB438C-2021_prd_skills/corrective-action-system-implementation/SKILL.md @@ -0,0 +1,50 @@ +--- +name: 纠正措施系统实施流程 +description: 当发现软件缺陷、不符合项或收到改进建议时，使用本技能执行标准化的纠正措施流程，确保问题被正式记录、评审、实施、验证并用于推动过程改进。适用于问题报告、更改报告、纠正措施和根本原因分析等对象。 +--- + +# 纠正措施系统实施流程 + +## 何时使用 +- 发现软件缺陷、配置项不符合或收到改进建议 +- 配置管理系统已建立 +- 需要对问题进行结构化跟踪与闭环管理 + +> **注意**：轻微问题可简化流程，但仍需记录。 + +## 执行步骤 + +1. **提交问题报告/更改报告** + - 必须包含以下内容： + - 问题标识符 + - 报告日期和报告人 + - 问题描述（现象、重现步骤） + - 影响分析（对功能、安全、进度的影响） + - 建议解决方案（可选） + +2. **评审报告** + - 由变更控制委员会（CCB）评估问题的优先级、影响范围和实施可行性。 + +3. **批准更改** + - CCB决定是否实施纠正措施。 + +4. **实施纠正** + - 开发团队修改代码或文档，并更新相关配置项。 + +5. **验证纠正效果** + - 通过测试或审查确认问题已解决且未引入新问题。 + +6. **关闭报告** + - 记录验证结果和关闭日期，完成闭环。 + +7. **分析趋势** + - 定期汇总问题类型和根本原因，识别系统性改进机会，推动过程优化。 + +## 关键角色与对象 +- **问题报告**：记录软件问题的正式文档 +- **CCB（变更控制委员会）**：负责评审和批准变更的决策机构 + +## 输出结果 +- 问题被有效解决 +- 相关产品或文档已更新 +- 过程改进建议已生成或实施 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/csci-build-procedure-specification/SKILL.md b/GJB438C-2021_prd_skills/csci-build-procedure-specification/SKILL.md new file mode 100644 index 0000000..0b2df88 --- /dev/null +++ b/GJB438C-2021_prd_skills/csci-build-procedure-specification/SKILL.md @@ -0,0 +1,49 @@ +--- +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 编译/建立规程”章节内容，包含上述全部要素。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/csci-component-description/SKILL.md b/GJB438C-2021_prd_skills/csci-component-description/SKILL.md new file mode 100644 index 0000000..9c9e686 --- /dev/null +++ b/GJB438C-2021_prd_skills/csci-component-description/SKILL.md @@ -0,0 +1,45 @@ +--- +name: CSCI部件描述 +description: 当需要在软件架构文档或CSCI设计中详细说明组成CSCI的所有软件单元及其静态关系、用途、开发状态和硬件资源使用情况时使用本技能。适用于已确定CSCI架构且需对内部组件进行完整描述的场景，不适用于黑盒组件无需内部细节的情况。 +--- + +# CSCI部件描述 + +## 何时使用 +- 已完成CSCI体系结构设计 +- 需要为软件架构文档或CSCI设计说明书提供完整的内部组件清单 +- 需明确各软件单元的用途、来源、资源消耗及部署位置 +- 不适用于仅需黑盒接口描述的组件 + +## 执行步骤 + +1. **列出所有软件单元并分配唯一标识符** + - 软件单元包括：类、对象、模块、函数、例程、数据库、主要分支或组成部分 + - 允许层次化结构（即软件单元可由其他软件单元组成） + +2. **描述软件单元间的静态组成关系** + - 根据所采用的设计方法学（如面向对象、模块化等）说明结构关系 + +3. **说明每个软件单元的用途** + - 明确其承担的CSCI需求 + - 记录相关的设计决策依据 + +4. **标注每个软件单元的开发状态/类型** + - 新开发 + - 按原样重用已有设计或软件 + - 再工程的已有设计或软件 + - 为重用而要开发的软件 + - 为构建版N计划的软件 + - 若为已有项，提供名称、版本、文档引用、库位置等标识信息 + +5. **描述硬件资源使用计划** + a) 列出全部硬件资源：处理机、内存、I/O设备、辅存、通信/网络设备 + b) 提供资源使用数据：正常、峰值、最坏情况下的用量及对应事件假设 + c) 说明依赖的软件环境（操作系统、运行时库等） + d) 使用标准测度单位（如处理器占用百分比、内存字节数） + e) 注明评估粒度（软件单元级、CSCI级或可执行程序级） + +6. **标识软件单元的实现位置** + - 指明每个单元将被放置于哪个程序库或代码仓库路径 + +> 注意：若某组件为黑盒且无需内部描述，则跳过本流程。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/csci-executable-software-validation/SKILL.md b/GJB438C-2021_prd_skills/csci-executable-software-validation/SKILL.md new file mode 100644 index 0000000..15820c7 --- /dev/null +++ b/GJB438C-2021_prd_skills/csci-executable-software-validation/SKILL.md @@ -0,0 +1,25 @@ +--- +name: CSCI可执行软件有效性判定 +description: 判定某软件实体是否为CSCI（计算机软件配置项）有效可执行拷贝。当需要验证交付的可执行软件是否与基线清单完全一致时使用此技能，适用于已构建的可执行软件实体，不适用于设计文档或需求规格说明。 +--- + +# CSCI可执行软件有效性判定 + +## 何时使用 +- 需验证某软件实体是否为CSCI有效可执行拷贝 +- 软件交付物包含可执行文件、批处理脚本、命令文件或运行所需数据文件 +- 已存在3.1中定义的CSCI可执行文件清单 +- 具备文件比对能力（如按位比较、校验和等） + +## 执行步骤 +1. 获取3.1条中定义的CSCI可执行软件文件清单，包括批处理文件、命令文件、数据文件及其他在目标计算机上安装和运行所需的软件文件。 +2. 对待验证的软件实体，逐项检查其是否包含与清单中每个文件同名的对等实体。 +3. 使用以下任一方法验证每个对等实体与原始文件的精确一致性： + - 按位比较（bit-for-bit comparison） + - 校验和（checksum）验证 + - 其他经认可的等效比对方法 +4. 只有当所有文件均存在且内容完全一致时，该软件实体才被视为CSCI可执行软件的有效拷贝。 +5. 若任一文件缺失或内容不匹配，则判定为无效拷贝。 + +## 输出 +返回布尔值：`true` 表示是有效拷贝，`false` 表示无效。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/csci-external-interface-requirement-specification/SKILL.md b/GJB438C-2021_prd_skills/csci-external-interface-requirement-specification/SKILL.md new file mode 100644 index 0000000..6df5b65 --- /dev/null +++ b/GJB438C-2021_prd_skills/csci-external-interface-requirement-specification/SKILL.md @@ -0,0 +1,50 @@ +--- +name: CSCI外部接口需求描述规范 +description: 用于在定义CSCI（计算机软件配置项）外部接口需求时，系统化地描述接口的完整技术规格。当需要编写或审查CSCI与外部系统、组件或用户之间的接口需求文档时使用本技能，确保涵盖优先级、数据元素、组合体、通信方法、协议及其他关键特征。 +--- + +# CSCI外部接口需求描述规范 + +## 何时使用 + +- 正在编写软件需求规格说明（SRS）中关于CSCI外部接口的部分 +- 需要确保接口需求满足系统集成和互操作性要求 +- 审查现有接口需求是否完整、一致且可验证 +- 外部实体行为未完全定义，需通过假设方式描述接口交互 + +## 如何执行 + +按以下结构组织CSCI外部接口需求描述（顺序可调整，但内容必须完整）： + +1. **接口优先级**：明确CSCI为该接口分配的优先级。 +2. **接口类型特征**：说明接口功能类型，例如实时数据传送、数据存储与检索、命令控制等。 +3. **数据元素特征**：对CSCI提供、存储、发送、访问或接收的每个数据元素，描述： + - 名称/标识符（包括唯一标识符、非技术名称、标准化名称、技术名称、缩略名） + - 数据类型 + - 大小和格式 + - 计量单位 + - 值范围或枚举值 + - 准确性和精度要求 + - 优先级、定时、频率、容量、序列及其他约束 + - 保密性约束 + - 来源和接收者 +4. **数据元素组合体特征**：对记录、消息、文件等结构化数据集合，描述： + - 名称/标识符 + - 包含的数据元素及其结构 + - 介质类型及结构（如网络报文、磁盘文件） + - 视听特性（如适用） + - 组合体之间的关系（如依赖、顺序） + - 约束条件 + - 保密性约束 + - 来源和接收者 +5. **通信方法特征**：说明CSCI使用的通信机制（如API调用、消息队列、共享内存等）。 +6. **协议特征**：描述所采用的接口协议（如HTTP/REST、TCP/IP、自定义二进制协议等）。 +7. **其他要求**：包括物理兼容性、电气特性、环境约束等非功能性要求。 + +### 处理未涵盖的外部实体 + +若外部实体的行为或特性未被完全定义，应采用以下任一方式描述： +- 以“假设”形式明确前提条件 +- 使用“当[未涵盖实体]这样做时，本CSCI应该...”的句式定义响应行为 + +确保所有描述可测试、无歧义，并避免涉及CSCI内部实现细节。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/csci-hardware-resource-usage-description/SKILL.md b/GJB438C-2021_prd_skills/csci-hardware-resource-usage-description/SKILL.md new file mode 100644 index 0000000..4bccba6 --- /dev/null +++ b/GJB438C-2021_prd_skills/csci-hardware-resource-usage-description/SKILL.md @@ -0,0 +1,38 @@ +--- +name: CSCI硬件资源使用描述 +description: 生成符合GJB 438C-2021标准第5.4条要求的CSCI硬件资源使用说明。当需要编写软件产品规格说明（SPS）或相关文档中的“硬件资源使用”章节时使用本技能，特别是已构建CSCI且已完成资源测量或估算的情况下。 +--- + +# CSCI硬件资源使用描述 + +## 适用场景 +- 正在编写符合GJB 438C-2021标准的软件产品规格说明（SPS）或其他技术文档 +- 已完成CSCI构建，并已通过实测、仿真或工程估算获得硬件资源使用数据 +- 需要满足军用软件文档对处理器、内存、I/O设备、辅存和网络设备等资源使用的详细说明要求 + +## 执行步骤 + +1. **按资源类型逐项描述**：针对以下五类硬件资源分别提供完整信息： + - 处理器能力 + - 内存容量 + - I/O设备能力 + - 辅存容量 + - 通信/网络设备能力 + +2. **每类资源必须包含以下五项内容**： + a) **需求追溯**：说明该资源使用满足的CSCI需求或系统级资源分配（详细追溯关系可置于文档第6章c)款） + b) **使用假设**：明确数据所基于的使用场景（如典型用法、最坏情况用法、特定事件触发条件） + c) **特殊考虑**：列出影响资源使用的关键因素（如虚存、覆盖技术、多处理器调度、操作系统开销、库软件开销等） + d) **度量单位**：注明所采用的单位（如处理器能力百分比、周期/秒、字节数、千字节/秒等） + e) **测量级别**：指明数据层级（软件单元级、CSCI级或可执行程序级） + +3. **明确数据来源**：注明资源数据来自实测、仿真还是工程估算。 + +4. **引用替代方案**：若所有资源使用数据已在SPS等独立文档中完整提供，则第5.4条可直接引用该文档，无需重复内容。 + +5. **确保真实性**：所有描述必须反映“已构建”CSCI的实际行为，而非设计阶段的预期值。 + +## 注意事项 +- 必须覆盖所有在需求规格或系统分配中提及的硬件资源 +- 若引用外部文档，需确保其内容完整且可公开访问 +- 避免模糊表述，所有数值和条件应具体、可验证 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/csci-nei-bu-ke-zhui-su-xing-ju-zhen-gou-jian/SKILL.md b/GJB438C-2021_prd_skills/csci-nei-bu-ke-zhui-su-xing-ju-zhen-gou-jian/SKILL.md new file mode 100644 index 0000000..7e5bf2f --- /dev/null +++ b/GJB438C-2021_prd_skills/csci-nei-bu-ke-zhui-su-xing-ju-zhen-gou-jian/SKILL.md @@ -0,0 +1,37 @@ +--- +name: CSCI内部可追踪性矩阵构建 +description: 构建CSCI（计算机软件配置项）内部及与需求之间的双向可追踪性矩阵，用于支持变更影响分析、验证覆盖度评估和配置管理。当需要建立源文件、软件单元、硬件资源使用测量与CSCI需求之间的双向追踪关系时使用此技能。 +--- + +# CSCI内部可追踪性矩阵构建 + +## 何时使用 + +在以下条件全部满足时应用本技能： +- 软件单元划分已完成 +- 源文件编码已完成 +- 硬件资源使用测量已完成 +- 需要建立CSCI内部工件与CSCI需求之间的双向可追踪性 + +## 执行步骤 + +1. **确定追踪关系类型**：构建以下四类双向追踪关系： + - **源文件 → 软件单元**：每个源文件实现哪些软件单元 + - **软件单元 → 源文件**：每个软件单元由哪些源文件实现 + - **硬件资源使用测量 → CSCI需求**：每项资源测量对应满足哪些CSCI需求 + - **CSCI需求 → 硬件资源使用测量**：每个与资源相关的CSCI需求对应哪些测量数据 + +2. **选择实现形式**：可使用表格、矩阵或专用追踪工具，但必须确保信息清晰、无歧义。 + +3. **避免重复提供**：第6章中关于(c)和(d)类追踪关系的内容，也可直接在文档5.4条中提供，避免内容重复。 + +4. **使用唯一标识符**：所有被追踪的工件（如需求、源文件、测量项）必须使用唯一标识符（例如需求ID、源文件名、测量编号）进行引用。 + +5. **反映实际实现**：追踪关系必须基于“已构建”的CSCI实际实现状态，而非原始设计意图。 + +6. **输出结果**：生成完整的第6章可追踪性描述，或在5.4条中嵌入相关追踪信息。 + +## 注意事项 + +- 可追踪性必须是**双向**的，即同时支持正向（需求→实现）和反向（实现→需求）追踪。 +- 此矩阵将直接用于后续的变更影响分析、验证覆盖度评估和配置管理活动，因此准确性至关重要。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/csci-source-code-validation/SKILL.md b/GJB438C-2021_prd_skills/csci-source-code-validation/SKILL.md new file mode 100644 index 0000000..450a9b1 --- /dev/null +++ b/GJB438C-2021_prd_skills/csci-source-code-validation/SKILL.md @@ -0,0 +1,23 @@ +--- +name: CSCI源文件有效性判定 +description: 判定某软件实体是否为CSCI有效源文件拷贝。当需要验证用于重建可执行软件的源代码集合是否与基线清单完全一致时使用此技能，仅适用于源文件交付物，不适用于可执行文件或文档。 +--- + +# CSCI源文件有效性判定 + +## 何时使用 +- 需验证某软件实体是否为CSCI有效源文件拷贝 +- 待验证对象为用于重新生成CSCI可执行软件的源代码集合 +- 已存在3.2中定义的CSCI源文件清单 +- 具备文件比对能力（如按位比较、校验和等） + +## 执行步骤 +1. 获取3.2条中定义的CSCI源文件清单，包括重新生成CSCI可执行软件所需的批处理文件、命令文件、数据文件及其他必要文件。 +2. 对待验证的源文件集合，逐项确认是否包含与清单中每个源文件同名的对等实体。 +3. 使用精确匹配方法（如按位比较、校验和或其他等效技术）验证每个对等实体与原始源文件的内容一致性。 +4. 仅当所有源文件均存在且内容完全一致时，该集合才被视为CSCI源文件的有效拷贝。 +5. 若任一文件缺失、命名不符或内容不一致，则判定为无效源文件拷贝。 +6. 此验证是支持软件修改、重建和维护的基础前提。 + +## 输出 +返回布尔值：`true` 表示是有效源文件拷贝，`false` 表示无效。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/define-project-organizational-structure/SKILL.md b/GJB438C-2021_prd_skills/define-project-organizational-structure/SKILL.md new file mode 100644 index 0000000..7a92ba2 --- /dev/null +++ b/GJB438C-2021_prd_skills/define-project-organizational-structure/SKILL.md @@ -0,0 +1,39 @@ +--- +name: 定义项目组织结构 +description: 在项目立项后，明确参与项目的各类组织机构、职责分工、权限边界及决策机制，形成清晰的项目治理结构。当项目已立项且关键干系人已识别时使用本技能，特别适用于需符合GJB438C标准、涉及多方协作的复杂软件项目。 +--- + +# 定义项目组织结构 + +## 何时使用 +- 项目已正式立项 +- 关键干系人（如需方、开发方、保障机构等）已识别 +- 项目规模或复杂度要求明确的组织治理机制 +- 需避免职责不清、汇报混乱或决策延迟 + +## 执行步骤 +1. **识别组织机构**：列出所有参与方，包括： + - 开发方内部部门 + - 需方代表 + - 保障支持机构 + - 分承制方（分包商） + - 独立验证与确认（IV&V）机构 +2. **定义机构关系**：明确各机构间的协作、汇报、审批等关系，建议使用组织结构图可视化呈现。 +3. **分配职责与权限**：为每个机构明确其在以下核心活动中的角色与责任： + - 软件工程 + - 软件测试 + - 配置管理 + - 质量保证 + - 风险管理 + - 用户培训 + 推荐使用RACI（负责、批准、咨询、知会）模型构建职责矩阵。 +4. **明确决策机制**：定义关键决策流程，特别是变更控制委员会（CCB）的组成、权限范围和运作规则。 +5. **文档化与批准**：将完整的组织结构、职责矩阵和决策机制写入项目计划，并获得所有关键干系人正式批准。 + +## 关键产出 +- 项目组织结构图 +- 职责矩阵（RACI表） +- CCB章程 +- 经批准的项目计划（含组织治理章节） + +> **注意**：组织结构设计必须与项目规模、周期和复杂度相匹配，避免过度设计或职责真空。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/describe-interface-communication-characteristics/SKILL.md b/GJB438C-2021_prd_skills/describe-interface-communication-characteristics/SKILL.md new file mode 100644 index 0000000..d357765 --- /dev/null +++ b/GJB438C-2021_prd_skills/describe-interface-communication-characteristics/SKILL.md @@ -0,0 +1,19 @@ +--- +name: 描述接口通信方法特征 +description: 当需要为涉及通信传输的接口（如通信接口、网络接口或硬件接口）编写技术文档或规范时，使用本技能来系统化描述其通信机制的关键特征。适用于接口设计、系统集成或安全评估场景，前提是该接口具备跨实体的数据传输行为，而非纯本地函数调用。 +--- + +# 描述接口通信方法特征 + +当接口使用通信方法进行数据传输时，必须从接口实体角度完整描述以下通信特征，并明确不同实体间对同一特性的期望差异（如数据大小、频率等）： + +1. **唯一标识符**：为通信方法分配全局唯一的标识。 +2. **通信链路特性**：说明带宽、频率、传输介质及其物理/逻辑特性。 +3. **消息格式化**：定义消息结构、编码方式和数据封装规则。 +4. **流控制机制**：包括序列编号策略、缓冲区分配与管理方式。 +5. **数据传送模式**：区分周期性或非周期性通信，并说明传输速率、间隔及触发条件。 +6. **路由与寻址**：描述路由策略、地址分配机制及命名约定。 +7. **传输服务质量**：明确优先级、服务等级（QoS）及可靠性保障措施。 +8. **安全性要求**：涵盖加密机制、用户身份鉴别、数据隔离及审计日志等安全控制措施。 + +执行时，应根据实际通信类型（周期性/非周期性）和应用的安全机制动态调整描述重点。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/fen-cheng-zhi-fang-guan-li/SKILL.md b/GJB438C-2021_prd_skills/fen-cheng-zhi-fang-guan-li/SKILL.md new file mode 100644 index 0000000..05ec69a --- /dev/null +++ b/GJB438C-2021_prd_skills/fen-cheng-zhi-fang-guan-li/SKILL.md @@ -0,0 +1,23 @@ +--- +name: 分承制方管理 +description: 在军工或高可靠性软件开发项目中，当存在分包合同且已选定分承制方时，主承包商需实施本技能以确保分承制方的工作符合整体项目要求、质量标准和交付计划，并对最终产品负全责。适用于依据GJB438C等标准开展的系统工程与软件开发项目。 +--- + +# 分承制方管理 + +## 何时使用 +- 项目存在分承制方（分包单位） +- 已签订分包合同 +- 主承包商需对需方承担最终交付责任 + +## 执行步骤 + +1. **明确责任划分**：在合同中清晰规定分承制方的工作范围、交付物、质量标准和进度要求。 +2. **技术协调**：定期组织技术协调会议，确保接口定义一致、设计方案兼容。 +3. **过程监督**：审查分承制方提交的开发计划、状态报告、测试结果等文档，必要时开展现场检查。 +4. **质量控制**：要求分承制方遵循主承包商的质量管理体系，或提供经认可的等效质量保证证明。 +5. **配置管理整合**：将分承制方产生的配置项纳入项目的整体配置管理系统，确保版本一致性和可追溯性。 +6. **风险共担**：识别与分包相关的技术、进度或供应链风险，制定应对措施（如引入备用供应商）。 +7. **验收管理**：主承包商负责对分承制方交付物进行正式验收，并对其完整性、合规性向需方负责。 + +> 注意：主承包商始终对最终产品负全责，不得因分包而转移责任。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/gjb2786-sdp-dynamic-update/SKILL.md b/GJB438C-2021_prd_skills/gjb2786-sdp-dynamic-update/SKILL.md new file mode 100644 index 0000000..c3a51bc --- /dev/null +++ b/GJB438C-2021_prd_skills/gjb2786-sdp-dynamic-update/SKILL.md @@ -0,0 +1,32 @@ +--- +name: GJB2786军用软件项目SDP动态更新 +description: 在GJB2786框架下的军用软件项目中，当项目出现重大偏差（如进度延误>20%、关键资源变更、需求重大调整）或到达预设里程碑（如需求冻结、设计完成、测试启动）时，执行软件开发计划（SDP）的分析、修订与重新基线化。适用于已制定初始SDP且项目已进入执行阶段的场景。 +--- + +# GJB2786军用软件项目SDP动态更新 + +## 何时使用 +- 项目处于执行阶段且已有初始SDP +- 触发条件满足以下任一情况： + - 出现重大偏差（进度延误超过20%、关键人员/资源变更、需求发生重大调整） + - 到达预设里程碑（如需求冻结点、架构设计完成、系统测试启动等） +- 项目遵循GJB2786军用软件开发标准 + +## 如何执行 +1. **确认触发条件**：判断是否满足“重大偏差”或“里程碑到达”条件。 +2. **开展偏差/里程碑分析**：评估当前状态对原SDP的影响范围和程度。 +3. **判定是否需重新策划**：若影响涉及SDP核心内容（如过程、方法、进度、组织结构、资源监督机制），则必须修订SDP。 +4. **修订SDP**：更新以下至少一项内容： + - 软件开发过程 + - 所采用的方法 + - 各活动的实施途径 + - 项目进度计划 + - 项目组织结构 + - 资源可视性与监督工具 +5. **可选拆分**：将配置管理、质量保证等专项内容从SDP中拆出，形成独立计划（如适用）。 +6. **重新基线化**：完成内部评审后，将更新后的SDP正式纳入配置管理，生成新基线版本，并记录修订理由与变更内容。 + +## 输出结果 +- 更新后的SDP文档 +- 包含完整的修订记录与变更理由说明 +- 新的基线标识（如版本号、基线日期） \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/gjb438c-interface-design-spec-structure/SKILL.md b/GJB438C-2021_prd_skills/gjb438c-interface-design-spec-structure/SKILL.md new file mode 100644 index 0000000..2350d8a --- /dev/null +++ b/GJB438C-2021_prd_skills/gjb438c-interface-design-spec-structure/SKILL.md @@ -0,0 +1,39 @@ +--- +name: GJB438C接口设计说明文档结构规范 +description: 本技能用于指导用户按照GJB 438C-2021标准编写接口设计说明文档的结构。当用户需要编制适用于系统、子系统、配置项或人工操作等实体之间接口的正式设计文档时，应使用此技能。 +--- + +# GJB438C接口设计说明文档结构规范 + +## 何时使用 +- 正在编写**接口设计说明文档**（Interface Design Description, IDD） +- 文档需符合**GJB 438C-2021《军用软件开发文档通用要求》** +- 系统或软件包含两个及以上需交互的接口实体（如系统、CSCI、用户等） +- 不适用于无接口的独立软件单元 + +## 执行步骤 + +### 1. 范围章节 +必须包含以下内容： +- **标识**：明确适用系统、接口实体和接口的完整标识（含标识号、名称、缩略名、版本号、发布号） +- **系统概述**：简述系统用途、一般特性（规模、安全性、可靠性、实时性、技术风险等）、开发/运行/维护历史、项目相关方（需方、用户、开发方、保障机构）、当前及计划运行现场、其他相关文档 +- **文档概述**：说明本文档用途、内容范围及安全保密要求 + +### 2. 引用文档章节 +- 列出所有引用文档的编号、标题、编写单位、修订版、日期 +- 若引用文档来自非正常渠道，须注明来源 + +### 3. 接口设计章节 +- 按子条目分别描述一个或多个接口实体（系统/子系统/CSCI/人工操作等）的接口特性 +- 若接口设计依赖于系统状态或运行方式，必须明确指出该依赖关系 +- 可引用其他文档中的设计信息，但需确保可追溯 +- 必须给出或引用适用的设计约定（如数据格式、协议、时序等） + +### 4. 需求可追踪性章节 +- 建立并描述接口实体与系统或CSCI需求之间的**双向可追踪性** +- 确保每个接口特性均可追溯至对应的需求项 + +### 5. 注释章节 +- 提供有助于理解文档的背景信息、术语定义、缩略语解释或关键公式 + +> 注意：所有章节必须严格遵循GJB 438C-2021的格式与内容要求，确保文档具备工程合规性和审查通过能力。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/gjb438c-military-software-document-structure/SKILL.md b/GJB438C-2021_prd_skills/gjb438c-military-software-document-structure/SKILL.md new file mode 100644 index 0000000..77144e2 --- /dev/null +++ b/GJB438C-2021_prd_skills/gjb438c-military-software-document-structure/SKILL.md @@ -0,0 +1,47 @@ +--- +name: GJB438C军用软件文档结构规范 +description: 本技能用于指导编制符合GJB438C标准的军用软件文档时，正确构建其组成结构。当用户需要创建、审核或修改任何GJB438C规定的军用软件文档（如软件需求规格说明、设计文档等）时，应使用此技能确保封面、修改页、目录、正文和附录等组成部分完整且格式合规。 +--- + +# GJB438C军用软件文档结构规范 + +## 何时使用 +- 编制、修订或审查任何依据GJB438C标准要求的军用软件文档时 +- 文档类型包括但不限于软件开发计划、软件需求规格说明、软件设计说明、测试文档等 +- 处理传统纸质文档或数据库等非传统格式文档时 + +## 执行步骤 + +### 1. 确保包含以下五个核心组成部分： + +**a) 封面** +- 包含：文档号、版本/修订号、密级、文档名称、适用系统标识、编制单位 +- 列出编写人、审核人、会签人、批准人及编制日期 + +**b) 修改页** +- 记录每次修改的历史信息 +- 每条记录需包含：修改原因、修改内容、对应版本号、修改日期 + +**c) 目录** +- 列出所有章、条、附录、图表的编号、标题及对应页码 +- 确保层级清晰、编号连续 + +**d) 正文** +- 按GJB438C第5章规定填充具体文档内容 +- 内容必须与文档类型匹配（如需求、设计、测试等） + +**e) 附录** +- 提供便于维护的独立信息（如大型表格、分类数据、示意图等） +- 每个附录必须在正文中被明确引用 + +### 2. 非传统格式文档（如数据库）的等效处理： +- 封面信息可嵌入外部元数据或内部标记字段中 +- 目录可用指针列表或访问命令目录替代 +- 页号可用唯一名称或逻辑编号代替，确保可检索性 + +### 3. 页号编排规则： +- **正文前页**（封面至目录）：使用小写罗马数字（i, ii, iii…） +- **正文及附录**：使用阿拉伯数字（1, 2, 3…） +- **多卷文档**：每卷独立重新编号，不跨卷连续 + +> 注意：所有结构要求必须严格遵循GJB438C第4.3条款。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/gjb438c-software-requirements-spec-structure/SKILL.md b/GJB438C-2021_prd_skills/gjb438c-software-requirements-spec-structure/SKILL.md new file mode 100644 index 0000000..8510d66 --- /dev/null +++ b/GJB438C-2021_prd_skills/gjb438c-software-requirements-spec-structure/SKILL.md @@ -0,0 +1,48 @@ +--- +name: GJB438C软件需求规格说明文档结构规范 +description: 本技能用于指导用户按照GJB 438C-2021标准构建软件需求规格说明（SRS）或CSCI需求文档的结构。当用户需要编写正式的军用软件需求文档时，应使用此技能。 +--- + +# GJB438C软件需求规格说明文档结构规范 + +## 何时使用 +- 正在编写**软件需求规格说明文档**（Software Requirements Specification, SRS）或**CSCI需求文档** +- 文档需符合**GJB 438C-2021《军用软件开发文档通用要求》** +- 需求已进入正式化阶段（非初步或非正式收集） +- 适用于计算机软件配置项（CSCI）的全生命周期需求定义 + +## 执行步骤 + +### 1. 范围章节 +必须包含： +- **标识**：适用系统和软件的完整标识（含标识号、名称、缩略名、版本号、发布号） +- **系统概述**：系统用途、一般特性（规模、安全性、可靠性、实时性、技术风险等）、开发/运行/维护历史、项目相关方、运行现场信息、关联文档 +- **文档概述**：说明文档用途、内容结构及安全保密要求 + +### 2. 引用文档章节 +- 列出引用文档的编号、标题、编写单位、修订版、日期 +- 注明非正常渠道获取文档的来源 + +### 3. 需求章节 +必须系统化涵盖以下类别： +- **状态与方式**：定义系统在不同场景下的状态（如空闲、就绪、活动、训练、降级、紧急等） +- **CSCI能力需求** +- **外部与内部接口需求** +- **内部数据需求** +- **适应性、保密性、安全性、环境适应性等质量特性需求** +- **计算机资源需求**（处理时间、内存、存储等） +- **设计与实现约束** +- **人员与训练相关需求** +- **软件保障、包装及其他特殊需求** +- **需求优先级与关键性标识** + +### 4. 合格性规定章节 +- 为每项需求明确合格性检验方法：测试、演示、分析、审查或推断 + +### 5. 需求可追踪性章节 +- 建立CSCI需求与上级系统/子系统需求之间的**双向可追踪性矩阵** + +### 6. 注释章节 +- 提供术语、缩略语、背景说明或必要公式，辅助理解需求内容 + +> 注意：所有需求必须可验证、无歧义，并满足GJB 438C-2021对军用软件文档的完整性与合规性要求。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/implement-risk-management-framework/SKILL.md b/GJB438C-2021_prd_skills/implement-risk-management-framework/SKILL.md new file mode 100644 index 0000000..94b2729 --- /dev/null +++ b/GJB438C-2021_prd_skills/implement-risk-management-framework/SKILL.md @@ -0,0 +1,31 @@ +--- +name: 实施风险管理框架 +description: 在项目启动后，系统化地识别、分析、排序、应对和监控项目风险，以降低不确定性并保障项目目标达成。当项目已启动且风险管理人员已指定时使用本技能，尤其适用于需遵循GJB438C标准的国防或高可靠性软件项目。 +--- + +# 实施风险管理框架 + +## 何时使用 +- 项目已正式启动 +- 已指定专职或兼职风险管理人员 +- 需建立结构化机制管理技术、进度、资源及外部依赖等风险 +- 项目复杂度较高，不可简化风险管理流程 + +## 执行步骤 +1. **风险识别**：通过头脑风暴、检查单、专家访谈等方式，全面识别项目中的潜在风险（如技术难点、进度延误、资源短缺、外部依赖失效等）。 +2. **风险分析**：对每个已识别风险评估其发生概率和影响程度，计算风险值（风险值 = 概率 × 影响）。 +3. **风险排序**：按风险值从高到低排序，确定需优先关注的高风险项。 +4. **制定对策**：为每个高风险项选择并设计应对策略： + - **规避**：修改计划以彻底消除风险源 + - **转移**：通过保险、外包等方式将风险责任转移给第三方 + - **缓解**：采取措施降低风险发生概率或减轻其影响 + - **接受**：对低风险项制定应急响应计划 +5. **实施对策**：为每项对策分配责任人，设定完成时限，并纳入项目执行计划。 +6. **监控风险**：定期审查风险状态，更新风险登记册，持续识别新出现的风险。 + +## 关键产出 +- 风险登记册（含所有已识别风险及其状态、对策、责任人） +- 风险值量化结果 +- 风险应对行动计划 + +> **注意**：低风险项目可适当简化上述流程，但至少应完成风险识别、关键对策制定和定期监控。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/index.md b/GJB438C-2021_prd_skills/index.md new file mode 100644 index 0000000..05bf595 --- /dev/null +++ b/GJB438C-2021_prd_skills/index.md @@ -0,0 +1,115 @@ +# 军用软件工程技能集 + +本技能集合基于标准文档“8F56300C-Bf68-4558-9747-406D54791882”，涵盖军用软件全生命周期的关键能力，包括需求分析、接口设计、软件开发、测试验证、配置管理、质量保证、部署交付及文档编制等核心领域。这些技能严格遵循GJB 438C、GJB 2786等国家军用标准，适用于国防软件项目规划、实施与验收各阶段，旨在提升软件系统的可靠性、可追溯性与合规性。 + +## Available Skills + +| Skill | Description | Use When | +|-------|-------------|----------| +| [gjb438c-interface-design-spec-structure](gjb438c-interface-design-spec-structure/SKILL.md) | 指导用户按GJB 438C-2021标准编写接口设计说明文档的结构 | 当用户需要编制适用于系统、子系统、配置项或人工操作等实体之间接口的正式设计文档时 | +| [military-software-document-tailoring](military-software-document-tailoring/SKILL.md) | 合规地剪裁军用软件项目文档种类或内容，保留必要要素和可追溯性 | 仅在合同允许剪裁且采用特定生存周期模型的前提下 | +| [corrective-action-system-implementation](corrective-action-system-implementation/SKILL.md) | 执行标准化纠正措施流程，确保问题被记录、评审、实施、验证并用于过程改进 | 当发现软件缺陷、不符合项或收到改进建议时 | +| [software-installation-plan-development](software-installation-plan-development/SKILL.md) | 制定符合GJB438C标准的软件安装计划，涵盖安装概述、资源保障、培训安排、任务分解及现场实施细节 | 当软件需在用户现场部署且已通过验收、安装环境已确认时 | +| [software-deployment-preparation](software-deployment-preparation/SKILL.md) | 生成完整的软件使用准备包，包括可执行程序、版本说明文档、用户手册及安装流程 | 当软件即将部署至用户现场且已完成构建并通过合格性测试时 | +| [csci-executable-software-validation](csci-executable-software-validation/SKILL.md) | 判定某软件实体是否为CSCI有效可执行拷贝 | 当需要验证交付的可执行软件是否与基线清单完全一致时 | +| [software-acceptance-support](software-acceptance-support/SKILL.md) | 为需方提供全面的验收支持活动，包括测试协助、产品交付、培训实施和问题响应 | 当用户需要执行或协调符合GJB438C标准的软件验收流程时 | +| [lian-he-ping-shen-lei-xing-yu-nei-rong](lian-he-ping-shen-lei-xing-yu-nei-rong/SKILL.md) | 组织并执行联合技术评审（JTR）或联合管理评审（JMR），评估技术合理性或项目管理状态 | 在项目到达关键里程碑且评审计划与材料已准备就绪时 | +| [fen-cheng-zhi-fang-guan-li](fen-cheng-zhi-fang-guan-li/SKILL.md) | 确保分承制方工作符合整体项目要求、质量标准和交付计划，主承包商对最终产品负全责 | 在军工或高可靠性软件开发项目中存在分包合同且已选定分承制方时 | +| [software-configuration-management](software-configuration-management/SKILL.md) | 建立和维护软件配置管理体系，确保工作产品的完整性、可追溯性与变更受控 | 在软件开发活动启动后且项目已批准配置管理计划时 | +| [csci-source-code-validation](csci-source-code-validation/SKILL.md) | 判定某软件实体是否为CSCI有效源文件拷贝 | 当需要验证用于重建可执行软件的源代码集合是否与基线清单完全一致时 | +| [implement-risk-management-framework](implement-risk-management-framework/SKILL.md) | 系统化识别、分析、排序、应对和监控项目风险，降低不确定性并保障项目目标达成 | 在项目启动后且风险管理人员已指定时，尤其适用于需遵循GJB438C标准的国防或高可靠性软件项目 | +| [软件测量与分析实施](软件测量与分析实施/SKILL.md) | 系统化定义测量目标、选择测度、收集数据、分析结果并生成报告以支持决策和改进 | 当项目已定义测量目标且具备数据收集机制，并需依据客观数据进行进度、质量、生产率或风险评估时 | +| [project-human-resource-planning](project-human-resource-planning/SKILL.md) | 根据WBS制定项目人力资源计划，明确岗位职责、能力要求、涉密等级及人员获取策略 | 在制定项目计划阶段，确保配备足够且合规的人力资源时 | +| [define-project-organizational-structure](define-project-organizational-structure/SKILL.md) | 明确项目组织机构、职责分工、权限边界及决策机制，形成清晰治理结构 | 在项目立项后且关键干系人已识别时，特别适用于需符合GJB438C标准的多方协作复杂项目 | +| [software-quality-assurance-independence](software-quality-assurance-independence/SKILL.md) | 确保软件产品评价、QA活动及IV&V过程具备组织与执行上的独立性 | 当开展软件产品评价、实施QA活动或项目要求第三方IV&V时 | +| [software-handover-preparation](software-handover-preparation/SKILL.md) | 准备向保障机构移交软件所需的全部程序、源文件、文档、手册及移交计划 | 当项目需将软件正式移交给负责后期维护的保障单位时，尤其适用于遵循GJB438C标准的军用或高保障级项目 | +| [gjb438c-software-requirements-spec-structure](gjb438c-software-requirements-spec-structure/SKILL.md) | 指导用户按GJB 438C-2021标准构建软件需求规格说明（SRS）或CSCI需求文档的结构 | 当用户需要编写正式的军用软件需求文档时 | +| [接口标识与接口图设计](接口标识与接口图设计/SKILL.md) | 为含多个接口的系统或软件配置项分配唯一标识符并绘制接口图，表达接口实体及其关系 | 当文档中存在两个或以上接口、需进行正式接口设计或系统集成时 | +| [describe-interface-communication-characteristics](describe-interface-communication-characteristics/SKILL.md) | 系统化描述涉及通信传输的接口的关键通信机制特征 | 当需要为通信接口、网络接口或硬件接口编写技术文档或规范，且该接口具备跨实体数据传输行为时 | +| [software-design-description-structure](software-design-description-structure/SKILL.md) | 提供符合军用标准的软件设计说明文档（含CSCI设计文档）的标准结构模板 | 当用户需要编写或审查软件设计说明文档，且已具备需求规格说明并进入详细设计阶段时 | +| [interface-data-element-specification](interface-data-element-specification/SKILL.md) | 为涉及数据交换的接口提供标准化的数据元素特征描述清单 | 当接口涉及具体数据传输且需详细说明每个数据项的属性时 | +| [test-input-design-specification](test-input-design-specification/SKILL.md) | 系统化定义和组织测试输入内容，确保覆盖功能、边界、异常及压力场景 | 当需要为软件验证活动创建结构化的测试输入方案（含数据来源、真实性、取值范围及控制策略）时 | +| [software-test-plan-scope-and-content](software-test-plan-scope-and-content/SKILL.md) | 制定符合GJB438C附录D格式要求的软件测试计划（STP） | 当需对CSCI或系统/子系统进行合格性测试时 | +| [software-test-specification-structure](software-test-specification-structure/SKILL.md) | 定义正式软件测试说明文档（含测试计划和测试用例）的标准结构 | 当需要编写符合工程规范的软件测试说明文档、且已具备软件需求规格说明并需制定测试方案时 | +| [shuang-xiang-xu-qiu-ke-zhui-su-xing-jian-li](shuang-xiang-xu-qiu-ke-zhui-su-xing-jian-li/SKILL.md) | 建立软件工程文档与对应需求之间的双向可追踪性矩阵 | 当文档涉及多层次需求分解且需验证需求是否被完整实现时 | +| [csci-external-interface-requirement-specification](csci-external-interface-requirement-specification/SKILL.md) | 系统化描述CSCI外部接口的完整技术规格 | 当需要编写或审查CSCI与外部系统、组件或用户之间的接口需求文档时 | +| [gjb438c-military-software-document-structure](gjb438c-military-software-document-structure/SKILL.md) | 指导正确构建符合GJB438C标准的军用软件文档组成结构 | 当用户需要创建、审核或修改任何GJB438C规定的军用软件文档时 | +| [gjb2786-sdp-dynamic-update](gjb2786-sdp-dynamic-update/SKILL.md) | 执行软件开发计划（SDP）的分析、修订与重新基线化 | 当项目出现重大偏差（如进度延误>20%、关键资源变更、需求重大调整）或到达预设里程碑时 | +| [software-user-manual-creation](software-user-manual-creation/SKILL.md) | 判断是否需编制独立软件用户手册（SUM）并在需要时按规范生成内容 | 当软件由用户直接运行且具有联机输入/输出接口时 | +| [interface-protocol-feature-specification](interface-protocol-feature-specification/SKILL.md) | 系统化描述接口所用通信、网络或接口协议的关键特征 | 当需要编写或审查接口协议文档、设计新协议或排查协议相关问题时 | +| [shu-ju-ku-she-ji-shuo-ming-jie-gou-bian-xie](shu-ju-ku-she-ji-shuo-ming-jie-gou-bian-xie/SKILL.md) | 提供符合行业标准的数据库设计说明文档结构化章节框架 | 当需要编写正式的数据库设计说明文档，适用于数据库设计、数据管理系统或软件数据组件开发场景时 | +| [csci-component-description](csci-component-description/SKILL.md) | 详细说明组成CSCI的所有软件单元及其静态关系、用途、开发状态和硬件资源使用情况 | 当需要在软件架构文档或CSCI设计中描述内部组件，且已确定CSCI架构时 | +| [as-built-software-design-documentation](as-built-software-design-documentation/SKILL.md) | 决定在CSCI支持文档中内嵌还是引用“已构建”软件设计信息，确保反映实际构建结构 | 在编写CSCI支持文档且需提供真实反映实际构建软件结构的设计信息时 | +| [military-software-document-delivery-format](military-software-document-delivery-format/SKILL.md) | 确定并规范军用软件交付文档的物理或电子载体类型及具体格式 | 当用户需要准备作为军用软件合同交付物的文档时 | +| [csci-build-procedure-specification](csci-build-procedure-specification/SKILL.md) | 编写符合军用软件标准的CSCI编译与构建规程文档 | 当需要详细描述如何从源代码构建可执行软件、确保构建过程可重现并满足SPS要求时 | +| [junyong-ruanjian-sdsr-bianzhi](junyong-ruanjian-sdsr-bianzhi/SKILL.md) | 编制符合GJB438C第5.20条要求的军用软件研制总结报告（SDSR） | 当军用软件项目完成全部研制工作、承制方需正式总结全过程并明确交付结论时 | +| [csci-nei-bu-ke-zhui-su-xing-ju-zhen-gou-jian](csci-nei-bu-ke-zhui-su-xing-ju-zhen-gou-jian/SKILL.md) | 构建CSCI内部及与需求之间的双向可追踪性矩阵 | 当需要建立源文件、软件单元、硬件资源使用测量与CSCI需求之间的双向追踪关系时 | +| [csci-hardware-resource-usage-description](csci-hardware-resource-usage-description/SKILL.md) | 生成符合GJB 438C-2021标准第5.4条要求的CSCI硬件资源使用说明 | 当需要编写SPS或相关文档中的“硬件资源使用”章节，且已构建CSCI并完成资源测量或估算时 | + +## 快速导航 + +### 需求与可追溯性 +- shuang-xiang-xu-qiu-ke-zhui-su-xing-jian-li +- csci-nei-bu-ke-zhui-su-xing-ju-zhen-gou-jian +- csci-external-interface-requirement-specification + +### 接口设计与规范 +- gjb438c-interface-design-spec-structure +- 接口标识与接口图设计 +- describe-interface-communication-characteristics +- interface-data-element-specification +- interface-protocol-feature-specification + +### 软件设计与架构 +- software-design-description-structure +- shu-ju-ku-she-ji-shuo-ming-jie-gou-bian-xie +- csci-component-description +- as-built-software-design-documentation +- csci-hardware-resource-usage-description + +### 文档结构与编制（GJB标准） +- gjb438c-software-requirements-spec-structure +- gjb438c-military-software-document-structure +- junyong-ruanjian-sdsr-bianzhi +- military-software-document-tailoring +- military-software-document-delivery-format + +### 测试与验证 +- csci-executable-software-validation +- csci-source-code-validation +- software-test-plan-scope-and-content +- software-test-specification-structure +- test-input-design-specification + +### 配置与质量管理 +- software-configuration-management +- software-quality-assurance-independence +- implement-risk-management-framework +- 软件测量与分析实施 + +### 项目管理与组织 +- project-human-resource-planning +- define-project-organizational-structure +- fen-cheng-zhi-fang-guan-li +- lian-he-ping-shen-lei-xing-yu-nei-rong + +### 部署与交付支持 +- software-installation-plan-development +- software-deployment-preparation +- software-handover-preparation +- software-acceptance-support +- software-user-manual-creation +- csci-build-procedure-specification +- gjb2786-sdp-dynamic-update +- corrective-action-system-implementation + +## 使用方法 + +您可以使用以下格式的提示调用特定技能： + +- “请根据 **gjb438c-interface-design-spec-structure** 技能，生成一份符合GJB 438C的接口设计说明文档大纲。” +- “运用 **shuang-xiang-xu-qiu-ke-zhui-su-xing-jian-li** 技能，建立软件需求与测试用例之间的双向追溯矩阵。” +- “依据 **software-configuration-management** 技能，制定军用软件项目的配置管理计划要点。” +- “使用 **junyong-ruanjian-sdsr-bianzhi** 技能，编写一份军用软件设计说明报告（SDSR）的模板。” + +只需在提示中明确引用技能名称，即可获得符合军用标准的专业指导与输出。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/interface-data-element-specification/SKILL.md b/GJB438C-2021_prd_skills/interface-data-element-specification/SKILL.md new file mode 100644 index 0000000..8f70cdf --- /dev/null +++ b/GJB438C-2021_prd_skills/interface-data-element-specification/SKILL.md @@ -0,0 +1,47 @@ +--- +name: 接口数据元素特征描述规范 +description: 为涉及数据交换的接口（如接口设计文档、数据交换规范或通信协议）提供标准化的数据元素特征描述清单。当接口涉及具体数据传输且需详细说明每个数据项的属性时使用本技能。 +--- + +# 接口数据元素特征描述规范 + +## 何时使用 +- 接口涉及数据交换（如系统间通信、API 设计、数据共享） +- 需要为接口中的每个数据元素提供完整、明确的技术与业务描述 +- 文档类型包括：接口设计文档、数据交换规范、通信协议 +- 不适用于仅描述功能逻辑而不包含具体数据字段的高层接口 + +## 执行步骤 +对每个在接口中被提供、存储、发送、访问或接收的数据元素，按以下结构进行描述： + +1. **名称/标识符** + - 唯一标识符 + - 非技术名称（自然语言名称） + - 数据元素名称（优先采用行业或组织内标准化名称） + - 技术名称（如变量名、数据库字段名） + - 缩写名或同义名 + +2. **数据类型**（如字母、数字、整数、布尔值、日期时间等） + +3. **大小和格式**（如字符串最大长度、日期格式 YYYY-MM-DD） + +4. **计量单位**（如 m、kg、秒；若适用） + +5. **取值范围或枚举值**（如 0~99、['active', 'inactive']） + +6. **准确度与精度** + - 准确度：数据反映真实值的程度 + - 精度：有效数字位数或小数位数 + +7. **业务与操作约束** + - 优先级、时序要求、更新频率 + - 容量限制、序列依赖 + - 是否可更新、适用的业务规则 + +8. **保密性约束**（如是否包含敏感信息、是否需加密传输） + +9. **来源与接收者** + - 来源：创建或发送该数据元素的实体 + - 接收者：使用或接收该数据元素的实体 + +确保所有描述清晰、无歧义，并尽可能复用已有标准命名体系。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/interface-protocol-feature-specification/SKILL.md b/GJB438C-2021_prd_skills/interface-protocol-feature-specification/SKILL.md new file mode 100644 index 0000000..25ce8c7 --- /dev/null +++ b/GJB438C-2021_prd_skills/interface-protocol-feature-specification/SKILL.md @@ -0,0 +1,24 @@ +--- +name: 接口协议特征描述规范 +description: 当接口使用特定通信、网络或接口协议时，必须系统化描述其关键特征以确保双方对协议行为和异常恢复机制有一致理解。在需要编写或审查接口协议文档、设计新协议或排查协议相关问题时使用本技能。 +--- + +# 接口协议特征描述规范 + +## 何时使用 +- 接口明确依赖某种协议（如 HTTP、TCP、自定义二进制协议等） +- 需要为接口协议编写完整的技术规范文档 +- 协议行为存在歧义或需明确异常处理机制 +- 不适用于无协议的简单数据传递接口 + +## 如何执行 +对所使用的接口协议，必须完整描述以下六类特征： + +1. **唯一标识符**：明确协议名称、版本号及全局唯一标识 +2. **协议层次**：说明协议在通信栈中的层级（如应用层、传输层） +3. **打包与路由**：描述数据的打包、拆包、重新打包机制，以及路由和寻址规则 +4. **错误控制**：定义合法性检查方法、错误检测机制及恢复流程 +5. **同步机制**：说明连接的建立、维护和终止方式（如同步/异步、长连接/短连接） +6. **状态报告**：列出需暴露的状态信息、标识符及其他运行时报告内容 + +确保描述内容足以让协议双方在正常和异常场景下均能正确交互。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/junyong-ruanjian-sdsr-bianzhi/SKILL.md b/GJB438C-2021_prd_skills/junyong-ruanjian-sdsr-bianzhi/SKILL.md new file mode 100644 index 0000000..7581fe5 --- /dev/null +++ b/GJB438C-2021_prd_skills/junyong-ruanjian-sdsr-bianzhi/SKILL.md @@ -0,0 +1,40 @@ +--- +name: 军用软件研制总结报告（SDSR）编制 +description: 编制符合GJB438C第5.20条要求的军用软件研制总结报告（SDSR），用于在软件研制完成后向订购方提交验收依据。当军用软件项目完成全部研制工作、承制方需正式总结全过程并明确交付结论时使用本技能。 +--- + +# 军用软件研制总结报告（SDSR）编制 + +## 适用场景 +- 军用软件项目已完成全部研制活动 +- 承制方需向订购方提交正式验收文档 +- 需全面总结软件工程化实施过程与结果 + +## 编制步骤 + +1. **确认前提条件**：确保软件研制工作已全部完成，具备编制SDSR的基础。 + +2. **按GJB438C第5.20条组织11项核心内容**： + - a) 任务来源与研制依据 + - b) 软件概述 + - c) 软件研制过程（含过程概述、各阶段方法、工作产品） + - d) 质量控制情况（含质量控制活动、重大技术问题及解决方案） + - e) 质量保证情况（含组织建立、制度建设、各阶段活动） + - f) 软件技术问题及解决情况（可与d项重复但需详述） + - g) 配置管理情况（含要求、实施、状态变更记录） + - h) 安全性、保密性等关键需求实现情况 + - i) 软件满足任务指标情况 + - j) 测量和分析活动及结果 + - k) 结论（含工程化评述、功能性能满足情况、是否可交付的明确结论） + +3. **遵循格式规范**：正文格式必须严格符合GJB438C附录T（资料性附录）的要求。 + +4. **输出明确交付结论**：在“结论”部分必须包含是否可交付使用的清晰判断。 + +## 注意事项 +- 不得遗漏GJB438C第5.20条任一要点 +- 技术问题描述应具体，避免模糊表述 +- 质量保证与质量控制内容需区分清楚 +- 所有研制阶段（需求、设计、实现、测试等）均需覆盖 + +完成上述步骤后，生成完整的SDSR文档，作为验收和后续保障的核心依据。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/lian-he-ping-shen-lei-xing-yu-nei-rong/SKILL.md b/GJB438C-2021_prd_skills/lian-he-ping-shen-lei-xing-yu-nei-rong/SKILL.md new file mode 100644 index 0000000..cf9ac5b --- /dev/null +++ b/GJB438C-2021_prd_skills/lian-he-ping-shen-lei-xing-yu-nei-rong/SKILL.md @@ -0,0 +1,37 @@ +--- +name: 联合评审类型与内容 +description: 在项目到达关键里程碑且评审计划与材料已准备就绪时，组织并执行联合技术评审（JTR）或联合管理评审（JMR），以评估技术合理性或项目管理状态，并形成正式结论指导后续决策。 +--- + +# 联合评审类型与内容 + +## 何时使用 +- 项目到达关键里程碑 +- 评审计划已制定且评审材料已准备 +- 所有参与方已提前收到评审通知 + +## 如何执行 + +### 1. 判断评审类型 +根据评审目标选择以下类型之一： + +#### 联合技术评审（JTR） +- **目的**：评估技术方案、设计、代码或测试结果的技术合理性 +- **参与者**：技术专家、开发人员、测试人员、需方代表 +- **输出**：技术风险清单、改进建议、是否继续开发的建议 + +#### 联合管理评审（JMR） +- **目的**：评估项目进度、资源、成本、风险及合同履约情况 +- **参与者**：项目经理、需方管理层、保障机构代表 +- **输出**：项目状态报告、资源调整建议、合同变更建议 + +### 2. 执行评审 +- 按项目计划在主要阶段结束时组织评审 +- 确保所有适用对象（技术评审、管理评审、项目干系人）参与对应类型的评审 + +### 3. 记录与跟踪 +- 将评审建议正式记录 +- 跟踪所有建议直至关闭 + +### 4. 输出结论 +- 形成正式评审结论，用于指导后续技术或管理决策 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/military-software-document-delivery-format/SKILL.md b/GJB438C-2021_prd_skills/military-software-document-delivery-format/SKILL.md new file mode 100644 index 0000000..83e3c0d --- /dev/null +++ b/GJB438C-2021_prd_skills/military-software-document-delivery-format/SKILL.md @@ -0,0 +1,30 @@ +--- +name: 军用软件文档载体与格式要求 +description: 本技能用于在军用软件开发项目中，根据合同或技术协议确定并规范交付文档的物理或电子载体类型及具体格式。当用户需要准备作为军用软件合同交付物的文档时（例如软件需求规格说明、设计文档、测试报告等），应使用此技能确保符合GJB438C标准中附录A至附录T的规定。 +--- + +# 军用软件文档载体与格式要求 + +## 何时使用 +- 文档需作为军用软件开发合同或技术协议的正式交付物 +- 需明确文档的物理或电子载体类型 +- 需确认电子文档是否采用合规格式 + +## 执行步骤 +1. **确定文档载体类型**： + - 纸质文件 + - 电子文件介质 + +2. **若为电子文件，必须采用以下格式之一**： + - 数据库格式 + - 交互式电子手册 + - 文档处理器兼容格式（如WPS） + - 存储于计算机辅助软件工程（CASE）工具中的格式 + +3. **确保订购方在合同中明确规定**： + - 所交付文档的载体类型 + - 文档的具体格式要求 + +4. **适用范围**：此要求适用于GJB438C标准附录A至附录T所规定的全部军用软件开发文档类型。 + +> 注意：本技能仅适用于受军用合同约束的软件项目，不适用于非军用或无合同约束的软件开发活动。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/military-software-document-tailoring/SKILL.md b/GJB438C-2021_prd_skills/military-software-document-tailoring/SKILL.md new file mode 100644 index 0000000..42f71d1 --- /dev/null +++ b/GJB438C-2021_prd_skills/military-software-document-tailoring/SKILL.md @@ -0,0 +1,37 @@ +--- +name: 军用软件文档剪裁规则应用 +description: 当军用软件项目需根据实际开发活动调整文档种类或内容时，执行本技能以合规地剪裁文档，同时保留必要要素和可追溯性。仅在合同允许剪裁且采用特定生存周期模型的前提下使用。 +--- + +# 军用软件文档剪裁规则应用 + +## 何时使用 +- 项目采用特定软件生存周期模型 +- 合同明确允许对标准文档进行剪裁 +- 需合并、拆分文档或省略部分内容，但不得遗漏必要要素 + +## 执行步骤 +### 文档种类调整 +- **合并多个文档**： + - 选定一个主文档 + - 将其他文档内容有机整合进主文档 + - 确保所有标准要素完整保留 + - 在注释中说明合并情况 +- **拆分单个文档**： + - 拆分后的各文档结构须符合GJB438C第4.3条要求 + - 各部分要素内容保持一致 + - 在其中一个文档的注释中说明拆分情况 + +### 文档内容剪裁 +- **剪裁原则**：按标准标题顺序保持结构一致 +- **剪裁某章或某条**： + - 在被裁章节标题下标注“本章无内容”或“本条无内容” + - 必须附上剪裁理由 +- **剪裁整章（含所有子条）**： + - 仅在最高层级标题下标注并说明理由 + +### 非传统格式处理 +- 若使用数据库等非传统格式存储文档，仅需在目录表中标出被剪裁部分 + +## 输出结果 +生成符合GJB438C剪裁规则的文档，所有剪裁均有明确标注和理由说明，确保可追溯性不受影响。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/project-human-resource-planning/SKILL.md b/GJB438C-2021_prd_skills/project-human-resource-planning/SKILL.md new file mode 100644 index 0000000..94a9471 --- /dev/null +++ b/GJB438C-2021_prd_skills/project-human-resource-planning/SKILL.md @@ -0,0 +1,34 @@ +--- +name: 项目人力资源规划 +description: 根据已完成的工作分解结构（WBS）制定项目所需的人力资源计划，明确各类岗位的职责、技术能力要求、涉密等级及人员获取策略。在制定项目计划阶段触发此技能，确保项目配备足够且合规的人力资源。 +--- + +# 项目人力资源规划 + +## 何时使用 +- 已完成工作分解结构（WBS） +- 正在制定或更新项目整体计划 +- 需要明确项目所需人员配置、能力要求及保密合规性 + +## 执行步骤 + +1. **估算总人力投入**：基于WBS任务和历史数据，以“人时数”为单位估算完成项目所需的总人力。 + +2. **按职责分解人力需求**：将人力分配至以下典型职责类别（根据项目实际调整）： + - 项目管理 + - 软件工程 + - 软件测试 + - 软件配置管理 + - 软件产品评价 + - 软件质量保证 + +3. **描述人员能力要求**：对每类职责，明确所需的技术能力（如编程语言、开发工具）、经验水平及资质证书。 + +4. **标注地理位置与协作模式**：说明人员工作地点（本地/远程）、是否支持异地协作及沟通机制。 + +5. **确定涉密等级**：对每个岗位按“一般、重要、核心”三级标注涉密程度，并确保拟任人员具备相应密级资格；涉密岗位人员必须通过背景审查。 + +6. **制定人员获取计划**：说明通过内部调配、外部招聘或外包方式满足人力需求，并规划必要的岗前培训或技能提升安排。 + +## 输出成果 +形成完整的人力资源计划文档，包含人力总量、职责分布、能力要求、涉密等级及获取策略，确保项目有足够且合格的人员支持。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/shu-ju-ku-she-ji-shuo-ming-jie-gou-bian-xie/SKILL.md b/GJB438C-2021_prd_skills/shu-ju-ku-she-ji-shuo-ming-jie-gou-bian-xie/SKILL.md new file mode 100644 index 0000000..04b951d --- /dev/null +++ b/GJB438C-2021_prd_skills/shu-ju-ku-she-ji-shuo-ming-jie-gou-bian-xie/SKILL.md @@ -0,0 +1,51 @@ +--- +name: 编写标准化数据库设计说明文档结构 +description: 当需要编写正式的数据库设计说明文档时使用本技能。适用于数据库设计文档、数据管理系统或软件数据组件的开发场景，不适用于简单配置文件或临时数据存储。该技能提供符合行业标准的结构化章节框架，确保覆盖范围、设计决策、详细设计、可追踪性等关键内容。 +--- + +# 编写标准化数据库设计说明文档结构 + +在以下情况下应用本技能： +- 存在明确的数据库设计需求 +- 需要产出正式、可审计的数据库设计文档 +- 文档需支持系统级需求追溯与团队协作 + +## 执行步骤 + +1. **范围章节** + - 提供文档标识（如版本、作者、日期） + - 概述数据库用途与目标 + - 描述本文档的结构与目的 + +2. **引用文档章节** + - 列出所有规范性引用文档（如需求规格说明书、系统架构文档） + - 注明非正式或非标准来源（如有） + +3. **数据库级设计决策章节** + 按以下子项逐一说明高层设计选择： + - 输入输出设计决策 + - 响应行为设计决策 + - 数据呈现方式设计决策 + - DBMS选型及未来灵活性考量 + - 可用性、安全性、保密性、连续性等级设计 + - 分布式架构决策（如客户/服务器模型、数据同步策略、一致性机制） + - 备份与恢复策略 + - 重组、排序、索引及同步机制设计 + +4. **数据库详细设计章节** + 按设计级别（概念、逻辑、物理、内部）分层描述： + - **数据元素特征**：包括标识符、数据类型、格式、取值约束、默认值等 + - **数据元素组合体特征**：描述表、记录等结构化实体的组成、关系（如主外键）、完整性约束等 + +5. **数据库访问/操纵软件单元详细设计章节** + - 说明用于操作数据库的程序模块、API 或脚本的设计细节 + - 包括接口参数、调用方式、错误处理等 + +6. **需求可追踪性章节** + - 建立数据库设计项与系统/CSCI需求之间的双向追溯矩阵 + - 确保每个设计决策均可回溯至原始需求 + +7. **注释章节** + - 提供背景信息、术语定义、缩略语表或关键公式说明 + +> **注意**：使用“数据元素”指代字段或属性（无结构），使用“数据元素组合体”指代表、记录等有结构的实体。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/shuang-xiang-xu-qiu-ke-zhui-su-xing-jian-li/SKILL.md b/GJB438C-2021_prd_skills/shuang-xiang-xu-qiu-ke-zhui-su-xing-jian-li/SKILL.md new file mode 100644 index 0000000..a68aa15 --- /dev/null +++ b/GJB438C-2021_prd_skills/shuang-xiang-xu-qiu-ke-zhui-su-xing-jian-li/SKILL.md @@ -0,0 +1,36 @@ +--- +name: 双向需求可追踪性建立 +description: 建立软件工程文档（如接口设计说明、软件需求规格说明、软件设计说明、软件测试说明）与对应需求之间的双向可追踪性矩阵。当文档涉及多层次需求分解且需验证需求是否被完整实现时使用本技能。 +--- + +# 双向需求可追踪性建立 + +## 何时使用 +- 文档涉及需求实现（如设计或测试文档） +- 存在多层次需求分解（例如系统需求 → CSCI 需求 → 软件单元） +- 需要确保每个需求都被实现，且每个实现都源于有效需求 +- 不适用于单一层次、无分解的需求场景 + +## 如何执行 +对以下四类文档分别建立双向可追踪性： + +### 1. 接口设计说明 +- **正向追踪**：从每个接口实体追踪到对应的系统/CSCI 需求 +- **反向追踪**：从每个系统/CSCI 需求追踪到对应的接口实体 + +### 2. 软件需求规格说明 +- **正向追踪**：从每个 CSCI 需求追踪到所涉及的系统/子系统需求 +- **反向追踪**：从每个已分配的系统/子系统需求追踪到对应的 CSCI 需求 + +### 3. 软件设计说明 +- **正向追踪**：从每个软件单元追踪到分配给它的 CSCI 需求 +- **反向追踪**：从每个 CSCI 需求追踪到被分配这些需求的软件单元 + +### 4. 软件测试说明 +- **正向追踪**：从每个测试用例追踪到所涉及的系统或 CSCI 需求 +- **反向追踪**：从每项系统或 CSCI 需求追踪到覆盖它的测试用例 + +> **注意**：若接口需求由系统架构设计导出但未在原始系统需求中明确列出，可将其追踪至“系统实现”等通用需求，或追溯至产生该需求的系统设计决策。 + +## 输出结果 +生成完整的双向需求可追踪性矩阵，包含所有适用文档与对应需求之间的双向链接。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/software-acceptance-support/SKILL.md b/GJB438C-2021_prd_skills/software-acceptance-support/SKILL.md new file mode 100644 index 0000000..db47b0e --- /dev/null +++ b/GJB438C-2021_prd_skills/software-acceptance-support/SKILL.md @@ -0,0 +1,48 @@ +--- +name: software-acceptance-support +description: 在软件项目进入验收阶段时，为需方提供全面的验收支持活动，包括测试协助、产品交付、培训实施和问题响应。当用户需要执行或协调符合GJB438C标准的软件验收流程时使用本技能。 +--- + +# 软件验收支持 + +## 何时使用 +- 项目已进入合同约定的软件验收阶段 +- 需方已确认验收标准且软件已完成内部测试 +- 用户角色为供方项目团队成员，需协助需方完成验收 + +## 执行步骤 + +1. **支持需方开展验收测试** + - 提供稳定的测试环境 + - 准备并移交测试数据 + - 提供测试用例说明文档 + - 安排技术人员现场或远程支持 + +2. **交付软件产品** + - 按合同清单完整交付： + - 可执行软件 + - 技术文档与用户手册 + - 安装介质（如光盘、U盘） + - 软件许可证或授权文件 + +3. **提供培训服务** + - 实施三类培训： + - 操作培训：面向最终用户 + - 维护培训：面向系统管理员或维护人员 + - 应急处理培训：针对故障场景的快速响应 + - 采用合适形式：课堂讲授、实习操作或定向指导 + - 所有培训内容须经需方书面认可 + +4. **提供持续支持** + - 在验收期内及时响应需方提交的问题报告 + - 协助分析测试失败原因，区分是否为软件缺陷 + - 不替代需方做出是否通过验收的最终决策 + +5. **记录支持活动** + - 建立验收支持日志，包含： + - 支持时间、内容、参与人员 + - 问题描述与处理结果 + - 需方反馈 + - 日志作为项目交付的关键证据存档 + +> **注意**：本技能不适用于替代需方自主验收决策，所有支持活动均以协助角色开展。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/software-configuration-management/SKILL.md b/GJB438C-2021_prd_skills/software-configuration-management/SKILL.md new file mode 100644 index 0000000..142dcc3 --- /dev/null +++ b/GJB438C-2021_prd_skills/software-configuration-management/SKILL.md @@ -0,0 +1,22 @@ +--- +name: 软件配置管理实施 +description: 在软件开发活动启动后，执行本技能以建立和维护软件配置管理体系，确保工作产品的完整性、可追溯性与变更受控。适用于已批准配置管理计划的项目，不适用于无版本控制需求的小型项目。 +--- + +# 软件配置管理实施 + +## 何时使用 +- 项目已正式启动且配置管理计划已获批准 +- 需对源代码、文档、测试用例等关键工作产品进行版本控制和变更管理 +- 要求满足GJB438C等军用软件标准中的配置管理条款 + +## 执行步骤 +1. **识别配置项**：确定需纳入配置管理的所有工作产品（如源代码、设计文档、测试用例、构建脚本等）。 +2. **建立配置库**：设置访问权限、备份策略及审计日志机制。 +3. **建立基线**：在关键里程碑（如需求冻结、设计完成）创建功能基线、分配基线和产品基线。 +4. **控制变更**：通过问题报告/更改报告流程，对所有变更进行评审、批准、实施与验证。 +5. **状态统计**：定期生成配置项状态报告，记录变更历史及基线内容。 +6. **配置审核**：执行功能审核（验证是否满足需求）和物理审核（验证交付物与文档一致性）。 + +## 输出结果 +确保软件产品在整个生命周期中保持完整性、可追溯性，并实现变更受控。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/software-deployment-preparation/SKILL.md b/GJB438C-2021_prd_skills/software-deployment-preparation/SKILL.md new file mode 100644 index 0000000..fb79161 --- /dev/null +++ b/GJB438C-2021_prd_skills/software-deployment-preparation/SKILL.md @@ -0,0 +1,21 @@ +--- +name: 软件部署前准备活动 +description: 当软件即将部署至用户现场时，执行本技能以生成完整的软件使用准备包，包括可执行程序、版本说明文档、用户手册及安装流程。适用于已完成构建并通过合格性测试的可执行软件，不适用于开发早期阶段或涉及源代码交付的场景。 +--- + +# 软件部署前准备活动 + +## 何时使用 +- 软件已通过合格性测试并完成最终构建 +- 即将向用户现场交付或部署软件 +- 需要提供符合合同约定格式的交付材料 + +## 执行步骤 +1. **准备可执行软件**：确认软件已完成构建并通过所有合格性测试。 +2. **编制版本说明文档**：包含软件标识号、名称、缩略名、版本号、发布号及变更摘要。 +3. **编写用户手册**：详细说明软件功能、操作步骤、输入输出格式、错误处理机制及安全提示。 +4. **制定用户现场安装途径**：明确安装步骤、所需运行环境、依赖项、人员职责及安装后验证方法。 +5. **确保合规交付**：所有材料须满足保密性要求，并按合同规定格式打包交付。 + +## 输出结果 +生成完整的软件使用准备包，包含可执行程序、版本说明、用户手册及清晰的安装流程说明。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/software-design-description-structure/SKILL.md b/GJB438C-2021_prd_skills/software-design-description-structure/SKILL.md new file mode 100644 index 0000000..2df48f4 --- /dev/null +++ b/GJB438C-2021_prd_skills/software-design-description-structure/SKILL.md @@ -0,0 +1,43 @@ +--- +name: 软件设计说明结构要求 +description: 本技能提供符合军用标准的软件设计说明文档（包括CSCI设计文档）的标准结构模板。当用户需要编写或审查软件设计说明文档，且已具备需求规格说明并进入详细设计阶段（非概念设计阶段）时，应使用此技能。 +--- + +# 软件设计说明结构要求 + +## 适用条件 +- 已完成需求规格说明 +- 正在进行软件详细设计（不适用于概念设计阶段） +- 编写对象为软件设计说明文档或CSCI设计文档 + +## 执行步骤 + +1. **范围章节** + - 包含文档标识、系统概述、文档概述 + +2. **引用文档章节** + - 列出所有被引用的标准、规范和文档 + +3. **CSCI级设计决策章节** + - 描述影响软件单元选择与设计的关键决策，包括： + a) 输入输出设计决策 + b) 响应行为设计决策 + c) 数据库/数据文件呈现决策 + d) 安全性和保密性方法 + e) 其他CSCI级设计决策 + +4. **CSCI体系结构设计章节** + - a) **CSCI部件**：描述所有软件单元（如类、模块、函数、数据库等）、静态关系、用途、开发状态、资源使用及库位置 + - b) **执行方案**：说明软件单元间的动态关系，包括控制流程、数据流、状态转换等 + - c) **接口设计**：按接口标识符逐一描述接口特性 + +5. **CSCI详细设计章节** + - 按软件单元标识符分条目详细描述每个单元的设计实现 + +6. **需求可追踪性章节** + - 建立软件单元与CSCI需求之间的双向可追踪性矩阵 + +7. **注释章节** + - 包含背景信息、术语表、缩略语解释或必要公式 + +> 提示：确保每个章节内容聚焦于设计而非需求；设计决策应明确说明“为什么这样设计”而非仅描述功能。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/software-handover-preparation/SKILL.md b/GJB438C-2021_prd_skills/software-handover-preparation/SKILL.md new file mode 100644 index 0000000..5f7bf02 --- /dev/null +++ b/GJB438C-2021_prd_skills/software-handover-preparation/SKILL.md @@ -0,0 +1,25 @@ +--- +name: software-handover-preparation +description: 准备向保障机构移交软件所需的全部可执行程序、源文件、设计文档、保障手册及移交计划。当项目需将软件正式移交给负责后期维护的保障单位时使用本技能，尤其适用于遵循GJB438C标准的军用或高保障级软件项目。 +--- + +# 软件移交准备工作 + +## 适用条件 +- 软件开发已完成 +- 配置管理基线已建立 +- 软件需移交至保障机构（不适用于仅提供服务的项目） +- 若需方未要求源码，可省略源文件准备 + +## 执行步骤 + +1. **准备可执行软件**：确保其为最终交付版本，包含所有补丁和配置。 +2. **准备源文件**：包括全部源代码、编译脚本、构建说明及版本控制记录（若合同或需方要求）。 +3. **编制保障现场适用的版本说明**：明确软件标识、配置项及变更历史。 +4. **整理已构建的CSCI设计及相关信息**：如架构图、接口说明、数据字典等。 +5. **更新系统或子系统设计说明**：反映最终实现状态。 +6. **编写保障手册**：涵盖安装、维护、故障诊断、备份恢复等操作指南。 +7. **制定移交途径**：包括包装、运输、现场安装、检测及培训计划，确保与合同进度一致。 + +## 输出成果 +形成完整的软件移交包，包含软件、文档、手册及移交执行计划。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/software-installation-plan-development/SKILL.md b/GJB438C-2021_prd_skills/software-installation-plan-development/SKILL.md new file mode 100644 index 0000000..982d392 --- /dev/null +++ b/GJB438C-2021_prd_skills/software-installation-plan-development/SKILL.md @@ -0,0 +1,55 @@ +--- +name: software-installation-plan-development +description: 制定符合GJB438C标准的软件安装计划，涵盖安装概述、资源保障、培训安排、任务分解及现场实施细节。当软件需在用户现场部署且已通过验收、安装环境已确认时使用本技能。 +--- + +# 软件安装计划制定 + +## 适用场景 +当满足以下条件时启动本流程： +- 软件已通过验收测试 +- 用户现场安装环境已确认 +- 需在用户现场执行软件部署 + +## 执行步骤 + +### 1. 编写安装概述 +- 明确安装地点、总体进度安排和安装方法。 + +### 2. 指定联络点 +- 列出负责安装问题咨询的组织、部门及联系方式，确保沟通渠道畅通。 + +### 3. 明确保障材料需求 +- 列出所需光盘、打印纸、专用表格等材料的类型、来源和数量。 + +### 4. 制定培训计划 +- 包含定向培训、课堂培训和实习培训的具体内容与时间安排。 + +### 5. 编制安装任务列表 +按以下子项逐项规划： +- 总体策划与协调 +- 安装小组人员配备 +- 住宿、交通、办公设施安排 +- 安装手册准备 +- 安装前准备工作 +- 培训活动组织 +- 计算机支持和技术帮助 +- 现行系统转换准备 + +### 6. 明确人员要求 +- 规定所需人员数量、专业类型、技能水平及轮班安排。 + +### 7. 制定保密措施 +- 概述安装过程中涉及的数据与操作的保密性控制手段。 + +### 8. 补充现场专用信息 +- 针对每个用户现场，详细说明： + - 安装规程 + - 数据初始化步骤 + - 系统转换流程 + - 手册演示操作 + +## 注意事项 +- 必须考虑用户现场的特殊限制（如空间、电力、网络、安全策略等）。 +- 安装计划应确保风险可控、过程可追溯、结果可验证。 +- 所有输出应形成结构化、可执行的安装计划文档。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/software-quality-assurance-independence/SKILL.md b/GJB438C-2021_prd_skills/software-quality-assurance-independence/SKILL.md new file mode 100644 index 0000000..870a577 --- /dev/null +++ b/GJB438C-2021_prd_skills/software-quality-assurance-independence/SKILL.md @@ -0,0 +1,42 @@ +--- +name: 软件质量保证独立性保障 +description: 确保软件产品评价、质量保证（QA）活动及独立验证与确认（IV&V）过程具备组织与执行上的独立性。当开展软件产品评价、实施QA活动或项目要求第三方IV&V时，必须应用本技能以防止利益冲突、保障客观性，并满足GJB438C等标准要求。 +--- + +# 软件质量保证独立性保障 + +## 适用场景 +- 进行软件产品正式评价时 +- 启动软件质量保证（QA）活动时 +- 项目合同要求引入独立IV&V机构时 + +## 核心执行步骤 + +### 1. 确保评价/QA/IV&V团队的组织独立性 +- 评价团队、QA团队或IV&V机构不得由直接参与该软件开发的人员组成。 +- QA团队应向独立于项目经理的上级汇报。 +- IV&V机构必须完全独立于开发方，且不得受其干预。 + +### 2. 明确独立性声明与职责定义 +- 在质量保证计划、评价报告或IV&V协议中明确定义独立性要求。 +- 在评价或QA报告中声明评价者身份、隶属关系及利益冲突情况。 + +### 3. 建立信息访问与沟通机制 +- 确保评价/QA/IV&V方有权无限制访问所有项目文档、代码和测试结果。 +- 开发方指定专人作为IV&V联络接口人。 +- 按计划共享需求、设计、测试计划等必要材料。 + +### 4. 规范评审与记录要求 +- 覆盖全过程和最终产品，包括中间产物（如设计文档）和交付物。 +- 记录必须包含：评价/QA方法、发现的问题、不符合项、改进建议、纠正措施跟踪及关闭证据。 +- 邀请IV&V参与关键评审（如需求、设计、测试评审）。 + +### 5. 保障执行有效性 +- 及时响应IV&V或QA提出的问题并记录处理结果。 +- 定期交换进展报告，确保活动同步。 +- 签署保密协议，确保信息安全。 + +## 输出与风险提示 +- 若缺乏独立性，评价或QA结果无效，需重新组织相关活动。 +- QA不具备独立性将显著升高项目质量风险。 +- 有效执行可提升软件可信度，满足GJB438C等军用软件标准要求。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/software-test-plan-scope-and-content/SKILL.md b/GJB438C-2021_prd_skills/software-test-plan-scope-and-content/SKILL.md new file mode 100644 index 0000000..758d435 --- /dev/null +++ b/GJB438C-2021_prd_skills/software-test-plan-scope-and-content/SKILL.md @@ -0,0 +1,28 @@ +--- +name: 软件测试计划适用范围与内容要求 +description: 本技能用于在需对计算机软件配置项（CSCI）、软件系统或子系统开展合格性测试时，制定符合GJB438C附录D格式要求的软件测试计划（STP）。当触发条件“需对CSCI或系统/子系统进行合格性测试”成立时，必须使用本技能生成供需方评估测试充分性的STP文档。 +--- + +# 软件测试计划适用范围与内容要求 + +## 何时使用 +- 当需要对**计算机软件配置项（CSCI）**、**软件系统**或**子系统**执行**合格性测试**（即验证是否满足合同或需求规格）时； +- 触发条件：IF 需对CSCI或系统/子系统进行合格性测试 THEN 必须制定STP； +- 注意：单元测试、单元集成测试、系统集成测试可参考附录D执行，但非强制要求。 + +## 如何执行 +1. **确认测试对象**：明确被测对象为以下之一： + - 计算机软件配置项（CSCI） + - 软件系统 + - 子系统 + +2. **编写STP核心内容**，必须包括以下三部分： + - **测试环境**：列出硬件、软件、网络配置及测试工具； + - **要执行的测试**：说明测试项、测试类型（以合格性测试为主）、测试级别； + - **测试活动进度**：提供时间安排、资源分配及关键依赖关系。 + +3. **确保格式合规**：STP正文必须严格遵循GJB438C标准中的**附录D（规范性附录）**格式。 + +4. **交付目标**：生成的STP文档应使需方能够有效评估该合格性测试策划的充分性。 + +> 提示：若涉及非合格性测试（如单元测试），可参考附录D，但无需强制纳入主STP正文。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/software-test-specification-structure/SKILL.md b/GJB438C-2021_prd_skills/software-test-specification-structure/SKILL.md new file mode 100644 index 0000000..9ee26e7 --- /dev/null +++ b/GJB438C-2021_prd_skills/software-test-specification-structure/SKILL.md @@ -0,0 +1,50 @@ +--- +name: software-test-specification-structure +description: 定义正式软件测试说明文档（包括测试计划和测试用例）的标准结构。当需要编写符合工程规范的软件测试说明文档、且已具备软件需求规格说明并需制定测试方案时使用此技能。不适用于探索性测试或非正式测试。 +--- + +# 软件测试说明文档结构构建 + +## 何时使用 +- 正在编写正式的软件测试说明文档、测试计划或测试用例 +- 已完成软件需求规格说明（SRS） +- 需要制定结构化、可追溯、可评审的测试方案 +- 测试类型为系统测试、集成测试或验收测试等正式测试活动 + +## 如何执行 + +按照以下章节顺序构建测试说明文档： + +### 1. 范围章节 +- 提供文档唯一标识符 +- 描述被测系统概述 +- 说明本文档的目的与内容范围 + +### 2. 引用文档章节 +- 列出所有引用的标准、规范或文档 +- 注明非正常渠道来源（如口头约定、邮件确认等） + +### 3. 测试准备章节 +- **硬件准备**：明确所需硬件设备、连接方式、图示及就绪操作说明 +- **软件准备**：描述被测项（Item Under Test）及相关支撑软件的安装与配置规程 +- **其他准备**：说明测试人员需完成的前置活动（如权限申请、环境初始化等） + +### 4. 测试说明章节（按测试唯一标识符分条） +对每个测试用例，依次包含： +- a) 测试用例标识符与测试目的 +- b) 所覆盖的软件需求编号或描述 +- c) 先决条件（包括软硬件配置、系统初始状态等） +- d) 测试输入（名称、用途、来源、时间序列、控制方式） +- e) 预期测试结果（明确、可验证） +- f) 结果评价准则（通过/失败的判定标准） +- g) 测试规程（独立编号的详细操作步骤序列，确保可重复执行） +- h) 假设与约束（如依赖外部服务、时间窗口限制等） + +### 5. 需求可追踪性章节 +- 建立测试用例与系统/CSCI需求之间的双向追踪矩阵 +- 确保每个需求至少有一个对应测试用例，每个测试用例至少覆盖一个需求 + +### 6. 注释章节 +- 提供背景信息、术语定义、缩略语表或必要公式 + +> **关键要求**：测试规程必须是独立编号的步骤序列，详细程度应足以支持预期结果的判定，并能与实际执行结果进行客观比较。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/software-user-manual-creation/SKILL.md b/GJB438C-2021_prd_skills/software-user-manual-creation/SKILL.md new file mode 100644 index 0000000..f13dd92 --- /dev/null +++ b/GJB438C-2021_prd_skills/software-user-manual-creation/SKILL.md @@ -0,0 +1,51 @@ +--- +name: software-user-manual-creation +description: 判断是否需要为用户可操作软件或带用户接口的CSCI编制独立的软件用户手册（SUM），并在需要时按规范生成完整SUM内容。当软件由用户直接运行且具有联机输入/输出接口时使用本技能；若为嵌入式软件且其内容已包含在系统手册中，则无需单独编制。 +--- + +# 软件用户手册（SUM）编制规范 + +## 何时使用 +- 软件由最终用户直接运行 +- 软件具备用户接口，用于获取联机输入或解释输出显示 +- 需确认是否应编制独立SUM，或内容已合并至系统级手册 + +## 执行步骤 + +### 1. 判断编制条件 +**必须编制SUM的情况：** +- 软件由用户直接运行 +- 具有用户接口用于联机输入或输出解释 + +**无需单独编制SUM的情况：** +- 软件为硬件-软件系统中的嵌入式软件 +- 系统的用户手册或操作手册已完整包含SUM所需全部内容 + +### 2. 编制SUM核心内容 +确保SUM包含以下三部分： + +#### a) 软件概述 +- 软件用途 +- 必需安装的软件文件清单 +- 软件运行环境（硬件、操作系统、依赖项等） +- 软件组织结构与操作概览 +- 意外事故处理及备用状态/方式 +- 保密性要求 +- 帮助获取途径与问题报告机制 + +#### b) 软件入门 +- 普通用户所需的基本信息（如账号、权限、初始设置） +- 启动、停止、挂起的标准规程 + +#### c) 使用指南 +- 功能能力说明与用户约定 +- 标准处理规程（含典型操作流程） +- 数据备份与恢复方法 +- 系统消息含义解释 +- 错误、故障及紧急情况的恢复措施 + +### 3. 输出结果 +- 若需编制：生成符合附录Q格式要求的完整SUM文档 +- 若无需编制：输出声明，确认相关内容已合并至系统手册 + +> 注意：正文格式须严格遵循标准附录Q（资料性附录）要求。 \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/test-input-design-specification/SKILL.md b/GJB438C-2021_prd_skills/test-input-design-specification/SKILL.md new file mode 100644 index 0000000..39b4126 --- /dev/null +++ b/GJB438C-2021_prd_skills/test-input-design-specification/SKILL.md @@ -0,0 +1,43 @@ +--- +name: 测试输入设计规范 +description: 本技能用于在设计测试用例输入时，系统化地定义和组织测试输入内容，确保覆盖功能、边界、异常及压力场景。当需要为软件验证活动创建结构化的测试输入方案（包括测试数据来源、真实性、取值范围及控制策略）时使用此技能。 +--- + +# 测试输入设计规范 + +## 何时使用 +- 正在设计测试用例的输入部分 +- 需要为被测软件项准备验证测试数据 +- 要求确保测试覆盖正常、边界、异常和压力场景 +- 需支持回归测试以验证缺陷修复未引入新问题 + +> **注意**：不适用于无法控制输入的监控类软件。 + +## 执行步骤 + +1. **定义每个测试输入的基本信息** + - 提供名称、用途和详细说明 + - 明确取值范围与精度要求 + +2. **说明测试输入的来源与选择方法** + - 描述数据如何获取或生成 + - 解释选择该数据的理由 + +3. **标明数据真实性** + - 明确指出测试输入是真实数据还是模拟数据 + +4. **指定时间或事件序列（如适用）** + - 若测试依赖时序或事件触发，需明确定义顺序 + +5. **设计输入控制策略，覆盖以下四类场景** + - **正常情况覆盖**：使用最小且合理的有效数据类型和值，验证基本功能 + - **边界与压力测试**：使用各类有效数据（包括极限值）检验系统在过载、饱和等“最坏情况”下的表现 + - **异常与错误处理测试**：使用无效数据类型或非法值，验证系统对非常规输入的容错与处理能力 + - **支持回归测试**：确保输入设计可重复执行，便于后续验证修复效果 + +6. **输出完整的测试输入设计方案** + - 方案应体现对被测项功能、性能及异常处理能力的全面覆盖 + +## 关键变量 +- **输入类型**：正常 / 边界 / 异常 / 压力 +- **数据真实性**：真实数据（true）或模拟数据（false） \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/接口标识与接口图设计/SKILL.md b/GJB438C-2021_prd_skills/接口标识与接口图设计/SKILL.md new file mode 100644 index 0000000..e8e3087 --- /dev/null +++ b/GJB438C-2021_prd_skills/接口标识与接口图设计/SKILL.md @@ -0,0 +1,34 @@ +--- +name: 接口标识与接口图设计 +description: 为包含多个接口的系统或软件配置项分配唯一标识符并绘制接口图，以清晰表达接口实体及其关系。当文档中存在两个或以上接口、需进行正式接口设计或系统集成时使用本技能。 +--- + +# 接口标识与接口图设计 + +## 何时使用 +- 文档中包含多个接口 +- 需要区分不同接口实体（如系统、配置项、用户、外部系统） +- 正在编写接口设计文档或进行系统集成工作 +- 接口涉及固定特性或正在开发/修改的实体 + +> **不适用于**：单一简单接口且无需正式文档的情况。 + +## 执行步骤 +1. **分配唯一标识符**：为每个已识别的接口分配项目内唯一的标识符（字符串格式）。 +2. **标识接口实体**：对每个接口关联的实体（系统、配置项、用户等），明确提供以下信息： + - 名称 + - 编号 + - 版本 + - 相关文档引用 +3. **说明实体状态**：在标识中明确指出： + - 哪些实体具有固定的接口特性（并列出其接口需求） + - 哪些实体正在被开发或修改（这些实体应已有独立的接口需求） +4. **绘制接口图**：适当时，使用一个或多个接口图描述接口结构。 +5. **确保图示清晰**：接口图必须清晰展示接口实体之间的关系和数据流向。 + +## 输出结果 +每个接口均具备： +- 项目唯一的标识符 +- 清晰的实体信息（名称、编号、版本、文档引用） +- 状态说明（固定特性或开发中） +- 对应的接口图（如适用） \ No newline at end of file diff --git a/GJB438C-2021_prd_skills/软件测量与分析实施/SKILL.md b/GJB438C-2021_prd_skills/软件测量与分析实施/SKILL.md new file mode 100644 index 0000000..0464e4d --- /dev/null +++ b/GJB438C-2021_prd_skills/软件测量与分析实施/SKILL.md @@ -0,0 +1,34 @@ +--- +name: 软件测量与分析实施 +description: 该技能用于在需要量化评估软件过程或产品质量时，系统化地定义测量目标、选择测度、收集数据、分析结果并生成报告，以支持项目决策和过程改进。当项目已定义测量目标且具备数据收集机制，并需依据客观数据进行进度、质量、生产率或风险评估时使用本技能。 +--- + +# 软件测量与分析实施 + +## 何时使用 +- 需要量化评估软件过程（如开发效率、过程稳定性）或软件产品（如缺陷水平、功能完整性） +- 已明确测量目标（例如监控进度偏差、评估质量趋势） +- 数据收集机制已建立，且测量活动不会对项目造成过度负担 + +## 如何执行 +1. **定义测量目标**：明确评估目的，例如： + - 进度跟踪（如里程碑达成情况） + - 质量评估（如缺陷密度、测试覆盖率） + - 生产率分析（如人均产出） + - 风险识别（如需求变更频率） + +2. **选择测度**：根据目标选取合适指标，例如： + - 规模类：代码行数、功能点 + - 质量类：缺陷密度、测试通过率 + - 进度类：计划偏差率、任务完成率 + - 资源类：人时消耗、成本偏差 + +3. **建立数据收集规程**：规定数据来源、责任人、采集频率和格式，确保数据准确、一致、可追溯。 + +4. **分析数据**：运用趋势图、对比分析、统计方法等解释数据，识别异常、模式或改进机会。 + +5. **报告结果**：编制分析报告，清晰呈现发现、结论及建议，用于决策支持、状态通报或过程改进。 + +6. **反馈闭环**：将分析结果应用于调整计划、优化流程、修正估算或更新测量目标，形成持续改进循环。 + +> 注意：测量活动应与项目规模匹配，避免引入不必要的管理开销。 \ No newline at end of file diff --git a/configs/api_config.yaml b/configs/api_config.yaml new file mode 100644 index 0000000..41ebc2d --- /dev/null +++ b/configs/api_config.yaml @@ -0,0 +1,15 @@ +default_provider: intranet +providers: + deepseek: + api_key: sk-10faa00207db4135ae78e217594273fe + base_url: https://api.deepseek.com/v1/chat/completions + max_tokens: 4000 + model: deepseek-chat + temperature: 0.7 + intranet: + api_key: EMPTY + base_url: http://10.30.10.1:8000/v1 + max_tokens: 8192 + model: qwen3-coder + temperature: 0.7 + diff --git a/configs/api_config.yaml.bak b/configs/api_config.yaml.bak new file mode 100644 index 0000000..e127aa3 --- /dev/null +++ b/configs/api_config.yaml.bak @@ -0,0 +1,34 @@ +default_provider: intranet +providers: + deepseek: + api_key: sk-10faa00207db4135ae78e217594273fe + base_url: https://api.deepseek.com/v1/chat/completions + max_tokens: 4000 + model: deepseek-chat + temperature: 0.7 + intranet: + api_key: EMPTY + base_url: http://10.30.10.1:8000/v1 + max_tokens: 8192 + model: qwen3-coder + temperature: 0.7 + openai: + api_key: '' + base_url: https://api.openai.com/v1/chat/completions + max_tokens: 4000 + model: gpt-3.5-turbo + temperature: 0.7 + openrouter: + api_key: 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 + base_url: https://openrouter.ai/api/v1/chat/completions + http_referer: '' + max_tokens: 4000 + model: z-ai/glm-4.5-air:free + temperature: 0.7 + x_title: '' + qianwen: + api_key: sk-77065ee39e6644b3b8cc1fcc80a8d802 + base_url: https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions + max_tokens: 8192 + model: qwen3-max-2026-01-23 + temperature: 0.1