specforge

用 citty + @clack/prompts 构建 Node.js CLI 的端到端工作流，覆盖命令路由、参数 schema、 终端交互、异步任务 UI 与 ESM 发布。触发词：citty、clack、prompts、CLI、命令行、子命令、 交互式、spinner、defineCommand、runMain、ESM 发布。

构建、扩展或调试 CodeMirror 6 浏览器代码编辑器，覆盖状态事务、扩展原语、 装饰、Compartment、语言包、补全诊断、主题、React 集成与 CM5→CM6 迁移。 触发词：CodeMirror 6、CM6、@codemirror/、EditorView、StateField、 Lezer、@uiw/react-codemirror。

使用 @pierre/diffs 与 @pierre/trees 构建代码审查、PR 视图、IDE 文件树、Merge Conflict 解决器。 覆盖 React/Vanilla API、虚拟化、Worker Pool、SSR、Shadow DOM 主题、CodeMirror 集成。 触发词：pierre、diff 渲染、文件树、PR 视图、merge conflict。

GitHub 仓库运营 + npm 包 tag 触发发布的一体化工作流。覆盖 issue/PR 分诊、CI 排障、 安全告警，以及 npm publish（provenance / scoped）+ 自动 GitHub Release（CHANGELOG 段落注入）。 触发词：github、gh、release、publish、tag、npm、provenance、changelog、triage、ci broken、版本发布。

为长跑 AI Coding 任务（Codex /goal、Claude Code、Cursor、Kiro autopilot）构建可审计、 不假完成、抗漂移的提示词。激活后先澄清需求、自动加载 AGENTS.md / 当前 spec / lessons.md， 再产出 5 段式 goal 与长跑健康守则。触发词：goal、写 goal、长任务、长跑、ralph。

使用 Mantine 组件库构建 React UI。涵盖核心组件选型、主题定制、Styles API、 布局模式、表单处理、日期选择器、图表、日程组件、通知系统、模态框管理、 Spotlight 搜索、文件上传、轮播、富文本编辑与 50+ hooks。 触发词：Mantine、UI 组件、主题配置、Styles API、DatePicker、Schedule、 Heatmap、通知、模态框、表单布局、Spotlight、Dropzone、Carousel、hooks。

清窗/重启协议：定义何时清窗、清窗前落盘 PROGRESS、恢复后第一动作，防止 AI 代理在长会话中重复失败路径

Python 惯用法与代码风格规范——PEP 8、类型注解、EAFP、数据类、生成器、上下文管理器、装饰器、并发模式、pyproject.toml 组织。 当编写、审查或重构 Python 代码时自动触发。 触发词：Python、PEP 8、类型注解、type hints、dataclass、asyncio、pyproject、ruff、mypy、pythonic。

PyTorch 代码规范——设备无关、可复现、张量形状管理、nn.Module 组织、训练/评估循环、DataLoader 优化、混合精度、checkpoint。编写或审查 PyTorch 训练脚本、模型、数据管道时触发。 触发词：PyTorch、torch、nn.Module、DataLoader、autograd、AMP、checkpoint、CUDA、tensor shape。

Spring Security 生产安全基线——认证/授权、Bean Validation、CSRF/CORS/响应头、密码哈希、秘密管理、限流、文件上传、日志脱敏、依赖 CVE。处理认证、输入、秘密时触发。 触发词：Spring Security、JWT、OAuth2、@PreAuthorize、BCrypt、CSRF、CORS、CSP、限流、OWASP。

Python 测试实战——pytest 断言、fixture、parametrize、mock、async 测试、tmp_path、覆盖率门禁与配置。为 Python 项目写/审查测试时触发。 触发词：pytest、Python 测试、fixture、parametrize、mock、pytest-asyncio、coverage、tmp_path。

Spring Boot 测试规范——JUnit 5 + Mockito 单元测试、MockMvc、@DataJpaTest、Testcontainers、JaCoCo 门禁。为 Spring Boot 写测试时触发。 触发词：Spring Boot、JUnit、Mockito、MockMvc、@WebMvcTest、@DataJpaTest、Testcontainers、JaCoCo。

对标 Linear / Raycast / Arc 的 Editorial Minimalism 设计规范，用于工具类 / Dashboard / SaaS。 约定 Tailwind + Framer Motion + Lucide、OKLCH、Accent-Dim、rounded-2xl、Bento Grid 布局。 触发词：Linear 风格、Raycast、Arc、工具类 UI、高级感。

Spring Boot 发布前验证闭环——构建、静态分析、测试 + JaCoCo、CVE 扫描、秘密检查、diff review。开 PR、重构、上线、依赖升级后触发。 触发词：pre-PR、pre-release、verification loop、SpotBugs、Checkstyle、Dependency-Check、jacoco、上线前检查。

