openspec-assistant
OpenSpec 规范驱动开发辅助技能
此技能旨在帮助用户使用 OpenSpec 框架进行敏捷且高确定性的软件开发。作为 AI 编程助手,我们将严格遵循“意图 -> 规范 (Spec) -> 代码 -> 验证”的协同范式,确保 AI 生成的代码可控、可信、可维护。
1. 角色职责与执行流程总览
本章节在最前面对 OpenSpec 协作过程中的核心角色和整体执行流程进行全局说明,指导用户和 AI 在不同阶段的协作方式。
1.1 核心角色定义
为了保证开发的规范性,我们将工作流拆分为三个核心角色,他们在变更的生命周期中各司其职:
- 架构师 (Architect):负责“想清楚”与“最后把关”。在开发前进行意图对齐与规格定义 (生成 Spec) ;在开发后对照 Spec 进行代码评审与归档。
- 测试工程师 (QA):负责“验证标准”。基于 Architect 输出的 Spec ,提取业务场景并设计自动化测试用例,为开发提供明确的红绿验收基准。
- 开发工程师 (Developer):负责“落地实现”。严格按照 Spec 定义的模型与接口,以及 QA 提供的测试用例,进行业务逻辑的编码实现。
1.2 标准执行流程
一个 Change (或 Milestone) 的标准生命周期流转如下:
More from forceinjection/awesome-skills
doc-reviewer
审查技术文档。支持四种独立评审类型:大纲评审(检查目录与结构逻辑)、内容评审(检查文字准确性与代码质量)、资产评审(校验链接与引用合规)、格式评审(校对纯视觉排版与标点)。当用户请求审查或修正 Markdown 文档时使用。
5agent-skill-reviewer
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.
5project-analyzer
Generate a comprehensive project documentation (whitepaper) based on deep codebase analysis, covering architecture, modules, testing, and deployment.
4dir-organizer
整理和优化项目目录结构。当用户请求整理目录、分类文件、清理无用文件或重构文件夹结构时调用此技能。
4code-reader
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
4md-summarizer
分析和总结指定的本地 Markdown 文件,并输出结构化的中文总结。当用户请求总结、分析或提取本地 Markdown 文档信息时调用此技能。
4