用途:在项目中初始化 Spec-Driven Development(SDD)上下文。该技能作为执行者(非编排者)直接完成初始化,不启动子代理、不调用 delegate 或 task,除非遇到必须上报的真实阻塞。
主要能力:
- 检测项目上下文:读取 package.json、go.mod、pyproject.toml 等识别技术栈,检查 linter、测试框架、CI 等既有约定,以及架构模式。
- 构建技能注册表:扫描用户级 ~/.claude/skills/ 与项目级 .claude/skills/、skills/ 下的 /SKILL.md,跳过 sdd- 与 _shared,按名称去重(项目级优先),读取 frontmatter 触发词;同时检查 agents.md、AGENTS.md、CLAUDE.md、.cursorrules、GEMINI.md、copilot-instructions.md 等约定文件,若为索引文件则提取其引用的文件路径一并纳入。始终在项目根写入 .agent-config/skill-registry.md。
- 持久化项目上下文:磁盘优先,写入 docs/sdd/{project-name}/init-context.md,再在 Engram 可用时保存指针(topic_key 为 sdd-init/{project-name},支持 upsert)。
- 返回结构化摘要,包含项目名、技术栈、持久化方式、Engram ID、后续步骤(/sdd-explore 或 /sdd-propose)。
使用方式:以 "sdd init" 或 "iniciar sdd" 等触发词调用。Engram 可用时默认磁盘优先持久化;不可用时以内联方式返回检测到的上下文,磁盘产物仍会写入。
限制:不创建占位 spec 文件(spec 由 sdd-spec 在变更过程中创建);必须检测真实技术栈而非猜测;配置上下文不超过 10 行;无持久化时所有 SDD 产物在会话结束后丢失。