القائمة
执行 OpenSpec 规范驱动开发 (SDD) 。涵盖意图对齐、规范生成、代码实现与自动化验证。支持架构师 (写Spec/评审) 、开发 (写代码) 和 QA (写测试) 角色协同及 /opsx 指令体系。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Review Agent Skill directories and SKILL.md files against best practices. Use this skill when the user wants to review, validate, or check an Agent Skill implementation.
Use when you want to deeply understand an unfamiliar codebase and generate reusable cognitive skills from it, by providing a local path or GitHub URL
审查技术文档。支持四种独立评审类型：大纲评审（检查目录与结构逻辑）、内容评审（检查文字准确性与代码质量）、资产评审（校验链接与引用合规）、格式评审（校对纯视觉排版与标点）。当用户请求审查或修正 Markdown 文档时使用。
检查 Markdown 文件中的本地和外部链接有效性。当用户需要验证、检查 Markdown 文档或项目的链接可访问性时调用此技能。
分析和总结指定的本地 Markdown 文件，并输出结构化的中文总结。当用户请求总结、分析或提取本地 Markdown 文档信息时调用此技能。
将指定的本地 Markdown 文件翻译成指定语言（默认中文），并在文件名中添加语言标识后缀。当用户请求翻译本地 Markdown 文档时调用此技能。
| name | openspec-assistant |
| description | 执行 OpenSpec 规范驱动开发 (SDD) 。涵盖意图对齐、规范生成、代码实现与自动化验证。支持架构师 (写Spec/评审) 、开发 (写代码) 和 QA (写测试) 角色协同及 /opsx 指令体系。 |
此技能旨在帮助用户使用 OpenSpec 框架进行敏捷且高确定性的软件开发。作为 AI 编程助手，我们将严格遵循“意图 -> 规范 (Spec) -> 代码 -> 验证”的协同范式，确保 AI 生成的代码可控、可信、可维护。
本章节在最前面对 OpenSpec 协作过程中的核心角色和整体执行流程进行全局说明，指导用户和 AI 在不同阶段的协作方式。
为了保证开发的规范性，我们将工作流拆分为三个核心角色，他们在变更的生命周期中各司其职：
一个 Change (或 Milestone) 的标准生命周期流转如下：
proposal.md、design.md 和 spec.md。spec.md 中的场景 (Scenario) 设计并编写测试用例骨架。本章节概述了 OpenSpec 的底层哲学以及核心双态目录结构，作为整个开发流程的理论基础。
OpenSpec 不仅仅是一套文档格式，更是一种规范驱动开发 (Spec-Driven Development) 的工程实践。它作为上下文锚点与契约守护者，约束着代码的生成边界。
openspec/specs/) ：系统当前真实的规格基线。所有已发布的特性都必须在此处有对应的规格定义。openspec/changes/<name>/) ：进行中的变更。每个变更是一个独立的文件夹，包含 proposal.md (Why & What) 、design.md (How) 、specs/ (Deltas) 和 tasks.md (Steps) 。本章节概述了三个核心角色在不同阶段的具体职责与核心动作。
为了保证开发的规范性，我们将工作流拆分为 Architect、QA 和 Developer 三个核心角色。
有关各角色在 Change 生命周期中的详细动作指南，请读取 references/role-workflow.md 文件。
本章节列出了驱动 OpenSpec 流程的核心指令，包括 AI 协同指令与底层 CLI 命令。
本小节展示了在支持的 AI 编辑器中推荐使用的工作流指令。
推荐使用以下指令驱动全流程：
/opsx:propose <description>：提出变更并生成规范 (Architect 角色) 。/opsx:apply：根据规范实现代码与测试 (Developer & QA 角色) 。/opsx:archive：完成开发、评审代码且测试通过后，归档变更合并入主 Spec 。本小节提供了 OpenSpec 原生命令行工具的操作指引。
当需要进行底层管理或查阅 OpenSpec 原生命令行工具的操作备忘时，请读取 references/cli-commands.md 文件。
本章节总结了使用 OpenSpec 技能时必须遵循的高级指导原则，以确保最佳的 AI 协同效果。