sdd-feature

Creates persistent acceptance contracts for HarmonyOS feature development and verification.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/YrracOwl/dsh-hmos-sidebar --skill sdd-feature-yrracowl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-feature
Source: https://github.com/YrracOwl/dsh-hmos-sidebar/tree/main/packages/dsh-hmos-sidebar/presets/native-harmonyos/skills/sdd-feature
Command: npx skills add https://github.com/YrracOwl/dsh-hmos-sidebar --skill sdd-feature-yrracowl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Cross-module HarmonyOS features and behavior changes often lose their agreed scope and acceptance criteria across sessions, reviews, and agent handoffs. This Skill establishes a single durable Markdown contract that records objectives, scope, non-goals, and acceptance scenarios so every session and reviewer verifies against the same success conditions. ## Core Features & Use Cases - Acceptance Contract Authoring: Creates one Markdown contract per feature at docs/feature-contracts/<slug>.md with Objective, Scope, Non-goals, Constraints, and evidence-based acceptance scenarios. - DSH-Native Integration: Reuses plan mode, todo_write, create_goal, subagents, and device tools instead of inventing a parallel process, with clear rules on when each mechanism applies. - Evidence-Driven Verification: Requires LSP checks after each source edit, code review against the contract, and UI or build evidence per scenario before marking the contract verified. - Cross-Session Continuity: Maintains an active-contract index in AGENTS.md so new sessions resume from the contract file rather than chat summaries. - Use Case: When adding a login feature spanning multiple ArkTS modules, create the contract, implement against it, capture s1-login.png evidence via UI verification, and mark the contract verified for later review. ## Quick Start Ask the agent to create an acceptance contract for the new HarmonyOS feature you are about to implement, including scope and acceptance scenarios.

Frequently Asked Questions about sdd-feature

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an acceptance contract for a HarmonyOS feature?

Create one Markdown file at docs/feature-contracts/<slug>.md containing Objective, Scope, Non-goals, Constraints, and acceptance scenarios with preconditions, actions, expected results, and evidence. Update its Status to verified only after all scenarios have matching evidence.

When should I use spec-driven development for HarmonyOS features?

Use it for new capabilities, cross-module changes, permission or data model changes, user-observable behavior changes, or when the user explicitly requests specs or acceptance criteria. Single-file local fixes and pure style adjustments do not need a contract.

Does this workflow replace plan mode and todo tracking in DSH?

No, it reuses DSH native mechanisms. Plan mode drafts scenarios before approval, todo_write tracks session tasks, and create_goal holds long-term objectives, while the contract file is the only persistent cross-session acceptance source.

How are acceptance scenarios verified on HarmonyOS devices?

UI scenarios are executed with dcli__ui_* tools using real-time layout data, saving evidence like s1-<name>.png screenshots. Non-UI scenarios use reproducible evidence such as build output, structured logs, or test results.

What are the limitations of the contract-based approach?

It does not suit trivial local fixes, forbids creating extra files like tasks.md or design.md by default, and requires explicit user request before invoking ralph. Scenarios must not contain fabricated control ids or coordinates.