当前位置： 首页 > article >正文

.NET源码生成器基于partial范式开发和nuget打包欧

article 2026/4/12 4:33:59
1 安装与初始化# 全局安装 OpenSpecnpm install -g fission-ai/openspeclatest# 在项目目录下初始化cd /path/to/your-projectopenspec init初始化时OpenSpec 会提示你选择使用的 AI 工具Claude Code、Cursor、Trae、Qoder 等。3 OpenSpec 如何教AI 工作OpenSpec 的核心机制是通过一套规范注入系统让 AI 在每次对话前先学习项目规范。3.1 不同 AI 工具的初始化差异根据你使用的 AI 工具不同OpenSpec 会生成不同的目录结构。这背后的设计理念是最大限度地适配各工具的特性。3.2 ?? 场景 1Claude CodeClaude Code 在执行了 OpenSpec Init 后的目录结构如下.claude/├── commands/│ └── openspec/│ ├── apply.md│ ├── archive.md│ └── proposal.md├── AGENTS.md└── CLAUDE.mdcommands/openspec 这个目录定义了三个不同的命令每个命令文件中所写的提示词都是 AI 在执行该命令时需要参考的规范。上述三个命令分别是apply.md表示执行已批准的变更archive.md归档已完成的变更proposal.md发起新变更提案当我们需要发起新的提案时可以直接使用/openspec:proposal 就可以触发该指令此时 AI 就会根据 proposal.md 中所定义的规范来创建一个新的变更提案。核心文件解读AGENTS.md这个文件是 Claude Code 每次对话时的第一课内容如下# OpenSpec 说明这些指令是针对参与本项目的人工智能助手。当请求中包含以下内容时请务必打开 /openspec/AGENTS.md- 提及规划或提案如提案、规范、变更、计划等字眼- 引入新功能、重大变更、架构调整或重大的性能/安全工作- 听起来含糊不清且在编码前需要权威规范使用 /openspec/AGENTS.md 来学习- 如何创建和应用变更提案- 规范格式和约定- 项目结构和指南保留此托管块以便openspec update可以刷新指令。工作原理Claude Code 启动时自动读取 AGENTS.md判断用户请求是否触提案/变更等关键词如果触发自动加载 openspec/AGENTS.md 中的详细规范AI 按照规范执行任务3.3 ?? 场景 2Trae字节跳动OpenSpec 在初始化时可选择的AI 工具中是不支持 Trae 的但是很多朋友是基于 Trae 在开发。所以对于使用 Trae 的朋友我们在执行 OpenSpec Init 的时候可以选择最后一个选项 Other Tools (适用于 VsCode 等此时初始化后的目录结构如下项目根目录/├── AGENT.md # 项目级规范需手动配置└── openspec/├── AGENTS.md # OpenSpec 详细规范├── project.md # 项目知识库├── specs/ # 已实现能力规范└── changes/ # 变更提案关键差异需要手动配置与 Claude Code 不同老版本的 Trae 不会自动读取 AGENT.md。此时你需要手动将规范内容添加到 Trae 的项目规则中。但是对于Trae 2026 年 1 月份最新的一次版本变更中也已经兼容了读取 AGENT.md 文件作为项目规则来使用。所以使用老版本 Trae 的朋友需要基于下述步骤进行配置打开 Trae 的项目设置找到项目规则配置将 AGENT.md 的内容粘贴进去保存后Trae 每次对话都会加载该规则配置完成后Trae 的工作流程与 Claude Code 类似每次对话自动加载项目规则判断是否触发 OpenSpec 规范根据规范执行对应任务3 OpenSpec 规范核心要点无论使用哪种 AI 工具OpenSpec 的核心工作流都是一致的。理解这套规范你就能更好地与 AI 协作。三阶段工作流阶段1创建变更Proposal↓阶段2实现变更Apply↓阶段3归档变更Archive何时必须创建提案场景 是否需要提案新增功能或能力 ? 必须破坏性变更API/Schema ? 必须架构或模式调整 ? 必须Bug 修复恢复既有行为 ? 跳过拼写、格式、注释修正 ? 跳过非破坏性依赖升级 ? 跳过常用命令openspec list # 列出所有变更openspec list --specs # 列出所有规范openspec validate # 校验变更openspec archive # 归档变更?? 小贴士作为人类开发者你无需记忆这些命令。AI 会自动执行相应的操作来检查和管理变更提案。你只需要理解这套规范的工作流程就能与 AI 配合无间。openspec/project.md 的作用这个文件是项目的知识库用于存放项目目标和背景核心业务术语技术栈说明详细文档索引4 常见问题解答4.1 Q1为什么有时候 AI 不触发 OpenSpec 规范A这通常是因为触发条件未被满足。OpenSpec 的触发机制基于关键词匹配如提案、变更、规范等。如果你的请求不包含这些关键词AI 则不会加载 OpenSpec 规范。解决方案明确使用触发词帮我创建一个变更提案直接指定文件先阅读 openspec/project.md 再回答使用斜杠命令/openspec:proposal如果工具支持5.2 Q2project.md 中的业务知识什么时候生效A只有触发 OpenSpec 规范后才会读取。这是一个重要的设计权衡知识类型 存放位置 触发条件通用开发规范 /AGENTS.md 每次对话自动加载OpenSpec 工作流 openspec/AGENTS.md 触发关键词后加载业务上下文 openspec/project.md 通过规范索引间接加载实践建议将通用规则如项目结构、编码风格放在 /AGENTS.md 中将业务知识索引也写在 /AGENTS.md 中便于日常对话触发或者在对话中明确要求 AI 先阅读特定文档5.3 Q3如何让 AI 自动检索相关背景知识A这是 OpenSpec 的进化方向。目前最佳实践是在 /AGENTS.md 中建立业务知识索引采用提案方式讨论业务逻辑自动触发规范对话中明确指定先阅读 docs/xxx.md 再回答6 五、总结OpenSpec 的核心价值回到开篇的问题为什么有时候让 AI 发起提案时灵时不灵答案现在很清楚了触发机制AI 需要识别到特定关键词才会加载 OpenSpec 规范工具差异不同 AI 工具对规范文件的支持程度不同知识分层业务知识与开发规范需要合理分层存放OpenSpec 的核心价值在于通过规范注入让 AI 从项目小白成长为熟悉业务的开发伙伴。它不是银弹但当你理解了它的工作原理后就能让 AI 在团队协作中发挥真正的作用。当然在有需要的时候我们也可以修改 OpenSpec 初始化时所生成的一系列.md文件直接变更规范使其更加符合企业内的业务流程。绿咐赶椅

