sdd-init
Trigger: sdd init, iniciar sdd, openspec init. Initialize SDD context, testing capabilities, registry, and persistence.
- License 许可
- MIT
- 最近更新
- 2026-08-26
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- sdd-init
- license
- MIT
- metadata
- { "author": "gentleman-programming", "version": "3.0", "delegate_only": true }
- description
- Trigger: sdd init, iniciar sdd, openspec init. Initialize SDD context, testing capabilities, registry, and persistence.
- user-invocable
- false
- disable-model-invocation
- true
02 资源文件 1
- 参考文档references/init-details.md4.5 KB
03 SKILL.md 正文
ORCHESTRATOR GATE: If you loaded this skill via the
skill()tool, you are the ORCHESTRATOR — STOP. Do NOT execute these instructions inline. Delegate to the dedicatedsdd-initsub-agent using your platform's delegation primitive (e.g.,task(...), sub-agent invocation, etc.). This skill is for EXECUTORS only.
Activation Contract
Run this phase when the orchestrator/user asks to initialize SDD in a project. You are the phase executor: do the work yourself, do not delegate, and do not behave like the orchestrator.
Hard Rules
- Detect the real stack, conventions, architecture, testing tools, and persistence mode; never guess.
- In
engrammode, do not createopenspec/. - In
openspecmode, follow../_shared/openspec-convention.mdand write file artifacts. - In
hybridmode, write both openspec files and Engram observations. - Always persist testing capabilities separately as
sdd/{project}/testing-capabilitiesoropenspec/config.yamltesting:. - Always build
.atl/skill-registry.md; also saveskill-registryto Engram when available. - Use
capture_prompt: falsefor automated SDD/config saves when supported; omit it if the tool schema lacks it. - If
openspec/already exists, report what exists and ask before updating it. - Classify detected knowledge on the stability axis and persist each tier with its own review cadence — see
ck:context-architecture→ The Second Axis: Knowledge Stability. You own S0 (essence, ~500 tk) and S1 (architecture, ~1000 tk) only. Never write S2 (owned byck:adr) or S3 (graduated fromck:impl-tracking). - Respect the tier budgets. If detected context exceeds them, prune to what a new contributor could not learn by reading the code — do not expand the budget.
Decision Gates
| Input | Action |
|---|---|
mode=engram |
Save context and capabilities to Engram only. |
mode=openspec |
Create/update openspec bootstrap files only. |
mode=hybrid |
Do both Engram and openspec persistence. |
mode=none |
Return detected context only; write no SDD artifacts except registry if required. |
| strict TDD marker/config found | Use that value. |
| no marker/config but test runner exists | Default strict_tdd: true. |
| no test runner | Set strict_tdd: false and explain unavailable. |
Execution Steps
- Inspect project files (
package.json,go.mod,pyproject.toml, CI, lint/test config) and summarize stack/conventions. - Detect test runner, test layers, coverage, linter, type checker, and formatter.
- Resolve Strict TDD from agent marker,
openspec/config.yaml, detected runner fallback, or no-runner fallback. - Initialize persistence for the resolved mode.
- Build
.atl/skill-registry.mdusing the skill-registry scan rules. - Persist testing capabilities and project context.
- Return the structured initialization envelope.
Output Contract
Return status, executive_summary, artifacts, next_recommended, and risks. Include project, stack, persistence mode, Strict TDD status, testing capability table, saved observation IDs/paths, registry path, and next /sdd-explore or /sdd-new step.
References
- references/init-details.md — detection checklist, Engram payloads, config skeleton, and output templates.
../_shared/engram-convention.md— Engram artifact naming.../_shared/openspec-convention.md— openspec layout and rules.
04 同仓库更多 Skills
zustand-5
Zustand 5 state management patterns. Trigger: When managing React state with Zustand.
zod-4
Zod 4 schema validation patterns. Trigger: When using Zod for validation - breaking changes from v3.
x-bookmark-quote-posts
Workflow para revisar bookmarks de X/Twitter y convertirlos en drafts de quote posts. Accede a la sección de bookmarks vía browser headless, extrae posts recientes, y genera drafts con voz personal del usuario. No publica ni muta X — solo genera contenido para revisión. Trigger: X bookmarks, Twitter bookmarks, quote posts, bookmark automation, crear quote posts, revisar bookmarks, growth content X.
writing-skills
Use when creating new skills, editing existing skills, or verifying skills work before deployment
writing-plans
Use when you have a spec or requirements for a multi-step task, before touching code
work-unit-commits
Plan commits as reviewable work units. Trigger: implementation, commit splitting, chained PRs, or keeping tests and docs with code.