基于 git 差异增量同步项目对外文档。每次触发读取项目根目录的 state 文件中的上次同步 SHA，汇总该 SHA 到当前 HEAD 之间的所有变动（提交记录 + 文件改动），按项目约定把变动写回相应文档，完成后把最新 HEAD SHA 持久化回 state 文件。通用适用于任何 git 仓库与任意一组对外文档（README / CHANGELOG / AGENTS / CONTRIBUTING / API docs 等）。触发词：`update docs`、`sync docs`、`docs-sync`、`refresh documentation`、`文档同步`、`更新文档`、`更新 README`、`更新 CHANGELOG`、"看一下最近改了什么然后更新文档"、"基于 git 变更刷新对外文档"。适用场景：仓库累积了一批 commit 后需要把源码、模板、CI、依赖、命令等变动反映到对外文档里；不适用于从零创建文档或一次性大改版。

创建、编辑、改进或审计 SpecForge 技能（skill）。当需要从零创建新技能，或被要求优化、 审查、清理、重构已有技能或 SKILL.md 时使用。同样适用于技能目录的整理（把文件迁移到 references/ 或 scripts/、删除过时内容、按 SpecForge 契约校验）。触发词：创建技能、 新建 skill、优化这个技能、审查技能、整理技能、清理 SKILL.md。

创建、改造、丰富 SpecForge command 模板（workflow-command 与 tool-command）的方法论技能。 涵盖两种工作模式： (A) Create 模式 —— 从零开始创建新命令模板，含 frontmatter、preamble、Iron Law、Steps、产物清单、handoff、错误字典引用、反规避提醒、渐进式披露拆分； (B) Enrich 模式 —— 深度内化用户提供的参考资料（书籍章节、链接、文档、最佳实践等），把其中的模式/清单/陷阱/脚本抽取并按 Level 1/2/3 编织进现有命令，绝不破坏模板骨架。 触发场景：“新增命令/补齐 templates 命令内容/添加 tools command/改造 command 生成器/specforge add-command”、 “把这份资料内化进 X 命令”、“丰富 Y command 的步骤/清单/反规避”、“这个 command 是空壳，帮我补厚”、 “author/optimize/enrich/review a command template”。

事件驱动架构（EDA）设计模式——事件定义、发布/订阅、事件溯源、幂等性、顺序保证。当系统需要异步解耦、跨服务协同或行为审计时触发。 触发词：事件驱动、EDA、消息队列、pub/sub、事件溯源、CQRS、异步。

分层架构约束——展示层 / 应用层 / 领域层 / 基础设施层的职责边界与单向依赖规则。当新增模块、评审分层越界、或拆分 monolith 时触发。 触发词：分层架构、依赖倒置、干净架构、六边形架构、hexagonal、层级约束、依赖方向。

集成测试策略——测试范围界定、测试替身选择、数据准备、外部依赖治理、并发与稳定性。当跨模块协作、依赖数据库 / 消息队列 / 外部 API 时触发。 触发词：集成测试、integration test、contract test、test containers、外部依赖、数据库测试、mock vs real。

测试驱动开发（TDD）流程规范——Red / Green / Refactor 三步循环、测试先行铁律、测试粒度与命名约定。当实现新功能、修复 bug 或重构时触发。 触发词：TDD、测试驱动、Red-Green-Refactor、测试先行、failing test、kata。

SpecForge 方法论的语言适配层——将"运行测试 / Lint / 构建 / 同步版本号 / .gitignore"等抽象动作映射到 Node、Python、Java(Spring Boot)、Go、Rust、.NET 的具体命令与文件。 当命令或技能正文出现"参见 language-adapters"、"运行项目测试命令"、"同步版本号"、"统一 ignore 模式"等措辞时自动触发。 触发词：language-adapter、multi-language、spring、springboot、python、maven、gradle、pytest、cargo、go test、dotnet、技术栈适配。

微服务边界与架构决策记录模板——定义服务边界、接口契约、数据归属、通信方式。当进行架构设计或服务拆分时自动触发。 触发词：微服务、服务拆分、架构设计、服务边界、ADR。

中文 Conventional Commits 规范——type 英文 + scope 中文 + 描述中文。当创建 Git 提交时自动触发。 触发词：git commit、提交代码、commit message、提交信息。

中文团队代码审查文化——用建议替代命令、提问替代否定。当收到代码审查反馈或审查他人代码时自动触发。 触发词：代码审查、Code Review、CR、review 代码。

SQL 注入防护与常见安全漏洞检查——参数化查询、输入校验、最小权限原则。当涉及数据库操作或安全敏感代码时自动触发。 触发词：SQL、数据库操作、SQL 注入、安全漏洞、权限校验。

API 测试策略——测试金字塔（单元/集成/E2E）、测试用例设计（Given/When/Then）、Mock 策略、边界值覆盖。当编写或审查测试代码时自动触发。 触发词：写测试、测试策略、测试用例、单元测试、集成测试、API 测试。

移动端适配规范——响应式设计、触摸交互、性能优化、可访问性。当涉及移动端或响应式 UI 开发时自动触发。 触发词：移动端、响应式、手机端、适配、H5、小程序、touch。

Git 提交工作流辅助——提交前检查、提交粒度控制、WIP 提交处理、分支管理。当进行 Git 操作时自动触发。 触发词：git commit、提交、暂存、stash、分支管理。