项目规范体系生成器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_7334e1da/spec-generator。
技能介绍
要解决什么问题
新项目或老仓库常常缺少可执行的规范:团队口头约定散落在 README 里,AGENTS.md 与 .agents/rules/ 要么没有、要么与当前技术栈脱节。手动从各类最佳实践拼凑文档,既难覆盖后端盲区,也难保证与框架内置能力对齐。
技能如何工作
本技能以《通用项目规范体系设计指南》的五大支柱为骨架,走七阶段顺序流程,不允许跳步。入口在阶段零:必须通过交互确认任务意图(新生成、优化已有规范、集成本地 SKILL.md、仅推荐 Skills),避免宿主环境默认假设你的目标。
阶段一先做项目类型(全栈 / 仅前端 / 仅后端),再扫 package.json、go.mod、pyproject.toml 等预检已有栈,并结合检索给出动态选项,而非硬编码技术列表。技术栈确认后还会检索并推荐同栈开源参考项目,可选 clone 或在线分析。
阶段二对各维度做深度检索,把 Web 来源与本地技能正文合并为「技术最佳实践摘要」,本地条目需标注路径来源。后续阶段再完成规则域确认、规范文件生成与 Skills 推荐;优化已有规范时会走增量对齐路径。
适用边界与注意点
- 流程较长,适合你愿意分轮回答技术选型问题的场景,不适合「一句话就要完整规范」的期待。
- 本地技能仅作参考素材,不会作为独立规则域写入
.agents/rules/,也不能覆盖指南中的框架性原则。 - 若项目配置文件极少,预检会判定为空项目,仍需完整动态确认技术栈,不能凭空假设后端或数据库选型。
使用场景
- 为新仓库从零生成 `AGENTS.md` 与 `.agents/rules/` 整套规范文档
- 已有规范与最新《通用项目规范体系设计指南》不一致,需要增量修订并对齐
- 生成规范时要把团队本地多个 `SKILL.md` 作为参考素材并标注来源
- 技术栈刚定稿,希望按同栈检索开源参考项目再写进规范
适合人员
- 负责新 monorepo 落地、需要把前后端与工程化约束写成可执行文档的技术负责人
- 维护 Cursor/Agent 规则文件的工程师,希望规范与真实 `package.json`、`go.mod` 一致
- 在多技术栈项目中担任架构师、需要统一 AGENTS 规则域命名与引用方式的人
- 技能平台使用者,想在写项目规范时同步从 skills 生态检索可安装的 Skills