jsmastery-pro/skills

解决的问题

为 AI 编码代理提供一种结构化、基于文件的工程工作流，防止通常在聊天会话中发生的上下文丢失。通过将项目状态（如范围、规格和上下文文件）移入仓库本身，使工作能够在会话之间持久化，并在开发团队和代理之间共享。

如何工作

该项目实现了一系列“技能”（模块化指令），AI 代理可以执行这些技能将功能从想法推进到生产环境。不依赖聊天历史，每个技能都从仓库中的特定文件读取并写入（例如，AGENTS.md 用于上下文，docs/specs/ 用于架构）。

工作流遵循逻辑推进：

1. 规划：/scope 定义产品构想，/audit 初始化项目上下文。
2. 设计：/architect 为关键决策创建构建规格。
3. 实现：/develop 根据规格构建功能，若缺少设计决策则阻断流程。
4. 验证：/check verify 运行应用，/test 编写测试套件，/check review 执行跨模型代码审查。
5. 收尾：/document 生成 PR 和变更日志，/sync 更新项目状态。

适用人群

使用 AI 编码代理（如 Claude Code、Cursor、Codex 或 Gemini CLI）并希望采用专业、有纪律的软件工程流程，而非随意提示的开发者。

主要亮点

• 基于文件的状态管理：状态存储在仓库中而非聊天中，因此即使会话重启，工作也能持续。
• 纵深防御式阻断机制：若缺少规格，/develop 会自动回退至 /architect，防止在设计前进行实现。
• 工作流的严格程度可选：根据项目需求，提供原型、Alpha、Beta、GA 等不同严格程度的建议级别。
• 跨模型审查：支持在 /check review 阶段使用不同 AI 模型，以确保更高代码质量。
• 支持单体仓库：可将工作流限定在特定工作区，每个工作区拥有独立的上下文和命令。