相关文章：

.NET源码生成器基于partial范式开发和nuget打包欧

1 安装与初始化 # 全局安装 OpenSpec npm install -g fission-ai/openspeclatest # 在项目目录下初始化 cd /path/to/your-project openspec init 初始化时，OpenSpec 会提示你选择使用的 AI 工具（Claude Code、Cursor、Trae、Qoder 等）。 3 O…...

编程日记 2026/4/12 4:33:59

从标准到实践：基于IPC-9702与IPC-9704A的PCB应力应变测试全流程解析

1. PCB应力应变测试的核心价值与标准体系 当你拆开手机或笔记本电脑时，那块布满元器件的绿色板子就是PCB（印刷电路板）。它就像电子设备的"骨架"和"神经系统"，但你可能不知道，这块板子在制造过程中…...

编程日记 2026/4/12 4:33:59

Windows环境下编译运行C语言程序的方法及工具选择

C语言入门学习存在一定难以程度，需要勤奋加以练习。大多数人运用Windows系统，这时在Windows这种处于其环境状况下怎样对C语言程序进行编译以及运行呢？掌握恰当合适的工具以及方法是其中的关键要点所在。1、 1. 我在学习C语言之际，…...

编程日记 2026/4/12 4:33:59

SerialHTML：ESP8266纯Web串口监视器实现

