| name | speclite-quick-dev |
| description | 执行 SpecLite Quick Dev workflow，把明确需求转成可审查的实现补丁。用于用户要求 quick dev、快速修复、添加功能、重构、修改代码或运行 quick dev。核心能力：澄清范围、规划变更、实现、测试并进入 review。 |
| allowed-tools | Read, Write, Bash, Grep, Glob, WebSearch |
| metadata | {"version":"1.0.1","author":"fancyliu","catalog":"speclite"} |
[技能说明]
Quick Dev 是 Speclite 实施与交付推进工作流 Skill，用于在目标项目中按配置语言、输出语言和工作流步骤完成对应制品或交付动作。
源入口说明：Implements any user intent, requirement, story, bug fix or change request by producing clean working code artifacts that follow the project's existing architecture, patterns and conventions. Use when the user wants to build, fix, tweak, refactor, add or modify any code, component or feature.
[核心能力]
- Speclite 激活解析：解析三层 customize（base→team→user）、workflow.persistent_facts 和 workflow.on_complete，并通过 speclite resolve config --project-root {project-root} 加载 merged runtime config。
- 源制品发现与上下文加载：按 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}，按 communication_language 与用户沟通，并执行 activation_steps_append。配置文件缺失或关键字段为空时必须 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/compile-epic-context.md、references/steps/step-01-clarify-and-route.md、references/steps/step-02-plan.md、references/steps/step-03-implement.md、references/steps/step-04-review.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-quick-dev。
- references/workflow-details.md 和配套 reference 文件均为有效执行规约，不是背景资料。
- 模板或示例骨架位于 assets/spec-template.md。
- 如工作流需要项目配置，必须读取目标项目运行时配置。
- config.toml.example 仅作字段结构参考，不作为 runtime fallback。
- 当前运行规约不得依赖旧运行目录、旧 YAML 配置或旧命令命名空间。
- 输出文档末尾必须追加 *本文档由 speclite-quick-dev Skill 自动生成* 标注。
[生成信息]
本 Skill 由 speclite-skill-creator 自动生成。
