用途:这是 SpecWeave 创建的所有 GitHub Issue 的强制格式标准,覆盖用户故事(us-.md)、Epic/Feature(FS- 文件夹)、增量(0001-* 文件夹)与规格(spec-*.md)等所有类型。
主要能力与规则:标题仅允许 [FS-XXX][US-YYY] 用户故事标题 或 [FS-XXX] 功能标题两种格式,禁止 [BUG]、[HOTFIX]、[FEATURE]、[DOCS] 等类型前缀(类型应使用 GitHub 标签),也禁止已弃用的 [Increment XXXX] 格式。每个 Issue 必须包含可勾选的验收标准(- [x] / - [ ],含 AC ID、描述、优先级、testable 标记)、可勾选任务(链接到 increment 的 tasks.md)、可点击的 GitHub URL(禁止相对路径)、从 AC 提取的优先级(P1 > P2 > P3,无则不显示),且不得包含 Project 字段或 undefined 值。
使用方式:由 Content Builder 生成内容——UserStoryContentBuilder 为参考实现(plugins/specweave-github/lib/user-story-content-builder.ts),UserStoryIssueBuilder 从 us-*.md 创建 Issue,GitHubFeatureSync 将 Feature 同步为里程碑、用户故事同步为 Issue。相关命令:/sw-github:sync、/sw-github:create-issue、/sw-github:update-user-story。
限制:github-client-v2.ts 会拒绝不合规标题;该标准无例外,所有 SpecWeave 生成的 Issue 都必须遵循。