specdo 1.0.2

package/dist/core/skill-content/workflow-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-content.js","sourceRoot":"","sources":["../../../src/core/skill-content/workflow-content.ts"],"names":[],"mappings":"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"}

package/dist/core/skill-exporter.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Skill Exporter — OpenSpec core-compatible progressive disclosure
+ *
+ * 把 specdo 的 core 工作流导出为 progressive-disclosure SKILL.md 包，
+ * 投递到各 AI 工具的 skill 目录。
+ *
+ * 每个 skill 包结构：
+ *   <name>/
+ *   ├── SKILL.md           # 精炼指引（agent 默认加载）
+ *   └── references/        # 按需加载的详细参考
+ *       ├── REFERENCE.md   # workflow / protocol
+ *       ├── EXAMPLES.md    # workflow / protocol
+ *       ├── DOMAIN_*.md    # specdo 增强的 domain guidance
+ *       ├── PROTOCOL_*.md  # specdo 增强的 protocol guidance
+ *       └── ARCHIVE_*.md   # 收尾/归档 gate
+ *
+ * 关键不变量：
+ *   - 导出入口始终保持 OpenSpec core 范式：workflow skill 是一等公民，
+ *     domain/protocol 仅作为 workflow references 的增强材料
+ *   - 内容来源全部为运行时数据（DomainModule / Protocol / WORKFLOW_SKILLS
+ *     + 手写的 CROSS_DOMAIN / PROTOCOL_EXAMPLES），不依赖模板文件
+ *   - SKILL.md 严格遵循 Anthropic 标准：YAML frontmatter（name + description）
+ *     + 正文 markdown
+ *   - skill name ≤ 64 字符，仅 lowercase 字母数字短横线（Anthropic 规范）
+ *   - SKILL.md 推荐 ≤ 500 行（agentskills.io）；progressive disclosure 让
+ *     大量内容下沉 references/，单文件保持精炼
+ *
+ * 输出 5 个 core workflow skill：
+ *   - specdo-explore
+ *   - specdo-propose
+ *   - specdo-apply
+ *   - specdo-sync
+ *   - specdo-archive
+ *
+ * domain / protocol 不再作为独立 skill 导出，避免 agent 从工作流主轴偏航。
+ */
+import type { DomainModule, Protocol } from '../domains/types.js';
+/**
+ * 支持的 AI agent 工具。每家都有自己的 canonical skill 目录约定。
+ *
+ * 来源（截至 2026-06）：
+ *   - claude   → Anthropic 官方 SKILL.md 标准
+ *   - qoder    → docs.qoder.com/extensions/skills
+ *   - cursor   → cursor.com/docs/skills（2.4+ 原生）
+ *   - cline    → docs.cline.bot/customization/skills（experimental）
+ *   - codex    → developers.openai.com/codex/skills
+ *   - goose    → goose-docs.ai/.../using-skills
+ *   - kilo     → kilo.ai/docs/customize/skills
+ *   - opencode → SKILL.md 标准；Claude Code 兼容
+ *   - universal→ 社区开放标准 .agents/skills/（Cursor/Goose/Kilo/Roo 兼容）
+ *
+ * 排除项（已审计）：
+ *   - Continue.dev   不支持目录式 skill
+ *   - Windsurf       仅有 .windsurfrules（rules 注入），与原则冲突
+ *   - Aider          无明确目录约定
+ */
+export type AgentName = 'claude' | 'qoder' | 'cursor' | 'cline' | 'codex' | 'goose' | 'kilo' | 'opencode' | 'universal';
+export type ExportScope = 'project' | 'user';
+export interface ExportOptions {
+    /** 项目级导出时的工作目录；用户级导出时仅用于日志显示 */
+    cwd: string;
+    /** 目标 agent 列表 */
+    agents: AgentName[];
+    /** 导出位置：project = <cwd>/.<agent>/skills，user = ~/.<agent>/skills */
+    scope: ExportScope;
+}
+export interface ExportResult {
+    /** 写入的绝对路径列表（按写入顺序；含 SKILL.md 与所有 references/*.md） */
+    filesWritten: string[];
+    /** 导出的 core workflow skill 包数量。agents 为空时返回 0 */
+    skillCount: number;
+    /** 实际命中的 agent（去重） */
+    agents: AgentName[];
+    /** 跳过原因（当前实现总是覆盖，保留扩展） */
+    skipped: string[];
+    /** 已清理的旧版 specdo-* skill 目录绝对路径（不再属于当前导出列表） */
+    pruned: string[];
+}
+interface AgentSpec {
+    name: AgentName;
+    homeSubdir: string;
+    projectSubdir: string;
+}
+/**
+ * 8 家 canonical AI 工具（不含 universal escape hatch）。
+ * 供文档、测试、拼写纠错限定在已审计的工具列表上。
+ */
+export declare const ALL_AGENTS: AgentName[];
+/** Universal escape hatch 单独曝露，需要与 ALL_AGENTS 区分对待。 */
+export declare const UNIVERSAL_AGENT: AgentName;
+export declare function isAgentName(value: string): value is AgentName;
+/**
+ * 计算两个字符串的 Levenshtein 距离。用于拼写纠错提示。
+ */
+export declare function levenshtein(a: string, b: string): number;
+/**
+ * 在 ALL_AGENTS 中寻找与输入最接近的 canonical agent 名。
+ * 近似阈值：Levenshtein 距离 ≤ 1。
+ * 不返回 'universal'：它是 escape hatch，不适合作为拼写纠错候选。
+ */
+export declare function suggestAgents(input: string): AgentName[];
+export interface SkillDoc {
+    /** kebab-case 名称，将作为目录名 */
+    name: string;
+    /** 用于 frontmatter；驱动 agent auto-invoke */
+    description: string;
+    /** SKILL.md 正文 markdown（不含 frontmatter） */
+    body: string;
+    /**
+     * 可选的 references 文件：键为文件名（如 'REFERENCE.md'），值为完整内容。
+     * 写入路径：<skillDir>/references/<filename>
+     */
+    references?: Record<string, string>;
+}
+/**
+ * 渲染 SKILL.md 完整内容（含 frontmatter）。
+ *
+ * description 内的双引号被替换为单引号，避免破坏 YAML 字符串；
+ * 空白序列被压缩，让 YAML 解析器 / agent 列表视图更友好。
+ */
+export declare function renderSkillFile(doc: SkillDoc): string;
+/** 构造工作流 skill 文档（直接取自 workflow-content.ts，并注入 core-compatible 增强 references） */
+export declare function buildWorkflowSkill(slug: string): SkillDoc;
+/**
+ * 构造领域 skill 文档（progressive disclosure）。
+ *
+ * SKILL.md：领域描述 + 全部 signals（agent auto-trigger 需要）+ 各阶段前若干条精华
+ * references/CHECKLIST.md：完整 design.checklist + implement.focusAreas + verify.checklist
+ * references/PATTERNS.md：完整 patterns / antiPatterns（设计阶段 + 实施阶段）
+ * references/CROSS_DOMAIN.md：手写的跨领域协同说明（取自 cross-domain.ts）
+ */
+export declare function buildDomainSkill(domain: DomainModule): SkillDoc;
+/**
+ * 构造协议 skill 文档（progressive disclosure）。
+ *
+ * SKILL.md：goal + trigger / suppression / doNotUseWhen + workflow step 标题 + stop conditions
+ * references/WORKFLOW.md：完整 workflow 各 step 的 actions / exitCriteria / loopBackTo
+ * references/OUTPUT_CONTRACT.md：outputContract + severityLevels + prohibitions + artifactChecklists + generalConstraints
+ * references/EXAMPLES.md：手写 do/don't 代码示例（取自 protocol-examples.ts）
+ */
+export declare function buildProtocolSkill(protocol: Protocol): SkillDoc;
+/** 返回所有应被导出的 SkillDoc */
+export declare function collectAllSkills(): SkillDoc[];
+declare function resolveAgentRoot(agent: AgentName, scope: ExportScope, cwd: string): string;
+/**
+ * 把单个 SkillDoc 写入指定 agent 根目录。
+ *
+ * 落盘结构：
+ *   <root>/<name>/SKILL.md
+ *   <root>/<name>/references/<filename>   （每个 references 条目一个文件）
+ *
+ * 写入语义：
+ *   - 目录不存在则递归创建
+ *   - 同名文件直接覆盖（specdo 视 skill 文件为派生产物）
+ */
+declare function writeSkillDoc(doc: SkillDoc, root: string): string[];
+/**
+ * 清理 agent skill 根目录下以 `specdo-` 开头但不再属于当前导出列表的旧目录。
+ *
+ * 场景：skill 从 12 个缩减为 5 个后，用户重新 `specdo init` 时，旧的
+ * `specdo-domain-*` 和 `specdo-protocol-*` 目录会残留，导致 AI 工具同时
+ * 加载新 workflow skill 和旧 domain/protocol skill，产生冲突指令。
+ *
+ * 安全约束：
+ *   - 仅删除以 `specdo-` 开头的子目录（不碰用户自定义 skill）
+ *   - 跳过当前导出列表中存在的目录名
+ *   - 目录不存在时静默跳过
+ */
+declare function removeOrphanSpecdoSkills(root: string, currentSkillNames: Set<string>): string[];
+/**
+ * 主导出函数：把 5 个 core workflow skill 写到指定 agent 的指定 scope 目录。
+ *
+ * 写入前会清理 agent skill 根目录下以 `specdo-` 开头但不再属于当前导出列表
+ * 的旧目录避免 AI 工具加载冲突指令。
+ */
+export declare function exportSkills(options: ExportOptions): ExportResult;
+/** 导出供测试与命令层引用 */
+export declare const __INTERNAL: {
+    AGENT_REGISTRY: Record<AgentName, AgentSpec>;
+    WORKFLOW_SKILL_NAMES: string[];
+    resolveAgentRoot: typeof resolveAgentRoot;
+    writeSkillDoc: typeof writeSkillDoc;
+    removeOrphanSpecdoSkills: typeof removeOrphanSpecdoSkills;
+};
+export {};
+//# sourceMappingURL=skill-exporter.d.ts.map

package/dist/core/skill-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-exporter.d.ts","sourceRoot":"","sources":["../../src/core/skill-exporter.ts"],"names":[],"mappings":"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"}