1. SerialHTML：面向嵌入式远程调试的Web端串口监视器实现解析SerialHTML 是一个专为 ESP8266 微控制器设计的轻量级、纯 Web 端串口监视器（Web-based Serial Monitor）类库。它不依赖任何桌面客户端软件，仅通过标准浏览器即可完成串…...

编程日记 2026/4/12 4:33:59

用C++的string类手搓一个大整数加法器（附完整可运行代码）

用C的string类手搓一个大整数加法器（附完整可运行代码） 在C编程中，处理超大整数一直是个有趣且实用的挑战。标准库中的整数类型如int或long long都有其数值范围限制，当我们需要处理像银行账户余额、加密算法中的大数或者科学计算中…...

编程日记 2026/4/12 4:31:59

新手也能懂的红队实战：从零搭建红日靶场到内网渗透完整复盘（附环境包）

红队实战入门：从零构建红日靶场到内网渗透全流程解析 环境准备与靶场搭建 红日靶场作为国内知名的渗透测试学习环境，其设计模拟了真实企业内网架构，包含Web服务器、域控服务器和域成员主机。对于初学者而言，正确搭建环境是后续所有…...

编程日记 2026/4/12 4:31:59

React 19实战：如何用最新特性打造Nano Banana无限画布（附完整代码）

React 19实战：如何用最新特性打造Nano Banana无限画布 在当今前端开发领域，React 19的发布无疑为开发者们带来了全新的可能性。本文将深入探讨如何利用React 19的最新特性构建一个名为"Nano Banana"的高性能无限画布应用。不同于传统的画布实现…...

编程日记 2026/4/12 4:31:59

HagiCode 为什么选择 Hermes 作为综合 Agent 核心菊

1. 哑铃图是什么？ 哑铃图（Dumbbell Plot），有时也称为DNA图或杠铃图，是一种用于比较两个相关数据点的可视化图表。 它源于人们对更有效数据比较方式的持续探索。 在传统的时间序列比较中，我们通常使用两条折…...

编程日记 2026/4/12 4:31:59

AI 大模型职业选择衣

一、Actor 模型：不是并发技巧，而是领域单元 Actor 模型的本质是： Actor 是独立运行的实体 Actor 之间只通过消息交互 Actor 内部状态不可被外部直接访问 Actor 自行决定如何处理收到的消息 Actor 模型真正解决的是： 如何在不共享状…...

编程日记 2026/4/12 4:31:59

【deepin】通过x11vnc与xrdp实现Windows无缝远程控制deepin桌面

1. 为什么需要远程控制deepin桌面？ 作为一个长期使用deepin系统的开发者，我经常遇到需要在Windows电脑上远程操作deepin桌面的场景。比如在家办公时想用Windows笔记本访问公司的deepin开发机，或者给使用deepin的朋友远程解决问题。传统的Tea…...

编程日记 2026/4/12 4:29:59

Python：深入理解set_seed——确保机器学习实验的可重复性

1. 为什么我们需要set_seed？ 做机器学习实验时，最让人头疼的就是结果不可复现。昨天跑出来的准确率是92%，今天同样的代码跑出来变成了89%。这种"薛定谔的准确率"让很多开发者抓狂。我在实际项目中就遇到过这种情况：在调…...

编程日记 2026/4/12 4:29:59

芯片测试工程师必看：Mentor DFT OCC时钟控制器实战配置与三大设计模式详解

芯片测试工程师必看：Mentor DFT OCC时钟控制器实战配置与三大设计模式详解 在芯片测试领域，时钟控制器的设计与配置一直是工程师面临的核心挑战之一。作为DFT（Design for Testability）工程师，我们每天都需要与各种时钟…...

