AGENT SKILL

speclite-prfaq

执行 SpecLite PRFAQ workflow,用 Working Backwards 方法打磨产品概念。用于用户要求 PRFAQ、work backwards、创建 PRFAQ 或运行 PRFAQ。核心能力:配置驱动激活、发现来源产物、按步骤编排、生成输出并交接完成。

License 许可
MIT
所属仓库
flanliulf/SpecLite
最近更新
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

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

flanliulf
flanliulf/SpecLite

speclite-dev-story

暂无简介

★ 4
flanliulf
flanliulf/SpecLite

speclite-code-review-01-reviewer

Fixture-owned installed skill entry for the minimal artifact loop.

★ 4
flanliulf
flanliulf/SpecLite

speclite-skill-lint

只读检查 Skill 定义;用于 lint skill、check skill、检查技能或评估 Skill 规范。区分基础格式、Codex 适配和 SpecLite 约定,报告证据及未检查项;Agent 定义包转交 speclite-agent-lint。

★ 4
flanliulf
flanliulf/SpecLite

speclite-skill-creator

创建或迭代 SpecLite workflow Skill;用于 create skill、新建技能、生成技能包或封装工作流。设计入口、辅助资源和验证用例;Agent 定义包转交 speclite-agent-creator。

★ 4
flanliulf
flanliulf/SpecLite

speclite-html-ppt-generator

生成 SpecLite-owned 单文件 HTML PPT。用于用户要求创建 docs presentation、HTML PPT、网页 slides、Swiss Style deck、杂志风 deck,或其他可直接浏览器打开的介绍/分享型 deck。核心能力:使用本 Skill 内置模板、主题、layout 和 validator 生成横向翻页 HTML,并避免依赖外部个人 skill 路径。

★ 4
flanliulf
flanliulf/SpecLite

speclite-docs-intro-ppt-creator

生成 SpecLite docs 下的介绍型 HTML PPT。用于用户要求把某个项目体系、系统设计、治理机制、理念或工作流总结成 docs presentation、HTML PPT、网页 slides、介绍 deck。核心能力:限定输出目录、基于事实材料规划叙事、调用 speclite-html-ppt-generator 生成单 HTML deck,并用确定性检查和浏览器抽样收口。

★ 4