Feedback: archive: a new main spec has no blank line after ## Purpose
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 78/100
- Issue 类型
- 缺陷
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- typescript
- 领域
- backend, documentation
调研方向
从 src/core/specs-apply.ts 的第 1429 行附近开始,这里 openspec archive 会为新功能生成主规范。检查生成的 Markdown,确认 ## Purpose 后有预期的空行,然后运行相关的格式检查和 markdownlint 检查。新归档的主规范无需手动修正格式即可通过这些检查时,工作就完成了。
由索引模型根据 Issue 内容生成。
描述
What happened
archive: a new main spec has no blank line after ## Purpose
Details
When openspec archive creates the main spec of a new capability, it writes # <title> Specification\n\n## Purpose\n<body>\n\n## Requirements\n (src/core/specs-apply.ts, line 1429 on main). The missing blank line after ## Purpose fails Prettier and markdownlint MD022 on every new main spec, so each archive needs a prettier --write fix afterwards. Seen on 1.15.0 and 1.16.0; the line is unchanged on main. Expected: ## Purpose\n\n<body>. #1637 fixed the same kind of gap around ## Requirements.
Minimal steps to reproduce
Not provided — filed with openspec feedback. If this is a bug, please add the shortest steps that reproduce it from a fresh project.
Submitted via OpenSpec CLI
- Version: 1.16.0
- Platform: darwin
- Timestamp: 2026-11-17T08:04:33.585Z
- 主要语言
- TypeScript
- 星标
- 74.9k
- 派生
- 5.1k
- 平均合并
- 2 天 10 小时
- 30 天内合并 PR
- 53
环境准备
在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
Fission-AI/OpenSpec 的其他 Issue
-
documentation needs-triage
难度 1/5 1-3 小时 新手友好度 83/100
Fission-AI/OpenSpec#2244 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 94/100
Fission-AI/OpenSpec#2239 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 88/100
Fission-AI/OpenSpec#2236 · 1 个 reaction ·
维护者通常 1 天内回复
-
Community Showcase: add rightcommit可能已有人在做 @TabishB 于 6 天前认领。 未关闭documentation needs-triage
难度 1/5 1 小时以内 新手友好度 88/100
Fission-AI/OpenSpec#2231 ·
维护者通常 1 天内回复
-
难度 1/5 1-3 小时 新手友好度 76/100
Fission-AI/OpenSpec#2208 ·
维护者通常 1 天内回复
查看 Fission-AI/OpenSpec 的全部 Issue
相似的 Issue
-
Type/Improvement
难度 2/5 1-3 小时 新手友好度 67/100
OpenNSW/nsw-srilanka#1259 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
oxc-project/tsrs#1010 ·
维护者通常 1 天内回复
-
Add: ESP 1 UK未关闭check:passed streams:add
难度 1/5 1-3 小时 新手友好度 64/100
维护者通常 1 天内回复
-
area:infra area:storage bug
难度 2/5 1-3 小时 新手友好度 76/100
THU-MAIC/OpenMAIC#2311 · 1 条评论 ·
维护者通常 1 天内回复
-
docs documentation need-triage SaaS
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 1 天内回复