[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75RRSFD5HQ60BYFV2VD6MBN":3,"skill-same:01M75RRSFD5HQ60BYFV2VD6MBN":52},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":33,"repositoryHtmlUrl":34,"repositoryHomepageUrl":35,"ownerHtmlUrl":36,"ownerBlogUrl":36,"ownerDescription":37,"updatedAt":38,"install":39,"resources":51},"01M75RRSFD5HQ60BYFV2VD6MBN","speckit-clarify",null,"Identify underspecified areas in the current feature spec by asking up to 5 highly targeted clarification questions and encoding answers back into the spec.","ChanOoDev\u002Fspecflow-lite","ChanOoDev","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F112914718?v=4","01M75RR5Y2G3SBM50N566TZ6GW","Nyein Chan Oo","01M75RR5YQ7XY1NDE1FGCK0YNR",4,"MIT","https:\u002F\u002Fgithub.com\u002FChanOoDev\u002Fspecflow-lite\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fspeckit-clarify\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: \"speckit-clarify\"\ndescription: \"Identify underspecified areas in the current feature spec by asking up to 5 highly targeted clarification questions and encoding answers back into the spec.\"\nargument-hint: \"Optional areas to clarify in the spec\"\ncompatibility: \"Requires spec-kit project structure with .specify\u002F directory\"\nmetadata:\n  author: \"github-spec-kit\"\n  source: \"templates\u002Fcommands\u002Fclarify.md\"\nuser-invocable: true\ndisable-model-invocation: false\n---\n\n\n## User Input\n\n```text\n$ARGUMENTS\n```\n\nYou **MUST** consider the user input before proceeding (if not empty).\n\n## Pre-Execution Checks\n\n**Check for extension hooks (before clarification)**:\n- Check if `.specify\u002Fextensions.yml` exists in the project root.\n- If it exists, read it and look for entries under the `hooks.before_clarify` key\n- If the YAML cannot be parsed or is invalid, skip hook checking silently and continue normally\n- Filter out hooks where `enabled` is explicitly `false`. Treat hooks without an `enabled` field as enabled by default.\n- For each remaining hook, do **not** attempt to interpret or evaluate hook `condition` expressions:\n  - If the hook has no `condition` field, or it is null\u002Fempty, treat the hook as executable\n  - If the hook defines a non-empty `condition`, skip the hook and leave condition evaluation to the HookExecutor implementation\n- When constructing slash commands from hook command names, replace dots (`.`) with hyphens (`-`). For example, `speckit.git.commit` → `\u002Fspeckit-git-commit`.\n- For each executable hook, output the following based on its `optional` flag:\n  - **Optional hook** (`optional: true`):\n    ```\n    ## Extension Hooks\n\n    **Optional Pre-Hook**: {extension}\n    Command: `\u002F{command}`\n    Description: {description}\n\n    Prompt: {prompt}\n    To execute: `\u002F{command}`\n    ```\n  - **Mandatory hook** (`optional: false`):\n    ```\n    ## Extension Hooks\n\n    **Automatic Pre-Hook**: {extension}\n    Executing: `\u002F{command}`\n    EXECUTE_COMMAND: {command}\n\n    Wait for the result of the hook command before proceeding to the Outline.\n    ```\n- If no hooks are registered or `.specify\u002Fextensions.yml` does not exist, skip silently\n\n## Outline\n\nGoal: Detect and reduce ambiguity or missing decision points in the active feature specification and record the clarifications directly in the spec file.\n\nNote: This clarification workflow is expected to run (and be completed) BEFORE invoking `\u002Fspeckit-plan`. If the user explicitly states they are skipping clarification (e.g., exploratory spike), you may proceed, but must warn that downstream rework risk increases.\n\nExecution steps:\n\n1. Run `.specify\u002Fscripts\u002Fbash\u002Fcheck-prerequisites.sh --json --paths-only` from repo root **once** (combined `--json --paths-only` mode \u002F `-Json -PathsOnly`). Parse minimal JSON payload fields:\n   - `FEATURE_DIR`\n   - `FEATURE_SPEC`\n   - (Optionally capture `IMPL_PLAN`, `TASKS` for future chained flows.)\n   - If JSON parsing fails, abort and instruct user to re-run `\u002Fspeckit-specify` or verify feature branch environment.\n   - For single quotes in args like \"I'm Groot\", use escape syntax: e.g 'I'\\''m Groot' (or double-quote if possible: \"I'm Groot\").\n\n2. **IF EXISTS**: Load `.specify\u002Fmemory\u002Fconstitution.md` for project principles and governance constraints.\n\n3. Load the current spec file. Perform a structured ambiguity & coverage scan using this taxonomy. For each category, mark status: Clear \u002F Partial \u002F Missing. Produce an internal coverage map used for prioritization (do not output raw map unless no questions will be asked).\n\n   Functional Scope & Behavior:\n   - Core user goals & success criteria\n   - Explicit out-of-scope declarations\n   - User roles \u002F personas differentiation\n\n   Domain & Data Model:\n   - Entities, attributes, relationships\n   - Identity & uniqueness rules\n   - Lifecycle\u002Fstate transitions\n   - Data volume \u002F scale assumptions\n\n   Interaction & UX Flow:\n   - Critical user journeys \u002F sequences\n   - Error\u002Fempty\u002Floading states\n   - Accessibility or localization notes\n\n   Non-Functional Quality Attributes:\n   - Performance (latency, throughput targets)\n   - Scalability (horizontal\u002Fvertical, limits)\n   - Reliability & availability (uptime, recovery expectations)\n   - Observability (logging, metrics, tracing signals)\n   - Security & privacy (authN\u002FZ, data protection, threat assumptions)\n   - Compliance \u002F regulatory constraints (if any)\n\n   Integration & External Dependencies:\n   - External services\u002FAPIs and failure modes\n   - Data import\u002Fexport formats\n   - Protocol\u002Fversioning assumptions\n\n   Edge Cases & Failure Handling:\n   - Negative scenarios\n   - Rate limiting \u002F throttling\n   - Conflict resolution (e.g., concurrent edits)\n\n   Constraints & Tradeoffs:\n   - Technical constraints (language, storage, hosting)\n   - Explicit tradeoffs or rejected alternatives\n\n   Terminology & Consistency:\n   - Canonical glossary terms\n   - Avoided synonyms \u002F deprecated terms\n\n   Completion Signals:\n   - Acceptance criteria testability\n   - Measurable Definition of Done style indicators\n\n   Misc \u002F Placeholders:\n   - TODO markers \u002F unresolved decisions\n   - Ambiguous adjectives (\"robust\", \"intuitive\") lacking quantification\n\n   For each category with Partial or Missing status, add a candidate question opportunity unless:\n   - Clarification would not materially change implementation or validation strategy\n   - Information is better deferred to planning phase (note internally)\n\n4. Generate (internally) a prioritized queue of candidate clarification questions (maximum 5). Do NOT output them all at once. Apply these constraints:\n    - Maximum of 5 total questions across the whole session.\n    - Each question must be answerable with EITHER:\n       - A short multiple‑choice selection (2–5 distinct, mutually exclusive options), OR\n       - A one-word \u002F short‑phrase answer (explicitly constrain: \"Answer in \u003C=5 words\").\n    - Only include questions whose answers materially impact architecture, data modeling, task decomposition, test design, UX behavior, operational readiness, or compliance validation.\n    - Ensure category coverage balance: attempt to cover the highest impact unresolved categories first; avoid asking two low-impact questions when a single high-impact area (e.g., security posture) is unresolved.\n    - Exclude questions already answered, trivial stylistic preferences, or plan-level execution details (unless blocking correctness).\n    - Favor clarifications that reduce downstream rework risk or prevent misaligned acceptance tests.\n    - If more than 5 categories remain unresolved, select the top 5 by (Impact * Uncertainty) heuristic.\n\n5. Sequential questioning loop (interactive):\n    - Present EXACTLY ONE question at a time.\n    - For multiple‑choice questions:\n       - **Analyze all options** and determine the **most suitable option** based on:\n          - Best practices for the project type\n          - Common patterns in similar implementations\n          - Risk reduction (security, performance, maintainability)\n          - Alignment with any explicit project goals or constraints visible in the spec\n       - Present your **recommended option prominently** at the top with clear reasoning (1-2 sentences explaining why this is the best choice).\n       - Format as: `**Recommended:** Option [X] - \u003Creasoning>`\n       - Then render all options as a Markdown table:\n\n       | Option | Description |\n       |--------|-------------|\n       | A | \u003COption A description> |\n       | B | \u003COption B description> |\n       | C | \u003COption C description> (add D\u002FE as needed up to 5) |\n       | Short | Provide a different short answer (\u003C=5 words) (Include only if free-form alternative is appropriate) |\n\n       - After the table, add: `You can reply with the option letter (e.g., \"A\"), accept the recommendation by saying \"yes\" or \"recommended\", or provide your own short answer.`\n    - For short‑answer style (no meaningful discrete options):\n       - Provide your **suggested answer** based on best practices and context.\n       - Format as: `**Suggested:** \u003Cyour proposed answer> - \u003Cbrief reasoning>`\n       - Then output: `Format: Short answer (\u003C=5 words). You can accept the suggestion by saying \"yes\" or \"suggested\", or provide your own answer.`\n    - After the user answers:\n       - If the user replies with \"yes\", \"recommended\", or \"suggested\", use your previously stated recommendation\u002Fsuggestion as the answer.\n       - Otherwise, validate the answer maps to one option or fits the \u003C=5 word constraint.\n       - If ambiguous, ask for a quick disambiguation (count still belongs to same question; do not advance).\n       - Once satisfactory, record it in working memory (do not yet write to disk) and move to the next queued question.\n    - Stop asking further questions when:\n       - All critical ambiguities resolved early (remaining queued items become unnecessary), OR\n       - User signals completion (\"done\", \"good\", \"no more\"), OR\n       - You reach 5 asked questions.\n    - Never reveal future queued questions in advance.\n    - If no valid questions exist at start, immediately report no critical ambiguities.\n\n6. Integration after EACH accepted answer (incremental update approach):\n    - Maintain in-memory representation of the spec (loaded once at start) plus the raw file contents.\n    - For the first integrated answer in this session:\n       - Ensure a `## Clarifications` section exists (create it just after the highest-level contextual\u002Foverview section per the spec template if missing).\n       - Under it, create (if not present) a `### Session YYYY-MM-DD` subheading for today.\n    - Append a bullet line immediately after acceptance: `- Q: \u003Cquestion> → A: \u003Cfinal answer>`.\n    - Then immediately apply the clarification to the most appropriate section(s):\n       - Functional ambiguity → Update or add a bullet in Functional Requirements.\n       - User interaction \u002F actor distinction → Update User Stories or Actors subsection (if present) with clarified role, constraint, or scenario.\n       - Data shape \u002F entities → Update Data Model (add fields, types, relationships) preserving ordering; note added constraints succinctly.\n       - Non-functional constraint → Add\u002Fmodify measurable criteria in Success Criteria > Measurable Outcomes (convert vague adjective to metric or explicit target).\n       - Edge case \u002F negative flow → Add a new bullet under Edge Cases \u002F Error Handling (or create such subsection if template provides placeholder for it).\n       - Terminology conflict → Normalize term across spec; retain original only if necessary by adding `(formerly referred to as \"X\")` once.\n    - If the clarification invalidates an earlier ambiguous statement, replace that statement instead of duplicating; leave no obsolete contradictory text.\n    - Save the spec file AFTER each integration to minimize risk of context loss (atomic overwrite).\n    - Preserve formatting: do not reorder unrelated sections; keep heading hierarchy intact.\n    - Keep each inserted clarification minimal and testable (avoid narrative drift).\n\n7. Validation (performed after EACH write plus final pass):\n   - Clarifications session contains exactly one bullet per accepted answer (no duplicates).\n   - Total asked (accepted) questions ≤ 5.\n   - Updated sections contain no lingering vague placeholders the new answer was meant to resolve.\n   - No contradictory earlier statement remains (scan for now-invalid alternative choices removed).\n   - Markdown structure valid; only allowed new headings: `## Clarifications`, `### Session YYYY-MM-DD`.\n   - Terminology consistency: same canonical term used across all updated sections.\n\n8. Write the updated spec back to `FEATURE_SPEC`.\n\n9. **Re-validate Spec Quality Checklist** (if it exists):\n   - Check if `FEATURE_DIR\u002Fchecklists\u002Frequirements.md` exists.\n   - If it does NOT exist, skip this step silently.\n   - If it exists:\n     1. Read the checklist file.\n     2. Identify all GitHub task-list checkbox lines — lines matching `- [ ]`, `- [x]`, or `- [X]` (case-insensitive, tolerant of leading whitespace for nested items) outside of code fences. Ignore all other content (headings, notes, non-checkbox bullets, metadata).\n     3. For each checkbox line, record its current marker state (checked or unchecked) and item text into a before-snapshot list.\n     4. Re-evaluate each checkbox item against the **updated** spec (the version just saved in step 7).\n     5. For each checkbox item, update only if the checked\u002Funchecked state actually changes:\n        - If the item now passes and was unchecked: change `[ ]` to `[x]`.\n        - If the item now fails and was checked: change `[x]`\u002F`[X]` to `[ ]`.\n        - If the state is unchanged: leave the marker as-is (preserve existing case to avoid cosmetic diffs).\n     6. Save the updated checklist file. **Only toggle the `[ ]`\u002F`[x]` marker portion of checkbox lines whose state changed.** All other file content — headings, metadata, notes, line ordering, whitespace — must remain unchanged to avoid noisy diffs.\n     7. Compare the before-snapshot with the current state to compute three lists for the Completion Report:\n        - **Newly passing**: items that changed from unchecked to checked.\n        - **Regressions**: items that changed from checked to unchecked.\n        - **Still unchecked**: items that remain unchecked.\n     8. Record the before\u002Fafter pass counts as checked\u002Ftotal checkbox items (e.g., \"12\u002F16 → 15\u002F16 items passing\").\n\nBehavior rules:\n\n- If no meaningful ambiguities found (or all potential questions would be low-impact), respond: \"No critical ambiguities detected worth formal clarification.\" and suggest proceeding.\n- If spec file missing, instruct user to run `\u002Fspeckit-specify` first (do not create a new spec here).\n- Never exceed 5 total asked questions (clarification retries for a single question do not count as new questions).\n- Avoid speculative tech stack questions unless the absence blocks functional clarity.\n- Respect user early termination signals (\"stop\", \"done\", \"proceed\").\n- If no questions asked due to full coverage, output a compact coverage summary (all categories Clear) then suggest advancing.\n- If quota reached with unresolved high-impact categories remaining, explicitly flag them under Deferred with rationale.\n\nContext for prioritization: $ARGUMENTS\n\n## Mandatory Post-Execution Hooks\n\n**You MUST complete this section before reporting completion to the user.**\n\nCheck if `.specify\u002Fextensions.yml` exists in the project root.\n- If it does not exist, or no hooks are registered under `hooks.after_clarify`, skip to the Completion Report.\n- If it exists, read it and look for entries under the `hooks.after_clarify` key.\n- If the YAML cannot be parsed or is invalid, skip hook checking silently and continue to the Completion Report.\n- Filter out hooks where `enabled` is explicitly `false`. Treat hooks without an `enabled` field as enabled by default.\n- For each remaining hook, do **not** attempt to interpret or evaluate hook `condition` expressions:\n  - If the hook has no `condition` field, or it is null\u002Fempty, treat the hook as executable\n  - If the hook defines a non-empty `condition`, skip the hook and leave condition evaluation to the HookExecutor implementation\n- When constructing slash commands from hook command names, replace dots (`.`) with hyphens (`-`). For example, `speckit.git.commit` → `\u002Fspeckit-git-commit`.\n- For each executable hook, output the following based on its `optional` flag:\n  - **Mandatory hook** (`optional: false`) — **You MUST emit `EXECUTE_COMMAND:` for each mandatory hook**:\n    ```\n    ## Extension Hooks\n\n    **Automatic Hook**: {extension}\n    Executing: `\u002F{command}`\n    EXECUTE_COMMAND: {command}\n    ```\n  - **Optional hook** (`optional: true`):\n    ```\n    ## Extension Hooks\n\n    **Optional Hook**: {extension}\n    Command: `\u002F{command}`\n    Description: {description}\n\n    Prompt: {prompt}\n    To execute: `\u002F{command}`\n    ```\n\n## Completion Report\n\nReport completion (after questioning loop ends or early termination):\n- Number of questions asked & answered.\n- Path to updated spec.\n- Sections touched (list names).\n- Spec quality checklist status (if `FEATURE_DIR\u002Fchecklists\u002Frequirements.md` was re-validated): show before\u002Fafter pass counts (e.g., \"Spec Quality Checklist: 12\u002F16 → 15\u002F16 items passing\") and list any items that changed state — both newly checked (unchecked → checked) and any regressions (checked → unchecked). If any items remain unchecked, list them as areas needing attention.\n- Coverage summary table listing each taxonomy category with Status: Resolved (was Partial\u002FMissing and addressed), Deferred (exceeds question quota or better suited for planning), Clear (already sufficient), Outstanding (still Partial\u002FMissing but low impact).\n- If any Outstanding or Deferred remain, recommend whether to proceed to `\u002Fspeckit-plan` or run `\u002Fspeckit-clarify` again later post-plan.\n- Suggested next command.\n\n## Done When\n\n- [ ] Spec ambiguities identified and clarifications integrated into spec file\n- [ ] Spec quality checklist re-validated against updated spec (if `FEATURE_DIR\u002Fchecklists\u002Frequirements.md` exists)\n- [ ] Extension hooks dispatched or skipped according to the rules in Mandatory Post-Execution Hooks above\n- [ ] Completion reported to user with questions answered, sections touched, checklist status, and coverage summary\n","## User Input\n\n```text\n$ARGUMENTS\n```\n\nYou **MUST** consider the user input before proceeding (if not empty).\n\n## Pre-Execution Checks\n\n**Check for extension hooks (before clarification)**:\n- Check if `.specify\u002Fextensions.yml` exists in the project root.\n- If it exists, read it and look for entries under the `hooks.before_clarify` key\n- If the YAML cannot be parsed or is invalid, skip hook checking silently and continue normally\n- Filter out hooks where `enabled` is explicitly `false`. Treat hooks without an `enabled` field as enabled by default.\n- For each remaining hook, do **not** attempt to interpret or evaluate hook `condition` expressions:\n  - If the hook has no `condition` field, or it is null\u002Fempty, treat the hook as executable\n  - If the hook defines a non-empty `condition`, skip the hook and leave condition evaluation to the HookExecutor implementation\n- When constructing slash commands from hook command names, replace dots (`.`) with hyphens (`-`). For example, `speckit.git.commit` → `\u002Fspeckit-git-commit`.\n- For each executable hook, output the following based on its `optional` flag:\n  - **Optional hook** (`optional: true`):\n    ```\n    ## Extension Hooks\n\n    **Optional Pre-Hook**: {extension}\n    Command: `\u002F{command}`\n    Description: {description}\n\n    Prompt: {prompt}\n    To execute: `\u002F{command}`\n    ```\n  - **Mandatory hook** (`optional: false`):\n    ```\n    ## Extension Hooks\n\n    **Automatic Pre-Hook**: {extension}\n    Executing: `\u002F{command}`\n    EXECUTE_COMMAND: {command}\n\n    Wait for the result of the hook command before proceeding to the Outline.\n    ```\n- If no hooks are registered or `.specify\u002Fextensions.yml` does not exist, skip silently\n\n## Outline\n\nGoal: Detect and reduce ambiguity or missing decision points in the active feature specification and record the clarifications directly in the spec file.\n\nNote: This clarification workflow is expected to run (and be completed) BEFORE invoking `\u002Fspeckit-plan`. If the user explicitly states they are skipping clarification (e.g., exploratory spike), you may proceed, but must warn that downstream rework risk increases.\n\nExecution steps:\n\n1. Run `.specify\u002Fscripts\u002Fbash\u002Fcheck-prerequisites.sh --json --paths-only` from repo root **once** (combined `--json --paths-only` mode \u002F `-Json -PathsOnly`). Parse minimal JSON payload fields:\n   - `FEATURE_DIR`\n   - `FEATURE_SPEC`\n   - (Optionally capture `IMPL_PLAN`, `TASKS` for future chained flows.)\n   - If JSON parsing fails, abort and instruct user to re-run `\u002Fspeckit-specify` or verify feature branch environment.\n   - For single quotes in args like \"I'm Groot\", use escape syntax: e.g 'I'\\''m Groot' (or double-quote if possible: \"I'm Groot\").\n\n2. **IF EXISTS**: Load `.specify\u002Fmemory\u002Fconstitution.md` for project principles and governance constraints.\n\n3. Load the current spec file. Perform a structured ambiguity & coverage scan using this taxonomy. For each category, mark status: Clear \u002F Partial \u002F Missing. Produce an internal coverage map used for prioritization (do not output raw map unless no questions will be asked).\n\n   Functional Scope & Behavior:\n   - Core user goals & success criteria\n   - Explicit out-of-scope declarations\n   - User roles \u002F personas differentiation\n\n   Domain & Data Model:\n   - Entities, attributes, relationships\n   - Identity & uniqueness rules\n   - Lifecycle\u002Fstate transitions\n   - Data volume \u002F scale assumptions\n\n   Interaction & UX Flow:\n   - Critical user journeys \u002F sequences\n   - Error\u002Fempty\u002Floading states\n   - Accessibility or localization notes\n\n   Non-Functional Quality Attributes:\n   - Performance (latency, throughput targets)\n   - Scalability (horizontal\u002Fvertical, limits)\n   - Reliability & availability (uptime, recovery expectations)\n   - Observability (logging, metrics, tracing signals)\n   - Security & privacy (authN\u002FZ, data protection, threat assumptions)\n   - Compliance \u002F regulatory constraints (if any)\n\n   Integration & External Dependencies:\n   - External services\u002FAPIs and failure modes\n   - Data import\u002Fexport formats\n   - Protocol\u002Fversioning assumptions\n\n   Edge Cases & Failure Handling:\n   - Negative scenarios\n   - Rate limiting \u002F throttling\n   - Conflict resolution (e.g., concurrent edits)\n\n   Constraints & Tradeoffs:\n   - Technical constraints (language, storage, hosting)\n   - Explicit tradeoffs or rejected alternatives\n\n   Terminology & Consistency:\n   - Canonical glossary terms\n   - Avoided synonyms \u002F deprecated terms\n\n   Completion Signals:\n   - Acceptance criteria testability\n   - Measurable Definition of Done style indicators\n\n   Misc \u002F Placeholders:\n   - TODO markers \u002F unresolved decisions\n   - Ambiguous adjectives (\"robust\", \"intuitive\") lacking quantification\n\n   For each category with Partial or Missing status, add a candidate question opportunity unless:\n   - Clarification would not materially change implementation or validation strategy\n   - Information is better deferred to planning phase (note internally)\n\n4. Generate (internally) a prioritized queue of candidate clarification questions (maximum 5). Do NOT output them all at once. Apply these constraints:\n    - Maximum of 5 total questions across the whole session.\n    - Each question must be answerable with EITHER:\n       - A short multiple‑choice selection (2–5 distinct, mutually exclusive options), OR\n       - A one-word \u002F short‑phrase answer (explicitly constrain: \"Answer in \u003C=5 words\").\n    - Only include questions whose answers materially impact architecture, data modeling, task decomposition, test design, UX behavior, operational readiness, or compliance validation.\n    - Ensure category coverage balance: attempt to cover the highest impact unresolved categories first; avoid asking two low-impact questions when a single high-impact area (e.g., security posture) is unresolved.\n    - Exclude questions already answered, trivial stylistic preferences, or plan-level execution details (unless blocking correctness).\n    - Favor clarifications that reduce downstream rework risk or prevent misaligned acceptance tests.\n    - If more than 5 categories remain unresolved, select the top 5 by (Impact * Uncertainty) heuristic.\n\n5. Sequential questioning loop (interactive):\n    - Present EXACTLY ONE question at a time.\n    - For multiple‑choice questions:\n       - **Analyze all options** and determine the **most suitable option** based on:\n          - Best practices for the project type\n          - Common patterns in similar implementations\n          - Risk reduction (security, performance, maintainability)\n          - Alignment with any explicit project goals or constraints visible in the spec\n       - Present your **recommended option prominently** at the top with clear reasoning (1-2 sentences explaining why this is the best choice).\n       - Format as: `**Recommended:** Option [X] - \u003Creasoning>`\n       - Then render all options as a Markdown table:\n\n       | Option | Description |\n       |--------|-------------|\n       | A | \u003COption A description> |\n       | B | \u003COption B description> |\n       | C | \u003COption C description> (add D\u002FE as needed up to 5) |\n       | Short | Provide a different short answer (\u003C=5 words) (Include only if free-form alternative is appropriate) |\n\n       - After the table, add: `You can reply with the option letter (e.g., \"A\"), accept the recommendation by saying \"yes\" or \"recommended\", or provide your own short answer.`\n    - For short‑answer style (no meaningful discrete options):\n       - Provide your **suggested answer** based on best practices and context.\n       - Format as: `**Suggested:** \u003Cyour proposed answer> - \u003Cbrief reasoning>`\n       - Then output: `Format: Short answer (\u003C=5 words). You can accept the suggestion by saying \"yes\" or \"suggested\", or provide your own answer.`\n    - After the user answers:\n       - If the user replies with \"yes\", \"recommended\", or \"suggested\", use your previously stated recommendation\u002Fsuggestion as the answer.\n       - Otherwise, validate the answer maps to one option or fits the \u003C=5 word constraint.\n       - If ambiguous, ask for a quick disambiguation (count still belongs to same question; do not advance).\n       - Once satisfactory, record it in working memory (do not yet write to disk) and move to the next queued question.\n    - Stop asking further questions when:\n       - All critical ambiguities resolved early (remaining queued items become unnecessary), OR\n       - User signals completion (\"done\", \"good\", \"no more\"), OR\n       - You reach 5 asked questions.\n    - Never reveal future queued questions in advance.\n    - If no valid questions exist at start, immediately report no critical ambiguities.\n\n6. Integration after EACH accepted answer (incremental update approach):\n    - Maintain in-memory representation of the spec (loaded once at start) plus the raw file contents.\n    - For the first integrated answer in this session:\n       - Ensure a `## Clarifications` section exists (create it just after the highest-level contextual\u002Foverview section per the spec template if missing).\n       - Under it, create (if not present) a `### Session YYYY-MM-DD` subheading for today.\n    - Append a bullet line immediately after acceptance: `- Q: \u003Cquestion> → A: \u003Cfinal answer>`.\n    - Then immediately apply the clarification to the most appropriate section(s):\n       - Functional ambiguity → Update or add a bullet in Functional Requirements.\n       - User interaction \u002F actor distinction → Update User Stories or Actors subsection (if present) with clarified role, constraint, or scenario.\n       - Data shape \u002F entities → Update Data Model (add fields, types, relationships) preserving ordering; note added constraints succinctly.\n       - Non-functional constraint → Add\u002Fmodify measurable criteria in Success Criteria > Measurable Outcomes (convert vague adjective to metric or explicit target).\n       - Edge case \u002F negative flow → Add a new bullet under Edge Cases \u002F Error Handling (or create such subsection if template provides placeholder for it).\n       - Terminology conflict → Normalize term across spec; retain original only if necessary by adding `(formerly referred to as \"X\")` once.\n    - If the clarification invalidates an earlier ambiguous statement, replace that statement instead of duplicating; leave no obsolete contradictory text.\n    - Save the spec file AFTER each integration to minimize risk of context loss (atomic overwrite).\n    - Preserve formatting: do not reorder unrelated sections; keep heading hierarchy intact.\n    - Keep each inserted clarification minimal and testable (avoid narrative drift).\n\n7. Validation (performed after EACH write plus final pass):\n   - Clarifications session contains exactly one bullet per accepted answer (no duplicates).\n   - Total asked (accepted) questions ≤ 5.\n   - Updated sections contain no lingering vague placeholders the new answer was meant to resolve.\n   - No contradictory earlier statement remains (scan for now-invalid alternative choices removed).\n   - Markdown structure valid; only allowed new headings: `## Clarifications`, `### Session YYYY-MM-DD`.\n   - Terminology consistency: same canonical term used across all updated sections.\n\n8. Write the updated spec back to `FEATURE_SPEC`.\n\n9. **Re-validate Spec Quality Checklist** (if it exists):\n   - Check if `FEATURE_DIR\u002Fchecklists\u002Frequirements.md` exists.\n   - If it does NOT exist, skip this step silently.\n   - If it exists:\n     1. Read the checklist file.\n     2. Identify all GitHub task-list checkbox lines — lines matching `- [ ]`, `- [x]`, or `- [X]` (case-insensitive, tolerant of leading whitespace for nested items) outside of code fences. Ignore all other content (headings, notes, non-checkbox bullets, metadata).\n     3. For each checkbox line, record its current marker state (checked or unchecked) and item text into a before-snapshot list.\n     4. Re-evaluate each checkbox item against the **updated** spec (the version just saved in step 7).\n     5. For each checkbox item, update only if the checked\u002Funchecked state actually changes:\n        - If the item now passes and was unchecked: change `[ ]` to `[x]`.\n        - If the item now fails and was checked: change `[x]`\u002F`[X]` to `[ ]`.\n        - If the state is unchanged: leave the marker as-is (preserve existing case to avoid cosmetic diffs).\n     6. Save the updated checklist file. **Only toggle the `[ ]`\u002F`[x]` marker portion of checkbox lines whose state changed.** All other file content — headings, metadata, notes, line ordering, whitespace — must remain unchanged to avoid noisy diffs.\n     7. Compare the before-snapshot with the current state to compute three lists for the Completion Report:\n        - **Newly passing**: items that changed from unchecked to checked.\n        - **Regressions**: items that changed from checked to unchecked.\n        - **Still unchecked**: items that remain unchecked.\n     8. Record the before\u002Fafter pass counts as checked\u002Ftotal checkbox items (e.g., \"12\u002F16 → 15\u002F16 items passing\").\n\nBehavior rules:\n\n- If no meaningful ambiguities found (or all potential questions would be low-impact), respond: \"No critical ambiguities detected worth formal clarification.\" and suggest proceeding.\n- If spec file missing, instruct user to run `\u002Fspeckit-specify` first (do not create a new spec here).\n- Never exceed 5 total asked questions (clarification retries for a single question do not count as new questions).\n- Avoid speculative tech stack questions unless the absence blocks functional clarity.\n- Respect user early termination signals (\"stop\", \"done\", \"proceed\").\n- If no questions asked due to full coverage, output a compact coverage summary (all categories Clear) then suggest advancing.\n- If quota reached with unresolved high-impact categories remaining, explicitly flag them under Deferred with rationale.\n\nContext for prioritization: $ARGUMENTS\n\n## Mandatory Post-Execution Hooks\n\n**You MUST complete this section before reporting completion to the user.**\n\nCheck if `.specify\u002Fextensions.yml` exists in the project root.\n- If it does not exist, or no hooks are registered under `hooks.after_clarify`, skip to the Completion Report.\n- If it exists, read it and look for entries under the `hooks.after_clarify` key.\n- If the YAML cannot be parsed or is invalid, skip hook checking silently and continue to the Completion Report.\n- Filter out hooks where `enabled` is explicitly `false`. Treat hooks without an `enabled` field as enabled by default.\n- For each remaining hook, do **not** attempt to interpret or evaluate hook `condition` expressions:\n  - If the hook has no `condition` field, or it is null\u002Fempty, treat the hook as executable\n  - If the hook defines a non-empty `condition`, skip the hook and leave condition evaluation to the HookExecutor implementation\n- When constructing slash commands from hook command names, replace dots (`.`) with hyphens (`-`). For example, `speckit.git.commit` → `\u002Fspeckit-git-commit`.\n- For each executable hook, output the following based on its `optional` flag:\n  - **Mandatory hook** (`optional: false`) — **You MUST emit `EXECUTE_COMMAND:` for each mandatory hook**:\n    ```\n    ## Extension Hooks\n\n    **Automatic Hook**: {extension}\n    Executing: `\u002F{command}`\n    EXECUTE_COMMAND: {command}\n    ```\n  - **Optional hook** (`optional: true`):\n    ```\n    ## Extension Hooks\n\n    **Optional Hook**: {extension}\n    Command: `\u002F{command}`\n    Description: {description}\n\n    Prompt: {prompt}\n    To execute: `\u002F{command}`\n    ```\n\n## Completion Report\n\nReport completion (after questioning loop ends or early termination):\n- Number of questions asked & answered.\n- Path to updated spec.\n- Sections touched (list names).\n- Spec quality checklist status (if `FEATURE_DIR\u002Fchecklists\u002Frequirements.md` was re-validated): show before\u002Fafter pass counts (e.g., \"Spec Quality Checklist: 12\u002F16 → 15\u002F16 items passing\") and list any items that changed state — both newly checked (unchecked → checked) and any regressions (checked → unchecked). If any items remain unchecked, list them as areas needing attention.\n- Coverage summary table listing each taxonomy category with Status: Resolved (was Partial\u002FMissing and addressed), Deferred (exceeds question quota or better suited for planning), Clear (already sufficient), Outstanding (still Partial\u002FMissing but low impact).\n- If any Outstanding or Deferred remain, recommend whether to proceed to `\u002Fspeckit-plan` or run `\u002Fspeckit-clarify` again later post-plan.\n- Suggested next command.\n\n## Done When\n\n- [ ] Spec ambiguities identified and clarifications integrated into spec file\n- [ ] Spec quality checklist re-validated against updated spec (if `FEATURE_DIR\u002Fchecklists\u002Frequirements.md` exists)\n- [ ] Extension hooks dispatched or skipped according to the rules in Mandatory Post-Execution Hooks above\n- [ ] Completion reported to user with questions answered, sections touched, checklist status, and coverage summary\n",{"name":5,"metadata":24,"description":7,"argument-hint":27,"compatibility":28,"user-invocable":29,"disable-model-invocation":20},{"author":25,"source":26},"github-spec-kit","templates\u002Fcommands\u002Fclarify.md","Optional areas to clarify in the spec","Requires spec-kit project structure with .specify\u002F directory",true,"main","bc27dd4bb8be41d73b8d9f1dcf3433d914320221",".claude\u002Fskills\u002Fspeckit-clarify",1,"https:\u002F\u002Fgithub.com\u002FChanOoDev\u002Fspecflow-lite","https:\u002F\u002Fspecflow-lite.vercel.app","https:\u002F\u002Fgithub.com\u002FChanOoDev","Senior Software Engineer, DevOps & Solution Architect specializing in .NET 8, React, AWS, Kubernetes, CI\u002FCD, Clean Architecture, and AI-assisted SDLC.","2026-07-26 01:06:35",{"source":8,"skillName":5,"commands":40,"prompt":50,"zipAvailable":29},[41,44,47],{"tool":42,"command":43},"npx","npx skills add ChanOoDev\u002Fspecflow-lite --skill speckit-clarify",{"tool":45,"command":46},"bunx","bunx skills add ChanOoDev\u002Fspecflow-lite --skill speckit-clarify",{"tool":48,"command":49},"pnpm","pnpm dlx skills add ChanOoDev\u002Fspecflow-lite --skill speckit-clarify","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FChanOoDev\u002Fspecflow-lite\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fspeckit-clarify\u002FSKILL.md",[],[53,60,67,74,81,88],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M75RSGR7X43Z26GNJMZ6E0ZT","swarmvault","SwarmVault graph-first workflow. Use to read the compiled wiki and query the knowledge graph before broad file search.","https:\u002F\u002Fgithub.com\u002FChanOoDev\u002Fspecflow-lite\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fswarmvault\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M75RSCAF487YH4DTDVKP6AWD","speckit-taskstoissues","Convert existing tasks into actionable, dependency-ordered GitHub issues for the feature based on available design artifacts.","https:\u002F\u002Fgithub.com\u002FChanOoDev\u002Fspecflow-lite\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fspeckit-taskstoissues\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M75RSA5MJBCC9R73EHD8XE56","speckit-tasks","Generate an actionable, dependency-ordered tasks.md for the feature based on available design artifacts.","https:\u002F\u002Fgithub.com\u002FChanOoDev\u002Fspecflow-lite\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fspeckit-tasks\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M75RS7PMRNCVET5ZGTSJTRV3","speckit-specify","Create or update the feature specification from a natural language feature description.","https:\u002F\u002Fgithub.com\u002FChanOoDev\u002Fspecflow-lite\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fspeckit-specify\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M75RS2A0KCRX0BFX321YK0C5","speckit-plan","Execute the implementation planning workflow using the plan template to generate design artifacts.","https:\u002F\u002Fgithub.com\u002FChanOoDev\u002Fspecflow-lite\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fspeckit-plan\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M75RS04VN5AN8RB7JQ7KH1BA","speckit-implement","Execute the implementation plan by processing and executing all tasks defined in tasks.md","https:\u002F\u002Fgithub.com\u002FChanOoDev\u002Fspecflow-lite\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fspeckit-implement\u002FSKILL.md",[],[]]