메뉴
验证 SpecLite Story 与 Epic 的流程门控，检查 contract、functional 与 evidence anchors。用于用户要求 flow gate、story kickoff gate、epic gate、门控检查或防止 dev-story 前后锚点漂移。核心能力：执行四种 gate 模式、判定 PASS_EQUIVALENT、生成报告与交接建议。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
检查 SpecLite canonical source 变更后的派生一致性。用于用户要求 canonical source check、检查 assets/source/speclite、canonical 变更闭环、更新 skill/hook/agent 后验收或扫描 sdlc/core/total 数量。核心能力：对齐 root counts、module-help.csv、hook source、baseline 常量、fixtures、docs 和 packaging manifest。
分析当前 SpecLite workflow 状态并回答使用问题或推荐下一步 skill。用于用户询问 help、next skill、下一步、我现在该做什么或需要流程定位。核心能力：读取 catalog、配置、产物与项目知识，给出有证据的路由建议。
Analyze brownfield backend projects to derive technology stack from code facts and write a Markdown report to a user-specified output directory. Use when user mentions 'tech stack audit', 'backend stack', 'brownfield tech stack', 'code-fact based stack', '技术栈分析', '后端技术栈', '项目技术栈清单', '基于代码事实', '输出到目录', or asks to generate a stack inventory from an existing backend repository. Capable of ecosystem-neutral repository discovery, dependency/version evidence classification, runtime configuration extraction, uncertainty tagging, and evidence-linked Markdown generation.
Analyze brownfield Java and Spring Boot backend projects to derive technology stack from code facts and write a Markdown report to a user-specified output directory. Use when user mentions 'Java tech stack', 'Spring Boot stack', 'Maven dependency audit', 'Java 后端技术栈', 'SpringBoot 技术栈', 'Spring Boot 技术栈', 'Maven 依赖分析', '基于代码事实', or asks to generate a Java backend stack inventory. Capable of Maven/Gradle module discovery, effective dependency and BOM version resolution, Spring ecosystem detection, runtime configuration extraction, and evidence-linked Markdown generation.
Analyze brownfield Node.js backend projects to derive technology stack from code facts and write a Markdown report to a user-specified output directory. Use when user mentions 'Node.js tech stack', 'NestJS stack', 'Express stack', 'package lock audit', 'Node 后端技术栈', 'Node.js 技术栈', 'NestJS 技术栈', 'npm 依赖分析', '基于代码事实', or asks to generate a Node backend stack inventory. Capable of package-manager detection, lockfile version resolution, Node runtime evidence extraction, framework detection, and evidence-linked Markdown generation.
Analyze brownfield Python backend projects to derive technology stack from code facts and write a Markdown report to a user-specified output directory. Use when user mentions 'Python tech stack', 'FastAPI stack', 'Django stack', 'requirements audit', 'Python 后端技术栈', 'FastAPI 技术栈', 'Django 技术栈', 'Python 依赖分析', '基于代码事实', or asks to generate a Python backend stack inventory. Capable of Python packaging detection, lockfile/requirements version resolution, runtime evidence extraction, ASGI/WSGI framework detection, and evidence-linked Markdown generation.
| name | speclite-flow-gate |
| description | 验证 SpecLite Story 与 Epic 的流程门控，检查 contract、functional 与 evidence anchors。用于用户要求 flow gate、story kickoff gate、epic gate、门控检查或防止 dev-story 前后锚点漂移。核心能力：执行四种 gate 模式、判定 PASS_EQUIVALENT、生成报告与交接建议。 |
| allowed-tools | Read, Write, Grep, Glob, Bash |
| metadata | {"version":"1.0.0","author":"fancyliu","catalog":"speclite"} |
[Overview（技能说明）]
SpecLite 实现阶段流程门控 Skill，用于在 Story/Epic 启动或完成时检查 planning contract、实际源码实现和测试证据是否一致，避免等到 speclite-dev-story 执行中途才 HALT。
[Core Capabilities（核心能力）]
- Mode 驱动门控：支持 story-kickoff、story-completion、epic-completion、epic-kickoff 四种检查模式。
- Anchor 分类：区分 Contract Anchor、Functional Anchor、Evidence Anchor 和 Guidance Anchor，禁止把未契约化文件名当成唯一 hard gate。
- 等价实现裁决：当实现形态偏离 Story guidance 但 owning SPEC、源码路径和测试证据成立时，输出 PASS_EQUIVALENT。
- 失败类型定位：用 FAIL_CONTRACT、FAIL_FUNCTION、FAIL_EVIDENCE、DECISION_NEEDED 精确说明阻断原因。
- 报告生成：把 gate report 写入 {implementation_artifacts}/flow-gates/，供 sprint-status、dev-story、CR 和 finalizer 消费。
- 流转建议：给出下一步动作，例如继续 dev-story、修订 Story、补测试证据、或先运行 Epic completion gate。
[Workflow（执行流程）]
1. 完整阅读 references/workflow-details.md；该文件是四种 gate mode、结果枚举、报告格式和 HALT 规则的权威定义。遇到等价实现或固定路径歧义时，同时读取 references/regression-scenarios.md。
2. 解析目标 mode 与目标对象：Story key、Story 文件路径、Epic 编号或下一 Epic 编号。
3. 加载 merged runtime config、sprint-status.yaml、目标 Story/Epic、owning SPECs、相关源码和测试证据。
4. 按 Contract -> Functional -> Evidence -> Guidance 顺序做门控判断，并生成 assets/report-template.md 规定的报告。
5. 只有 PASS 或 PASS_EQUIVALENT 允许后续 workflow 继续；其他结果必须先修正文档、实现或证据。
[Notes（注意事项）]
- 固定文件名只有在 owning SPEC 明确指定时才是 hard gate；否则必须先检查等价 functional implementation 和测试证据。
- 本 Skill 只生成 gate report，不修改源码、不推进 Story/Epic 状态、不替代 CR。
- 报告必须写入 {implementation_artifacts}/flow-gates/，文件名按 mode 和目标对象稳定生成。
- 报告开头的 YAML frontmatter 是 downstream hook、dev-story、CR 和 finalizer 的 machine-readable source；不得要求消费者解析 Markdown prose 判断 gate result。
- Guidance Anchor mismatch 不能直接判定 blocked；只能在确认 contract/function/evidence 缺失后输出失败。
- 中英文入口必须同步更新；新增 mode 或结果枚举时同步更新 references/workflow-details.md。
[Generation Metadata（生成信息）] 本 Skill 由 speclite-skill-creator 自动生成。如需修改，必须同步更新 SKILL.md 与 SKILL.en.md，并通过 skills-upgrade 管理版本。
