speclite-prfaq
执行 SpecLite PRFAQ workflow,用 Working Backwards 方法打磨产品概念。用于用户要求 PRFAQ、work backwards、创建 PRFAQ 或运行 PRFAQ。核心能力:配置驱动激活、发现来源产物、按步骤编排、生成输出并交接完成。
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 4
- Forks
- 0
01 前言 Front Matter
- name
- speclite-prfaq
- metadata
- { "author": "fancyliu", "catalog": "speclite", "version": "1.0.0" }
- description
- 执行 SpecLite PRFAQ workflow,用 Working Backwards 方法打磨产品概念。用于用户要求 PRFAQ、work backwards、创建 PRFAQ 或运行 PRFAQ。核心能力:配置驱动激活、发现来源产物、按步骤编排、生成输出并交接完成。
- allowed-tools
- Read, Write, Bash, Grep, Glob, WebSearch
02 资源文件 13
- 资产文件assets/prfaq-template.md1.4 KB
- 参考文档CHANGELOG.md351 B
- 其他config.toml.example677 B
- 其他customize.toml1.6 KB
- 参考文档data/speclite-manifest.json475 B
- 参考文档references/agents/artifact-analyzer.md2.6 KB
- 参考文档references/agents/web-researcher.md1.7 KB
- 参考文档references/customer-faq.md3.7 KB
- 参考文档references/internal-faq.md3.9 KB
- 参考文档references/press-release.md4.2 KB
- 参考文档references/verdict.md4.3 KB
- 参考文档references/workflow-details.md14.1 KB
- 参考文档SKILL.en.md4.2 KB
03 SKILL.md 正文
[技能说明] Prfaq 是 Speclite 分析与项目发现工作流 Skill,用于在目标项目中按配置语言、输出语言和工作流步骤完成对应制品或交付动作。
源入口说明:Working Backwards PRFAQ challenge to forge product concepts. Use when the user requests to 'create a PRFAQ', 'work backwards', or 'run the PRFAQ challenge'.
[核心能力]
- Speclite 激活解析:解析三层 customize(base→team→user)、workflow.persistent_facts 和 workflow.on_complete,并通过 speclite resolve config --project-root {project-root} 加载非 artifact-root runtime config,通过 speclite resolve artifact-roots --project-root {project-root} 加载 resolved artifact roots。
- 源制品发现与上下文加载:按 workflow 规约读取项目制品、配置字段、历史上下文和必要数据文件,保持源流程的输入发现语义。
- 步骤化工作流执行:按 references/workflow-details.md 与拆分后的 reference/step 文件逐步执行,遵守顺序、HALT 条件、菜单等待和状态推进规则。
- 模板化输出生成:使用 assets 中的模板或示例骨架生成文档、报告、规格或交付产物,输出语言服从 document_output_language。
- 质量校验与交接:执行清单、报告、状态同步或 completion handoff,并在退出前解析和执行 workflow.on_complete。
- 迁移一致性约束:当前运行规约只依赖 Speclite runtime,不读取旧运行目录、旧配置文件或旧命令命名空间。
[约定]
裸路径相对于 {skill-root} 解析;{project-root} 是目标项目工作目录;{speclite-runtime-root} 是 {project-root}/_speclite;{skill-name} 是目录 basename。
[激活流程]
触发后先解析 workflow,执行 activation_steps_prepend,加载 persistent_facts,运行 speclite resolve config --project-root {project-root} 与 speclite resolve artifact-roots --project-root {project-root},按 communication_language 与用户沟通,并执行 activation_steps_append。配置文件缺失、关键字段为空或必需 artifact root 缺失时必须 HALT;config.toml.example 只说明字段结构,不作为 runtime fallback。
customization 必须通过 `speclite resolve customization --skill {skill-root} --project-root {project-root}` 读取 merged JSON;`workflow.on_complete` 使用 `speclite resolve customization --skill {skill-root} --project-root {project-root} --key workflow.on_complete` 解析。默认 activation 不手写 TOML merge,不使用 `--human` 作为 machine input。
[执行流程]
1. 先完整阅读 references/workflow-details.md;该文件是从源入口转换后的权威工作流规约。随后按需读取 references/workflow-details.md、references/agents/artifact-analyzer.md、references/agents/web-researcher.md、references/customer-faq.md、references/internal-faq.md、references/press-release.md 等 reference 文件。
2. 执行工作流前,确认 {skill-root}、{project-root}、{speclite-runtime-root}、{skill-name} 四个路径变量均已明确。
3. 若 workflow 指向 step 文件,必须一次只读取当前 step,完整执行后再进入下一步;遇到菜单或用户确认点时 HALT 等待。
4. 生成或更新产物时,按源 workflow 的模板、清单、状态字段和输出位置要求执行,不得因为迁移而改变核心需求。
5. 收尾前运行 checklist 或质量检查,解析 workflow.on_complete,并在输出文档末尾追加本 Skill 的生成标注。
[注意事项]
- 名称、目录与 YAML name 字段保持 kebab-case 一致:speclite-prfaq。
- references/workflow-details.md 和配套 reference 文件均为有效执行规约,不是背景资料。
- 模板或示例骨架位于 assets/prfaq-template.md。
- 数据和结构化参考位于 data/speclite-manifest.json。
- PRFAQ 输出默认写入 {analysis_artifacts}/prfaq/;主 PRFAQ、distillate、stage/resume 与 verdict 行为不改变 basename。Existing install 的 legacy root-level discovery 仅在 analysis_artifacts.resolutionMode=legacy-compatible 时启用,且不迁移既有 artifact。
- config.toml.example 仅作字段结构参考,不作为 runtime fallback。
- 当前运行规约不得依赖旧运行目录、旧 YAML 配置或旧命令命名空间。
- 输出文档末尾必须追加 *本文档由 speclite-prfaq Skill 自动生成* 标注。
[生成信息] 本 Skill 由 speclite-skill-creator 自动生成。
04 同仓库更多 Skills
speclite-dev-story
暂无简介
speclite-code-review-01-reviewer
Fixture-owned installed skill entry for the minimal artifact loop.
speclite-skill-lint
只读检查 Skill 定义;用于 lint skill、check skill、检查技能或评估 Skill 规范。区分基础格式、Codex 适配和 SpecLite 约定,报告证据及未检查项;Agent 定义包转交 speclite-agent-lint。
speclite-skill-creator
创建或迭代 SpecLite workflow Skill;用于 create skill、新建技能、生成技能包或封装工作流。设计入口、辅助资源和验证用例;Agent 定义包转交 speclite-agent-creator。
speclite-html-ppt-generator
生成 SpecLite-owned 单文件 HTML PPT。用于用户要求创建 docs presentation、HTML PPT、网页 slides、Swiss Style deck、杂志风 deck,或其他可直接浏览器打开的介绍/分享型 deck。核心能力:使用本 Skill 内置模板、主题、layout 和 validator 生成横向翻页 HTML,并避免依赖外部个人 skill 路径。
speclite-docs-intro-ppt-creator
生成 SpecLite docs 下的介绍型 HTML PPT。用于用户要求把某个项目体系、系统设计、治理机制、理念或工作流总结成 docs presentation、HTML PPT、网页 slides、介绍 deck。核心能力:限定输出目录、基于事实材料规划叙事、调用 speclite-html-ppt-generator 生成单 HTML deck,并用确定性检查和浏览器抽样收口。