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

粉紫系超人气月兔铃仙啪

article 2026/4/13 1:37:20
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文件直接变更规范使其更加符合企业内的业务流程。锥荚旨寿

相关文章：

粉紫系超人气月兔铃仙啪

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/13 1:37:20

大模型SLA必须包含的4类动态条款（负载突增弹性系数、多租户隔离保障、模型版本回滚SLA继承规则、安全合规中断豁免机制）

第一章：大模型工程化服务等级协议SLA设计 2026奇点智能技术大会(https://ml-summit.org) 大模型工程化落地的核心挑战之一，在于将非确定性推理能力封装为可度量、可保障、可运维的生产级服务。SLA设计不再是传统API响应延迟与可用性的简单延伸&#xff…...

编程日记 2026/4/13 1:37:20

[Refactor]CPP Learn Data Day 咏

一、什么是urllib3？ urllib3 是一个用于处理 HTTP 请求和连接池的强大、用户友好的 Python 库。 它可以帮助你： 发送各种 HTTP 请求（GET, POST, PUT, DELETE等）。 管理连接池，提高网络请求效率。 处理重试和重定向。 支…...

编程日记 2026/4/13 1:37:20

.NET 磁盘BitLocker加密-技术选型忠

在之前的文章中，我们花了大量的篇幅，从记录后端pod真实ip开始说起，然后引入envoy，再解决了各种各样的需求：配置自动重载、流量劫持、sidecar自动注入，到envoy的各种能力：熔断、流控、分流、透明…...

编程日记 2026/4/13 1:37:20

从掩码配置到数据拼接：手把手教你用C2000 DSP的CAN实现IAP固件升级

从掩码配置到数据拼接：手把手教你用C2000 DSP的CAN实现IAP固件升级 在工业控制和汽车电子领域，固件升级的可靠性直接关系到设备长期运行的稳定性。传统方式需要拆机烧录，而基于CAN总线的IAP(In Application Programming)技术让远程更新成为可…...

编程日记 2026/4/13 1:37:19

学习数据结构的心得

大一计科｜数据结构学习心得：从背概念懵圈到能自己写栈实现大家好，我是大一计科的学生，这学期刚接触数据结构这门课。最开始我天真地以为，这就是一门“背定义”的课——把栈、队列、链表的概念背熟，就能应付…...

编程日记 2026/4/13 1:35:19

Superpowers - 07 从 SessionStart Hook 看 Superpowers：把「技能库」变成「行为操作系统」

文章目录Pre一、为什么 SessionStart Hook 如此重要？1. 被动工具箱 vs 主动行为系统2. 三阶段注入管线：从平台事件到系统提示二、钩子注册与触发：Claude、Cursor 与 Copilot 各有各的规矩1. hooks.json：服务 Claude Code 与 Copil…...

编程日记 2026/4/13 1:35:18

彻底吃透哨兵值：从底层逻辑到自定义设计（附原创值域理论）

彻底吃透哨兵值：从底层逻辑到自定义设计（附原创值域理论） 在编程中，哨兵值（Sentinel Value）是一个高频出现但容易被误解的概念。很多人只会死记硬背“哨兵值是用来终止循环的特殊值”，却不懂其底…...

编程日记 2026/4/13 1:35:18

Marimo 远程命令执行漏洞复现（CVE-2026-39987）

免责申明： 本文所描述的漏洞及其复现步骤仅供网络安全研究与教育目的使用。任何人不得将本文提供的信息用于非法目的或未经授权的系统测试。作者不对任何由于使用本文信息而导致的直接或间接损害承担责任。如涉及侵权，请及时与我们联系，我们将尽快处理并删除相关内容。 前…...

编程日记 2026/4/13 1:35:18

笑晕！我和朋友调试出一行“鬼畜C++代码”，4个nullptr叠满还能完美运行

文章目录 名场面开端：朋友扔来一行“看不懂但大受震撼”的代码调试之路：从“报错连连”到“逐渐正常”，每一步都在笑第一步：修正语法错误，括号和模板别乱套第二步：类型统一，解决“输出不对”的问…...

编程日记 2026/4/13 1:35:17

SpringBoot 环境配置解析：Environment 与 PropertySource

前面我们系统讲解了 Value、ConfigurationProperties 的配置注入用法，很多同学能熟练用它们读取配置，但一旦遇到复杂场景就彻底懵圈：比如：为什么命令行参数能覆盖 application.yml 的配置？为什么 Nacos 配置能实时更新…...

编程日记 2026/4/13 1:33:16

.NET 新特性概览与相关文章索引檀

从 UI 工程师到 AI 应用架构者 13 年前，我的工作是让按钮在 IE6 上对齐； 13 年后，我用 fetch-event-source 订阅大模型的“思维流”，用 OCR 解锁图片中的文字——前端，正在成为 AI 产品的第一道体验防线。 最近&#x…...

编程日记 2026/4/13 1:33:16

前端八股Vue（6）---v-if和v-for

目录 一、v-for 详解1.1 作用1.2 语法1.3 要点二、v-if 详解2.1 作用2.2 语法2.3 v-if vs v-show三、高频面试坑点：v-for 和 v-if 不能用在同一个标签上3.1 错误示例3.2 原因3.3 正确写法四、v-for 里面的 key 作用4.1 一句话核心答案4.2 详细解释4.3 图解&#xf…...

编程日记 2026/4/13 1:33:16

语言的边界，与软件的命运厍

1. 引入 在现代 AI 工程中，Hugging Face 的 tokenizers 库已成为分词器的事实标准。不过 Hugging Face 的 tokenizers 是用 Rust 来实现的，官方只提供了 python 和 node 的绑定实现。要实现与 Hugging Face tokenizers 相同的行为，最好的办法…...

编程日记 2026/4/13 1:33:15

如何将微信聊天记录变为个人数字资产：WeChatMsg完全指南

如何将微信聊天记录变为个人数字资产：WeChatMsg完全指南 【免费下载链接】WeChatMsg 提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告 项目地址: https://gitcode.com/GitHub_Trending/we/WeC…...

编程日记 2026/4/13 1:33:11

如何给帧数浮动太大的低帧视频插帧？

提示：本视频仅适用于与本文发布时间接近时间发布的剪映电脑版本 你是否遇到过自己的视频帧数浮动太大，看着像PPT？ 这一招完美教你的视频不再卡顿！ 首先下载这俩软件：剪映和flowframes（下载地址&#xff…...

编程日记 2026/4/13 1:31:11

MD_OnePin：单GPIO引脚实现嵌入式主从通信协议

1. 项目概述MD_OnePin 是一个面向资源受限嵌入式系统的轻量级单线串行通信协议库，其核心设计目标是：仅使用一个通用数字 I/O 引脚（外加共地）即可实现主从式点对点双向数据传输。该库完全基于软件模拟（bit-banging&…...

编程日记 2026/4/13 1:31:11

记录复现多模态大模型论文OPERA的一周工作泄

一、简化查询 1. 先看一下查询的例子 /// /// 账户获取服务 /// /// /// public class AccountGetService(AccountTable table, IShadowBuilder builder) {private readonly SqlSource _source new(builder.DataSource);private readonly IParamQuery _accountQuery build…...

编程日记 2026/4/13 1:31:11

SWTP_CodecLib：轻量级NRF24L01无线协议编解码库

1. SWTP_CodecLib 项目概述SWTP_CodecLib 是一个面向 NRF24L01 射频收发芯片的轻量级通信协议编解码库，其核心目标并非驱动硬件本身，而是为基于 NRF24L01 构建的自定义无线通信系统提供一套结构化、可复用的数据封包与解析机制。该库不依赖特定 MCU 平台…...

编程日记 2026/4/13 1:31:11

保姆级 uPyPi 教程｜从 到 ：MicroPython 驱动包一键安装 + 分享全攻略诮

这个代码的核心功能是：基于输入词的长度动态选择反义词示例，并调用大模型生成反义词，体现了 “动态少样本提示（Dynamic Few-Shot Prompting）” 与 “上下文长度感知的示例选择” 的能力。 from langchain.prompts impo…...

编程日记 2026/4/13 1:31:11

MySQL锁机制：从全局锁到行级锁的深度解读秤

如果有多个供应商，你也可以使用 [[CC-Switch]] 来可视化管理这些API key，以及claude code 的skills。 # 多平台安装指令 curl -fsSL https://claude.ai/install.sh | bash ## Claude Code 配置 GLM Coding Plan curl -O "https://cdn.bigmodel.cn/i…...

编程日记 2026/4/13 1:29:11

CustomStepper：28BYJ-48裸机步进控制库深度解析

1. CustomStepper 库深度解析：面向嵌入式工程师的 28BYJ-48 精密步进控制实践指南1.1 库定位与工程价值CustomStepper 是一个专为资源受限嵌入式平台设计的轻量级裸机（bare-metal）步进电机控制库，核心目标是为 28BYJ-48 型五相四线…...

编程日记 2026/4/13 1:29:11

详细解析Spring如何解决循环依赖问题蔚

AI训练存储选型的演进路线 第一阶段：单机直连时代 早期的深度学习数据集较小，模型训练通常在单台服务器或单张GPU卡上完成。此时直接将数据存储在训练机器的本地NVMe SSD/HDD上。 其优势在于IO延迟最低，吞吐量极高，也就是“数据离…...

编程日记 2026/4/13 1:29:11

python 文件管理库 Path 解析（详细基础）狼

. GIF文件结构 相比于 WAV 文件的简单粗暴，GIF 的结构要精密得多，因为它天生是为了网络传输而设计的（包含了压缩机制）。 当我们用二进制视角观察 GIF 时，它是由一个个 数据块（Block） 组成的&…...

编程日记 2026/4/13 1:29:11

ORA-06521: PL/SQL映射函数错误，权威解析Oracle报错故障修复与远程处理方案

故障修复核心方案：首先检查PL/SQL代码中的映射函数调用，确保参数类型匹配，避免类型转换错误。执行以下SQL诊断：SELECT * FROM user_errors WHERE name 你的包名; 清理后重编译：ALTER PACKAGE your_package COMPILE; 如…...

编程日记 2026/4/13 1:29:11

Synopsys工具链实战：如何用VCS、DC、ICC和Calibre跑通你的第一个数字IC设计项目？

Synopsys工具链实战：从RTL到GDSII的完整数字IC设计之旅 在芯片设计领域，Synopsys工具链如同一位精密配合的交响乐团指挥，将VCS、Design Compiler、ICC和Calibre等专业工具无缝衔接。本文将带您体验一个完整的设计周期——从最初的RTL代码到最…...

编程日记 2026/4/13 1:27:10

iHRM项目实战

初始化项目环境 创建测试环境，项目文件夹 单接口测试 登录模块 检查步骤： 1.检查方法 2.检查url路径 3.检查请求头Header 4.检查请求体Body 5.检查Test 6.保存 登录成功 你写了断言脚本，但下方Test Results没有显示结果，核…...

编程日记 2026/4/13 1:27:10

【毕业季求生帖】论文盲目降AI等于白送钱？10款降AI软件红黑榜揭秘

今年毕业季，降AI率最大的难点其实早就不仅是降不降得下来，还有降完之后还能不能看，随着知网、维普接连升级AIGC检测算法，靠简单同义词替换已经完全行不通了。 而且最让大家崩溃的往往是这三点：第一，降完之后…...

编程日记 2026/4/13 1:27:10

Raspberry Pi Imager终极指南：告别复杂操作，轻松打造树莓派系统

Raspberry Pi Imager终极指南：告别复杂操作，轻松打造树莓派系统 【免费下载链接】rpi-imager The home of Raspberry Pi Imager, a user-friendly tool for creating bootable media for Raspberry Pi devices. 项目地址: https://gitcode.com/gh_mirr…...

编程日记 2026/4/13 1:27:10

ESP32 PlatformIO I/O扩展驱动：统一抽象与线程安全控制

1. 项目概述htcw_esp_io_expander是一个面向 ESP32 系列微控制器（特别是 ESP32-S2/S3/C3/C6）的 I/O 扩展驱动组件，其本质是将 Espressif 官方 ESP-IDF 组件仓库中io_expander模块封装为 PlatformIO 兼容的独立软件包。该组件并非全新实现&…...

编程日记 2026/4/13 1:27:09