编程日记 2026/4/12 4:29:59

电解电容寿命预测：从理论公式到工程实践

1. 电解电容寿命预测的基本原理 电解电容作为电子设备中的关键元件，其寿命直接影响整机可靠性。我曾参与过多个电源项目，亲眼见过因为电容失效导致的设备故障。要理解寿命预测，首先要明白电解电容的老化机制——电解液会随着时间和温度逐渐蒸…...

编程日记 2026/4/12 4:29:59

ARM 架构 JuiceFS 性能优化：基于 MLPerf 的实践与调优汲

Qt是一个跨平台C图形界面开发库，利用Qt可以快速开发跨平台窗体应用程序，在Qt中我们可以通过拖拽的方式将不同组件放到指定的位置，实现图形化开发极大的方便了开发效率，本笔记将重点介绍QSpinBox数值微调组件的常用方法及灵活应用。…...

编程日记 2026/4/12 4:29:58

算法——暴力+优化

本质这类型题本质就是基于暴力解法，优化其时间复杂度例题首先容易想到的就是组合型动态规划，可是由于在求以i位置为结尾的最长递增子序列的时候要遍历以[0-i-1]位置为结尾最长递增子序列的长度，所以时间复杂度会达到n^2。要求以i为结尾的最长…...

编程日记 2026/4/12 4:27:58

QWEN-AUDIO内容创作提效：营销文案→自然语音→一键导出WAV全流程

QWEN-AUDIO内容创作提效：营销文案→自然语音→一键导出WAV全流程 1. 引言：语音创作的新时代 你有没有遇到过这样的情况：写好了精彩的营销文案，却苦于找不到合适的配音？或者需要为视频内容添加语音，但自己…...

编程日记 2026/4/12 4:27:58

intv_ai_mk11 GPU算力适配案例：A10显存16GB下7B模型量化部署实操

intv_ai_mk11 GPU算力适配案例：A10显存16GB下7B模型量化部署实操 1. 项目背景与挑战 在AI模型部署实践中，如何在有限GPU资源上高效运行大语言模型一直是工程难题。本文将分享在NVIDIA A10G显卡（16GB显存）上部署intv_ai_mk11&…...

编程日记 2026/4/12 4:27:58

Appium启动参数避坑指南：新手常犯的5个错误及解决方案

Appium启动参数避坑指南：新手常犯的5个错误及解决方案 在移动应用UI自动化测试领域，Appium作为一款开源的跨平台测试框架，凭借其强大的兼容性和灵活性赢得了众多测试工程师的青睐。然而，对于刚接触Appium的新手来说，启…...

编程日记 2026/4/12 4:27:57

RadioHead嵌入式无线协议栈原理与STM32实战

1. RadioHead库概述：面向嵌入式系统的面向对象无线数据链路协议栈RadioHead 是一个专为资源受限嵌入式微处理器设计的、高度可移植的面向对象无线数据链路协议栈。它并非简单的射频驱动封装，而是一套完整的、分层抽象的通信框架，覆盖从物理层…...

编程日记 2026/4/12 4:27:57

从错误码到精准定位：307系列基站定位实战排障指南

1. 当你的设备突然"失联"：307系列基站定位排障入门 第一次用ML307A模组调试基站定位功能时，我盯着串口助手连续跳出的126错误码整整半小时。就像在玩解谜游戏，设备明明显示网络信号满格，AT指令也返回了OK，但…...

编程日记 2026/4/12 4:25:57

【自动驾驶】从几何到代码：车辆运动学模型的推导与Python实践

1. 车辆运动学模型基础概念 第一次接触自动驾驶车辆建模时，我被各种坐标系和参数搞得晕头转向。直到把车辆想象成小时候玩的遥控车，才突然开窍——原来我们只需要知道车子位置、朝向和速度，就能预测它下一秒会跑到哪里。这就是车辆运动学模型…...

编程日记 2026/4/12 4:25:57

HMC5883L磁力计驱动开发与磁场校准实战

1. HMC5883L数字罗盘传感器技术解析与嵌入式驱动开发实践1.1 器件定位与工程价值HMC5883L是由Honeywell公司推出的三轴磁阻式数字罗盘传感器，属于高精度、低功耗、IC接口的MEMS磁力计芯片。在嵌入式系统中，它并非仅用于“指南针”这一表层功能&#xff0…...

编程日记 2026/4/12 4:25:57

Rust的匹配中的质量辅助

Rust的匹配机制以其强大的类型安全和表达能力著称，而其中的质量辅助功能更是为开发者提供了高效且可靠的编程体验。质量辅助不仅帮助开发者在编写匹配语句时减少错误，还能通过编译器的智能提示和检查，提升代码的可读性和健壮性。无论是处理枚…...

编程日记 2026/4/12 4:25:57

存储那么贵，何不白嫖飞书云文件空间还

基础示例：单工作表 Excel 转 TXT 以下是将一个 Excel 文件中的第一个工作表转换为 TXT 的完整步骤： 1. 加载并读取Excel文件 from spire.xls import * from spire.xls.common import * workbook Workbook() workbook.LoadFromFile("示例.xlsx"…...

编程日记 2026/4/12 4:25:57

如何用PDF Arranger轻松管理PDF文档：终极免费工具指南

如何用PDF Arranger轻松管理PDF文档：终极免费工具指南 【免费下载链接】pdfarranger Small python-gtk application, which helps the user to merge or split PDF documents and rotate, crop and rearrange their pages using an interactive and intuitive graph…...

编程日记 2026/4/12 4:23:57

逐行拆解 STM32F4-CAN-IAP：一份“代码即文档”的功能级说明书

STM32F4的CAN升级方案 bootloader源代码，对应测试用app源代码，都是keil工程，代码有备注，也有使用说明。 带对应上位机可执行文件。 上位机vs2013开发(默认exe，源代码需要额外拿)（适用于：拿到源码…...

编程日记 2026/4/12 4:23:55

Omron NX程序自动化电池焊接检测机：人机配方一键换型，智能故障记录与统计，EtherCA...

omron欧姆龙NX程序NX1P2-1040DT，搭载思勤EtherCAT远程输入输出IO模块 全自动电池焊接检测机 涵盖人机配方一键换型功能，故障记录功能，产量统计及OEE功能，TCP，视觉通信控制，EIP远程IO通信，松下A6…...

编程日记 2026/4/12 4:23:55

三菱FX3U PLC与变频器Modbus RTU通讯控制案例：实现启停、频率设定与读取功能...

三菱FX3U与三菱变频器 modbus RTU通讯案例 器件：三菱FX3U PLCFX3U 485BD，三菱E740变频器，昆仑通态触摸屏，威纶通 功能：采用485方式，modbus RTU协议。 与变频器通讯，控制启停，频率&am…...

编程日记 2026/4/12 4:23:55

Java的java.lang.runtime.ObjectMethods记录类方法自动生成的底层机制

Java记录类方法自动生成的底层机制探秘 在Java 14中引入的记录类（Record）简化了不可变数据载体的定义，而其背后的java.lang.runtime.ObjectMethods类则是实现自动生成equals()、hashCode()和toString()等核心方法的关键。这一机制通过编译时…...

编程日记 2026/4/12 4:23:50

ESP8266驱动1.44英寸ST7735 TFT屏的实战指南与图像显示优化

1. ESP8266与ST7735屏的硬件连接实战 第一次用ESP8266驱动1.44寸ST7735屏时，最让我头疼的就是引脚接线问题。不同厂商的屏幕引脚定义可能略有差异，但核心信号线基本一致。我手头这块屏采用8针SPI接口，实际测试发现用NodeMCU开发板连接最方便。…...

编程日记 2026/4/12 4:21:49