projectops 3.0.194 → 3.0.195

package/README.md

@@ -7,7 +7,7 @@
 > 이슈 등록부터 커밋, 보고서, 배포까지. 개발자는 코드만 작성하세요.
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v3.0.193 (2026-07-08)
+## 최신 버전 : v3.0.194 (2026-07-08)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "3.0.194",
+  "version": "3.0.195",
   "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI (구 SUH-DEVOPS-TEMPLATE 마법사)",
   "keywords": [
     "devops",

package/src/commands/interactive.js

@@ -10,29 +10,32 @@ import { runFull } from "./full.js";
 import { runVersion } from "./version.js";
 import { runWorkflows } from "./workflows.js";
 import { runIssues } from "./issues.js";
+import { runSkills } from "./skills.js";
 import * as prompts from "../ui/prompts.js";
 
 const CANCEL = prompts.CANCEL;
 
 // io 기본값 = 실제 prompts. 테스트는 스텁 io 주입.
-export async function runInteractive(baseCtx, { cwd = process.cwd(), source = { type: "git" }, clock, io = prompts } = {}) {
+// skills = runSkills 주입 지점(테스트가 실제 IDE CLI를 안 건드리게). 기본은 실제 runSkills.
+export async function runInteractive(baseCtx, { cwd = process.cwd(), source = { type: "git" }, clock, io = prompts, skills = runSkills } = {}) {
   io.intro?.("projectops — 대화형 통합 마법사");
 
   // 1) 모드 선택
   const mode = await io.selectMode();
   if (mode === CANCEL || mode == null) { io.cancelMessage?.("설치를 취소했습니다."); return 0; }
 
-  // skills는 SP2-D 예정
-  if (mode === "skills") {
-    io.note?.("AI 스킬 설치는 아직 준비 중입니다 (곧 제공). 기존 template_integrator를 사용하세요.", "안내");
-    return 1;
-  }
-
   const tempDir = join(cwd, PATHS.tempDir);
   try {
     acquireTemplate({ tempDir, source });
     const templateVersion = readTemplateVersion(tempDir);
 
+    // skills 모드 — IDE 스킬 설치 (템플릿 통합 없음). 대화형으로 실행.
+    if (mode === "skills") {
+      await skills({ templateVersion, tempDir, interactive: true });
+      io.outro?.("AI 스킬 설치를 마쳤습니다.");
+      return 0;
+    }
+
     // issues 모드는 정보 수집 없이 바로 실행
     if (mode === "issues") {
       const ctx = createContext({ ...baseCtx, mode, force: true });

package/src/commands/skills.js

@@ -0,0 +1,82 @@
+// IDE Skills 설치 오케스트레이터 (.sh offer_ide_tools_install 등가).
+// 레지스트리 기반 — 개별 IDE를 이름으로 알지 않고 ADAPTERS 배열만 순회한다.
+// 새 IDE는 adapters/ 에 파일 추가 + registry 등록만으로 여기 수정 없이 동작한다.
+import { ADAPTERS } from "../core/ide/registry.js";
+import { versionTag } from "../core/ide/util.js";
+import { defaultIo } from "../core/ide/runner.js";
+import * as skillsPrompts from "../ui/skills-prompts.js";
+
+// 상태 수집 → [{adapter, status}]. optional 어댑터는 감지 불가(cliMissing)면 목록에서 제외.
+export function collectStatuses(io) {
+  const rows = [];
+  for (const a of ADAPTERS) {
+    const status = safe(() => a.detect(io), { installed: false, version: null, cliMissing: true });
+    if (a.optional && status.cliMissing) continue; // harness 등 조건부 항목은 불가 시 숨김
+    rows.push({ adapter: a, status });
+  }
+  return rows;
+}
+
+// 상태 표시 문자열 목록 (표시용, 순수).
+export function formatStatuses(rows, templateVersion) {
+  return rows.map(({ adapter, status }) => {
+    const label = adapter.label.padEnd(12);
+    if (status.cliMissing) return `${label}: ${status.note || "skill 미설치 (CLI 없음)"}`;
+    if (status.installed) {
+      const v = status.version ? ` (v${status.version})` : "";
+      return `${label}: skill 설치됨${v}${versionTag(status.version, templateVersion)}`;
+    }
+    return `${label}: ${status.note || "skill 미설치"}`;
+  });
+}
+
+// 대화형/비대화형 공통 진입. opts: {io, templateVersion, sourceSkillsDir, tempDir, interactive, ui}
+export async function runSkills(opts = {}) {
+  const io = opts.io || defaultIo();
+  const ui = opts.ui || skillsPrompts;
+  const ctx = { templateVersion: opts.templateVersion || "", sourceSkillsDir: opts.sourceSkillsDir, tempDir: opts.tempDir };
+
+  const rows = collectStatuses(io);
+  io.log("");
+  io.log("── IDE Skills 현재 상태 ──");
+  for (const line of formatStatuses(rows, ctx.templateVersion)) io.log(line);
+  io.log("");
+
+  // 비대화형: 감지된(=관리 가능) 모든 어댑터에 apply(설치/업데이트) 순차 실행.
+  if (!opts.interactive) {
+    for (const { adapter } of rows) safe(() => adapter.apply(io, ctx), false);
+    return 0;
+  }
+
+  // 대화형: 동작 선택 → IDE 멀티셀렉트 → 실행.
+  const action = await ui.selectAction();
+  if (action == null || action === skillsPrompts.CANCEL || action === "skip") {
+    io.log("IDE Skills는 변경하지 않고 넘어갑니다.");
+    return 0;
+  }
+
+  const choices = rows.map(({ adapter, status }) => ({
+    id: adapter.id, label: adapter.label,
+    disabled: action === "apply" && status.cliMissing, // 설치는 CLI 있어야, 제거는 무조건 후보
+  }));
+  const preselect = rows
+    .filter(({ status }) => action === "apply" ? !status.cliMissing : true)
+    .map(({ adapter }) => adapter.id);
+
+  const targets = await ui.selectTargets(choices, preselect, action);
+  if (targets == null || targets === skillsPrompts.CANCEL || !targets.length) {
+    io.log("선택한 IDE가 없어 건너뜁니다 (원할 때 다시 실행하세요).");
+    return 0;
+  }
+
+  const selected = new Set(targets);
+  for (const { adapter } of rows) {
+    if (!selected.has(adapter.id)) continue;
+    io.log("");
+    io.log(`[ ${adapter.label} ${action === "apply" ? "설치/업데이트" : "제거"} ]`);
+    safe(() => (action === "apply" ? adapter.apply(io, ctx) : adapter.remove(io, ctx)), false);
+  }
+  return 0;
+}
+
+function safe(fn, fallback) { try { return fn(); } catch { return fallback; } }

package/src/core/ide/adapter.js

@@ -0,0 +1,36 @@
+// IDE 어댑터 공통 계약 (확장 포인트의 핵심).
+//
+// 새 IDE(에디터/에이전트 CLI)를 지원하려면 이 shape을 만족하는 객체 하나를
+// src/core/ide/adapters/<name>.js 에 만들고 registry.js 배열에 추가하기만 하면 된다.
+// 오케스트레이터(commands/skills.js)는 어댑터의 필드만 알고, 개별 IDE 로직은 전혀 모른다.
+//
+// @typedef {Object} IdeStatus
+//   installed: boolean       설치돼 있는가
+//   version:   string|null   설치 버전(알 수 있으면)
+//   cliMissing: boolean      전용 CLI가 없어 설치 불가한 상태인가 (안내만 가능)
+//   note:      string        상태 표시줄에 덧붙일 짧은 메모(선택)
+//
+// @typedef {Object} IdeAdapter
+//   id:      string   내부 고유키 (예: "claude"). 라우팅·preselect에 사용
+//   label:   string   사람에게 보이는 이름 (예: "Claude Code")
+//   order:   number   상태·메뉴 표시 순서 (작을수록 먼저)
+//   detect(io): IdeStatus                     현재 설치 상태
+//   apply(io, ctx): boolean                   설치 또는 업데이트(멱등). 성공 true
+//   remove(io, ctx): boolean                  제거(미설치면 no-op, true)
+//   manualHint(io): string                    CLI 없을 때 보여줄 수동 설치 명령(선택)
+//
+// io = runner.defaultIo() 또는 테스트 stub: { which, run, home, log }
+// ctx = { templateVersion, sourceSkillsDir } — 버전 표기·Cursor 복사 소스 등 공용 컨텍스트
+//
+// 규칙:
+//  - apply/remove/detect는 예외를 던지지 않는다(내부에서 흡수). 실패는 log + false로 표현.
+//  - CLI 미존재는 에러가 아니라 cliMissing 상태 + manualHint로 안내한다.
+//  - 어댑터는 io를 통해서만 외부와 상호작용한다(직접 spawnSync/console 금지) — 테스트 가능성.
+
+// 어댑터가 최소 계약을 지키는지 개발 중 검증하는 헬퍼(런타임 방어).
+export function assertAdapter(a) {
+  for (const k of ["id", "label", "detect", "apply", "remove"]) {
+    if (a[k] == null) throw new Error(`IDE 어댑터 '${a?.id || "?"}'에 필수 필드 '${k}'가 없습니다`);
+  }
+  return a;
+}

package/src/core/ide/adapters/claude.js

@@ -0,0 +1,94 @@
+// Claude Code 어댑터 (.sh _manage_claude_section / _do_claude_plugin_install /
+// _remove_claude_section / _remove_claude_plugin_data 등가).
+// 마켓플레이스 Cassiiopeia/projectops, 플러그인 cassiiopeia@cassiiopeia-marketplace.
+import { join } from "node:path";
+import { existsSync, readdirSync, mkdirSync, cpSync, rmSync } from "node:fs";
+import { compareCacheName } from "../util.js";
+
+const MARKETPLACE = "Cassiiopeia/projectops";
+const PLUGIN = "cassiiopeia@cassiiopeia-marketplace";
+
+function detect(io) {
+  if (!io.which("claude")) return { installed: false, version: null, cliMissing: true, note: "CLI 없음" };
+  const r = io.run("claude", ["plugin", "list", "--json"]);
+  let scope = "", version = null;
+  try {
+    const arr = JSON.parse(r.stdout || "[]");
+    const list = Array.isArray(arr) ? arr : (arr.plugins || []);
+    for (const p of list) {
+      const name = String(p.name || p.id || "");
+      if (name.includes("cassiiopeia@") || name === "cassiiopeia") { scope = p.scope || ""; version = p.version || null; break; }
+    }
+  } catch { /* 파싱 실패 → 미설치 취급 */ }
+  return { installed: !!scope, version, cliMissing: false, scope };
+}
+
+function apply(io, ctx = {}) {
+  const st = detect(io);
+  if (st.cliMissing) { io.log(manualHint(io)); return false; }
+  if (st.installed) return update(io, st.scope);
+  return install(io, "user");
+}
+
+function install(io, scope = "user") {
+  io.log("Claude Code 마켓플레이스 등록 중...");
+  const add = io.run("claude", ["plugin", "marketplace", "add", MARKETPLACE]);
+  io.log(add.code === 0 ? "  마켓플레이스 등록 완료" : "  마켓플레이스 이미 등록되어 있거나 등록 생략");
+  io.log(`Claude Code 플러그인 설치 중 (scope: ${scope})...`);
+  const ins = io.run("claude", ["plugin", "install", PLUGIN, "--scope", scope]);
+  if (ins.code === 0) { io.log(`  Claude Code 플러그인 설치 완료 (scope: ${scope})`); return true; }
+  io.log(`  플러그인 설치 실패. 수동: claude plugin install ${PLUGIN} --scope ${scope}`);
+  return false;
+}
+
+function update(io, scope) {
+  const cacheRoot = join(io.home(), ".claude/plugins/cache/cassiiopeia-marketplace/cassiiopeia");
+  const oldCache = latestCacheDir(cacheRoot);
+  io.log("플러그인 업데이트 중...");
+  const up = io.run("claude", ["plugin", "update", PLUGIN, "--scope", scope]);
+  if (up.code !== 0) { io.log(`  업데이트 실패. 수동: claude plugin update ${PLUGIN} --scope ${scope}`); return false; }
+  io.log(`  업데이트 완료 (scope: ${scope})`);
+  migrateConfig(io, oldCache, latestCacheDir(cacheRoot));
+  return true;
+}
+
+function remove(io) {
+  const st = detect(io);
+  if (st.cliMissing || !st.installed) { io.log("  설치된 Claude Code 플러그인이 없어 건너뜁니다"); return true; }
+  io.log(`  제거할 대상: ${PLUGIN} (scope: ${st.scope})`);
+  const un = io.run("claude", ["plugin", "uninstall", PLUGIN, "--scope", st.scope]);
+  if (un.code === 0) { io.log("  플러그인 uninstall 완료"); removePluginData(io); return true; }
+  io.log(`  삭제 실패. 수동: claude plugin uninstall ${PLUGIN} --scope ${st.scope}`);
+  return false;
+}
+
+function manualHint() {
+  return `  💡 Claude Code 사용자: claude plugin marketplace add ${MARKETPLACE}\n     claude plugin install ${PLUGIN} --scope user`;
+}
+
+// ── 내부 헬퍼 ──
+function latestCacheDir(root) {
+  if (!existsSync(root)) return "";
+  const dirs = readdirSync(root, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort(compareCacheName);
+  return dirs.length ? join(root, dirs[dirs.length - 1]) : "";
+}
+function migrateConfig(io, oldCache, newCache) {
+  if (!oldCache || !newCache || oldCache === newCache) return;
+  const oldCfg = join(oldCache, "config"), newCfg = join(newCache, "config");
+  if (!existsSync(oldCfg)) return;
+  try {
+    mkdirSync(newCfg, { recursive: true });
+    let copied = 0;
+    for (const f of readdirSync(oldCfg)) if (f.endsWith(".json")) { cpSync(join(oldCfg, f), join(newCfg, f)); copied++; }
+    if (copied) io.log("  config.json 마이그레이션 완료 (이전 버전 설정 유지)");
+  } catch { /* 무해 */ }
+}
+function removePluginData(io) {
+  const dataDir = join(io.home(), ".claude/plugins/data", PLUGIN);
+  if (existsSync(dataDir)) { try { rmSync(dataDir, { recursive: true, force: true }); io.log("  플러그인 데이터(config) 삭제 완료"); } catch { /* 무해 */ } }
+}
+
+export const claudeAdapter = {
+  id: "claude", label: "Claude Code", order: 10,
+  detect, apply, remove, manualHint,
+};

package/src/core/ide/adapters/codex.js

@@ -0,0 +1,49 @@
+// Codex CLI 어댑터 (.sh _manage_codex_skills / _do_codex_marketplace_register /
+// _remove_codex_section 등가).
+// marketplace 등록/업그레이드가 주 경로. native ~/.agents/skills/cassiiopeia 심링크는 감지·제거에 사용.
+import { join } from "node:path";
+import { existsSync, lstatSync, rmSync } from "node:fs";
+
+const MARKETPLACE = "Cassiiopeia/projectops";
+const PLUGIN = "cassiiopeia";
+
+function nativeTarget(io) { return join(io.home(), ".agents/skills/cassiiopeia"); }
+
+function detect(io) {
+  const tgt = nativeTarget(io);
+  const nativeInstalled = existsSync(tgt);
+  if (nativeInstalled) return { installed: true, version: null, cliMissing: false, note: "native skills" };
+  if (!io.which("codex")) return { installed: false, version: null, cliMissing: true, note: "CLI 없음" };
+  return { installed: false, version: null, cliMissing: false, note: "설치 가능 (CLI 감지됨)" };
+}
+
+function apply(io) {
+  if (!io.which("codex")) { io.log(manualHint()); return false; }
+  io.log("Codex plugin marketplace 등록 중...");
+  const add = io.run("codex", ["plugin", "marketplace", "add", MARKETPLACE]);
+  io.log(add.code === 0 ? "  Codex marketplace 등록 완료" : "  Codex marketplace 이미 등록되어 있거나 등록 생략");
+  io.log("Codex plugin marketplace 업데이트 중...");
+  if (io.run("codex", ["plugin", "marketplace", "upgrade", PLUGIN]).code === 0) { io.log("  Codex marketplace 등록 완료 (/plugins 확인)"); return true; }
+  io.log(`  Codex marketplace 관리 오류 — 수동: codex plugin marketplace add ${MARKETPLACE}`);
+  return false;
+}
+
+function remove(io) {
+  const tgt = nativeTarget(io);
+  let removed = false;
+  if (existsSync(tgt) || isSymlink(tgt)) {
+    try { rmSync(tgt, { recursive: true, force: true }); io.log(`  Codex native skills 제거 완료 (${tgt})`); removed = true; } catch { /* 무해 */ }
+  }
+  if (!removed) io.log("  제거할 Codex skills가 없어 건너뜁니다");
+  if (io.which("codex")) io.log(`  marketplace 등록 해제는 수동: codex plugin marketplace remove ${PLUGIN}`);
+  return true;
+}
+
+function manualHint() { return `  💡 Codex CLI: codex plugin marketplace add ${MARKETPLACE}`; }
+
+function isSymlink(p) { try { return lstatSync(p).isSymbolicLink(); } catch { return false; } }
+
+export const codexAdapter = {
+  id: "codex", label: "Codex CLI", order: 40,
+  detect, apply, remove, manualHint,
+};

package/src/core/ide/adapters/cursor.js

@@ -0,0 +1,76 @@
+// Cursor 어댑터 (.sh _manage_cursor_section / _do_cursor_skills_copy /
+// _write_cursor_skills_meta / _remove_cursor_section 등가).
+// 마켓플레이스 없음 → ~/.cursor/skills/ 에 skills/ 폴더를 복사하고 meta.json으로 버전 추적.
+import { join } from "node:path";
+import { existsSync, readFileSync, mkdirSync, cpSync, rmSync, writeFileSync, readdirSync } from "node:fs";
+
+function metaPath(io) { return join(io.home(), ".cursor/skills/cursor-skills-meta.json"); }
+
+function detect(io) {
+  const mp = metaPath(io);
+  if (!existsSync(mp)) return { installed: false, version: null, cliMissing: false };
+  let version = null;
+  try {
+    const m = JSON.parse(readFileSync(mp, "utf8"));
+    version = m.version || null;
+  } catch { /* meta 손상 → 설치는 됐다고 봄 */ }
+  return { installed: true, version, cliMissing: false };
+}
+
+function apply(io, ctx = {}) {
+  const src = resolveSkillsSrc(ctx);
+  if (!src) { io.log("  설치할 스킬 소스를 찾지 못했습니다 (skills/ 폴더 필요)."); return false; }
+  const dest = join(io.home(), ".cursor/skills");
+  io.log("Cursor Skills 복사 중...");
+  try {
+    mkdirSync(dest, { recursive: true });
+    for (const e of readdirSync(src, { withFileTypes: true })) {
+      cpSync(join(src, e.name), join(dest, e.name), { recursive: true });
+    }
+    writeMeta(io, dest, ctx.templateVersion);
+    io.log(`  Cursor Skills 설치 완료 (${dest}/, v${ctx.templateVersion || "unknown"})`);
+    return true;
+  } catch {
+    io.log("  Cursor Skills 복사 실패 — skills/ 폴더를 확인하세요.");
+    return false;
+  }
+}
+
+function remove(io) {
+  const dir = join(io.home(), ".cursor/skills");
+  if (!existsSync(join(dir, "cursor-skills-meta.json"))) { io.log("  설치된 Cursor Skills가 없어 건너뜁니다"); return true; }
+  try { rmSync(dir, { recursive: true, force: true }); io.log(`  Cursor Skills 제거 완료 (${dir}/)`); return true; }
+  catch { io.log(`  Cursor Skills 제거 실패 — 수동 삭제: rm -rf ${dir}`); return false; }
+}
+
+function manualHint() {
+  return "  💡 Cursor: skills/ 폴더를 ~/.cursor/skills/ 로 복사하면 됩니다.";
+}
+
+// ── 헬퍼 ──
+// 스킬 소스: 다운로드된 템플릿(TEMP)/skills 우선, 없으면 로컬 skills/.
+function resolveSkillsSrc(ctx) {
+  const cands = [ctx.sourceSkillsDir, ctx.tempDir && join(ctx.tempDir, "skills"), "skills"].filter(Boolean);
+  for (const c of cands) if (existsSync(c)) return c;
+  return "";
+}
+
+function writeMeta(io, destDir, templateVersion) {
+  const version = templateVersion || "unknown";
+  const now = new Date().toISOString().replace(/\.\d+Z$/, "Z");
+  const file = join(destDir, "cursor-skills-meta.json");
+  let installedAt = now;
+  if (existsSync(file)) { try { installedAt = JSON.parse(readFileSync(file, "utf8")).installedAt || now; } catch { /* 무해 */ } }
+  const meta = {
+    name: "cassiiopeia", version, scope: "user",
+    source: "https://github.com/Cassiiopeia/projectops",
+    installPath: destDir, installedAt, lastUpdated: now,
+  };
+  mkdirSync(destDir, { recursive: true });
+  writeFileSync(file, JSON.stringify(meta, null, 2) + "\n");
+}
+
+export const cursorAdapter = {
+  id: "cursor", label: "Cursor", order: 20,
+  detect, apply, remove, manualHint,
+};

package/src/core/ide/adapters/gemini.js

@@ -0,0 +1,34 @@
+// Gemini CLI 어댑터 (.sh _manage_gemini_extension / _remove_gemini_section 등가).
+// extension install/update/uninstall. 마켓플레이스 대신 git URL 확장.
+const EXT = "cassiiopeia";
+const URL = "https://github.com/Cassiiopeia/projectops";
+
+function detect(io) {
+  if (!io.which("gemini")) return { installed: false, version: null, cliMissing: true, note: "CLI 없음" };
+  // .sh는 gemini 설치 상태를 정밀 조회하지 않고 "설치 가능"으로만 표기 → installed 미상.
+  return { installed: false, version: null, cliMissing: false, note: "설치 가능 (CLI 감지됨)" };
+}
+
+function apply(io) {
+  if (!io.which("gemini")) { io.log(manualHint()); return false; }
+  io.log("Gemini CLI extension 업데이트 중...");
+  if (io.run("gemini", ["extensions", "update", EXT]).code === 0) { io.log("  Gemini CLI extension 업데이트 완료"); return true; }
+  io.log("Gemini CLI extension 설치 중...");
+  if (io.run("gemini", ["extensions", "install", URL]).code === 0) { io.log("  Gemini CLI extension 설치 완료"); return true; }
+  io.log(`  Gemini extension 관리 오류 — 수동: gemini extensions install ${URL}`);
+  return false;
+}
+
+function remove(io) {
+  if (!io.which("gemini")) { io.log("  gemini CLI 미감지 — 건너뜁니다"); return true; }
+  if (io.run("gemini", ["extensions", "uninstall", EXT]).code === 0) { io.log("  Gemini CLI extension 제거 완료"); return true; }
+  io.log(`  제거할 Gemini extension이 없거나 실패 — 수동: gemini extensions uninstall ${EXT}`);
+  return true; // 미설치 제거는 실패로 보지 않음
+}
+
+function manualHint() { return `  💡 Gemini CLI: gemini extensions install ${URL}`; }
+
+export const geminiAdapter = {
+  id: "gemini", label: "Gemini CLI", order: 30,
+  detect, apply, remove, manualHint,
+};

package/src/core/ide/adapters/pi-common.js

@@ -0,0 +1,63 @@
+// PI 공용 경로·상태 로직 (pi 어댑터와 pi-harness 어댑터가 공유).
+// .sh: PI_PACKAGE_URL / _pi_is_installed / _pi_clone_dir / _pi_harness_loader_path /
+//      _pi_settings_path / _pi_harness_enabled 등가.
+import { join } from "node:path";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+
+export const PI_PACKAGE_URL = "https://github.com/Cassiiopeia/projectops";
+
+// 'pi list' 출력에 우리 레포가 잡히면 설치됨. (구 레포명·프로젝트명 모두 허용)
+export function piInstalled(io) {
+  if (!io.which("pi")) return false;
+  const r = io.run("pi", ["list"]); // pi는 일부 출력을 stderr로 보냄 → 둘 다 검사
+  const out = (r.stdout || "") + (r.stderr || "");
+  return /SUH-DEVOPS-TEMPLATE|projectops|cassiiopeia/i.test(out);
+}
+
+// pi 클론 경로(harness loader가 사는 곳). 레포명 변경 전 구 경로 하위호환.
+export function piCloneDir(io) {
+  const base = join(io.home(), ".pi/agent/git/github.com/Cassiiopeia");
+  const newDir = join(base, "projectops");
+  const oldDir = join(base, "SUH-DEVOPS-TEMPLATE");
+  return (!existsSync(newDir) && existsSync(oldDir)) ? oldDir : newDir;
+}
+
+export function harnessLoaderPath(io) { return join(piCloneDir(io), "harness/harness-loader.ts"); }
+export function piSettingsPath(io) { return join(io.home(), ".pi/agent/settings.json"); }
+
+// settings.json의 extensions 배열에 loader가 등록돼 있는가.
+export function harnessEnabled(io) {
+  const settings = piSettingsPath(io), loader = harnessLoaderPath(io);
+  if (!existsSync(settings)) return false;
+  try {
+    const s = JSON.parse(readFileSync(settings, "utf8"));
+    return Array.isArray(s.extensions) && s.extensions.includes(loader);
+  } catch { return false; }
+}
+
+// extensions에 loader 추가(중복 방지). {ok, reason}.
+export function harnessAdd(io) {
+  const settings = piSettingsPath(io), loader = harnessLoaderPath(io);
+  if (!existsSync(settings)) return { ok: false, reason: "no-settings" };
+  if (!existsSync(loader)) return { ok: false, reason: "no-loader" };
+  let s = {};
+  try { s = JSON.parse(readFileSync(settings, "utf8")); } catch { s = {}; }
+  const exts = (Array.isArray(s.extensions) ? s.extensions : []).filter(Boolean);
+  if (!exts.includes(loader)) exts.push(loader);
+  s.extensions = exts;
+  writeFileSync(settings, JSON.stringify(s, null, 2));
+  return { ok: true };
+}
+
+// extensions에서 loader 제거. {ok}.
+export function harnessRemove(io) {
+  const settings = piSettingsPath(io), loader = harnessLoaderPath(io);
+  if (!existsSync(settings)) return { ok: true };
+  let s;
+  try { s = JSON.parse(readFileSync(settings, "utf8")); } catch { return { ok: true }; }
+  if (Array.isArray(s.extensions)) {
+    s.extensions = s.extensions.filter((e) => e && e !== loader);
+    writeFileSync(settings, JSON.stringify(s, null, 2));
+  }
+  return { ok: true };
+}

package/src/core/ide/adapters/pi-harness.js

@@ -0,0 +1,48 @@
+// PI Persona Harness 어댑터 (.sh _pi_harness_toggle / _pi_harness_remove_only /
+// _pi_harness_add / _pi_harness_remove / _pi_harness_enabled 등가).
+// PI skill과 독립 — skill은 그대로 두고 harness 등록(settings.json extensions)만 켜고/끈다.
+import { existsSync } from "node:fs";
+import { harnessEnabled, harnessAdd, harnessRemove, harnessLoaderPath } from "./pi-common.js";
+
+// 이 어댑터는 "설치 가능" 여부가 pi 존재 + loader 파일 존재에 달림.
+function available(io) { return !!io.which("pi") && existsSync(harnessLoaderPath(io)); }
+
+function detect(io) {
+  if (!io.which("pi")) return { installed: false, version: null, cliMissing: true, note: "PI 없음" };
+  if (!existsSync(harnessLoaderPath(io))) return { installed: false, version: null, cliMissing: true, note: "loader 없음 (PI 설치 필요)" };
+  return { installed: harnessEnabled(io), version: null, cliMissing: false, note: harnessEnabled(io) ? "활성화됨" : "비활성화" };
+}
+
+// apply = harness 활성화 (skill은 안 건드림).
+function apply(io) {
+  if (!available(io)) { io.log("  harness loader가 없습니다 — 먼저 PI를 설치하세요."); return false; }
+  if (harnessEnabled(io)) { io.log("  Persona Harness: 이미 활성화됨 (유지)"); return true; }
+  const r = harnessAdd(io);
+  if (r.ok) { io.log("  Persona Harness 활성화 완료 — PI 재시작 후 적용됩니다."); return true; }
+  io.log(r.reason === "no-settings" ? "  PI settings.json이 없습니다 — PI를 한 번 실행한 뒤 다시 시도하세요."
+    : "  harness loader가 없습니다 — 먼저 PI 패키지를 설치/업데이트하세요.");
+  return false;
+}
+
+// remove = harness만 해제 (PI skill 보존).
+function remove(io) {
+  if (!harnessEnabled(io)) { io.log("  Persona Harness가 활성화돼 있지 않아 건너뜁니다"); return true; }
+  io.log("  PI skill은 그대로 두고 harness 등록만 해제합니다.");
+  harnessRemove(io);
+  io.log("  Persona Harness 해제 완료 — PI 재시작 후 적용됩니다.");
+  return true;
+}
+
+function manualHint() { return "  💡 PI Persona Harness: PI 설치 후 settings.json extensions 에 harness-loader.ts 등록"; }
+
+// harness 설명 (프롬프트에서 재사용).
+export const HARNESS_DESC = [
+  "Persona Harness는 PI가 대화를 시작할 때마다 '전문가 페르소나'와 'SDLC 워크플로우'를",
+  "시스템 프롬프트에 자동 주입하는 기능입니다 (skill과 독립적으로 켜고/끌 수 있음).",
+].join("\n");
+
+export const piHarnessAdapter = {
+  id: "pi-harness", label: "PI Persona Harness", order: 60,
+  optional: true, // 감지된 경우에만 메뉴 노출 (registry 순회 시 참고)
+  detect, apply, remove, manualHint,
+};

package/src/core/ide/adapters/pi.js

@@ -0,0 +1,45 @@
+// PI 패키지 어댑터 (.sh _manage_pi_section / _remove_pi_section 등가).
+// pi install/update/remove. skill은 복사되지 않고 pi가 startup마다 스캔 → 설치 검증은 'pi list'.
+import { PI_PACKAGE_URL, piInstalled, harnessEnabled, harnessRemove } from "./pi-common.js";
+
+function detect(io) {
+  if (!io.which("pi")) return { installed: false, version: null, cliMissing: true, note: "CLI 없음" };
+  return { installed: piInstalled(io), version: null, cliMissing: false };
+}
+
+function apply(io) {
+  if (!io.which("pi")) { io.log(manualHint()); return false; }
+  if (piInstalled(io)) {
+    io.log("PI 패키지 업데이트 중...");
+    if (io.run("pi", ["update", PI_PACKAGE_URL]).code !== 0) io.run("pi", ["install", PI_PACKAGE_URL]);
+  } else {
+    io.log("PI 패키지 설치 중...");
+    io.run("pi", ["install", PI_PACKAGE_URL]);
+  }
+  if (piInstalled(io)) {
+    io.log("  PI 패키지 설치 / 업데이트 완료");
+    io.log("  → 'pi' 재실행 후 'pi list' 로 확인, 채팅창에서 /suh-analyze 등 호출");
+    return true;
+  }
+  io.log(`  PI 설치/업데이트 실패 — 수동: pi install ${PI_PACKAGE_URL}`);
+  return false;
+}
+
+function remove(io) {
+  if (!io.which("pi")) { io.log("  pi CLI 미감지 — 건너뜁니다"); return true; }
+  if (!piInstalled(io)) { io.log("  설치된 PI 패키지가 없어 건너뜁니다"); return true; }
+  io.log(`  pi remove ${PI_PACKAGE_URL}`);
+  io.run("pi", ["remove", PI_PACKAGE_URL]);
+  if (piInstalled(io)) io.log("  제거 후에도 패키지가 남아있습니다 — 'pi list'로 확인하세요.");
+  else io.log("  PI 패키지 제거 완료");
+  // package 클론이 사라지면 harness loader 경로가 허공을 가리킴 → 함께 해제
+  if (harnessEnabled(io)) { io.log("  Persona Harness 등록도 함께 해제됩니다."); harnessRemove(io); }
+  return true;
+}
+
+function manualHint() { return `  💡 PI: pi install ${PI_PACKAGE_URL}`; }
+
+export const piAdapter = {
+  id: "pi", label: "PI", order: 50,
+  detect, apply, remove, manualHint,
+};

package/src/core/ide/registry.js

@@ -0,0 +1,27 @@
+// IDE 어댑터 레지스트리 — 유일한 확장 지점.
+//
+// 새 IDE를 지원하려면:
+//   1) src/core/ide/adapters/<name>.js 에 어댑터 객체(adapter.js 계약) 작성
+//   2) 아래에 import 추가하고 ADAPTERS 배열에 넣기
+// 오케스트레이터·프롬프트·index 라우팅은 이 배열만 순회하므로 다른 파일은 손대지 않는다.
+import { assertAdapter } from "./adapter.js";
+import { claudeAdapter } from "./adapters/claude.js";
+import { cursorAdapter } from "./adapters/cursor.js";
+import { geminiAdapter } from "./adapters/gemini.js";
+import { codexAdapter } from "./adapters/codex.js";
+import { piAdapter } from "./adapters/pi.js";
+import { piHarnessAdapter } from "./adapters/pi-harness.js";
+
+// order 오름차순 정렬 + 계약 검증.
+export const ADAPTERS = [
+  claudeAdapter,
+  cursorAdapter,
+  geminiAdapter,
+  codexAdapter,
+  piAdapter,
+  piHarnessAdapter,
+].map(assertAdapter).sort((a, b) => (a.order ?? 100) - (b.order ?? 100));
+
+export function adapterById(id) {
+  return ADAPTERS.find((a) => a.id === id) || null;
+}

package/src/core/ide/runner.js

@@ -0,0 +1,59 @@
+// 외부 CLI 실행·감지 래퍼 (.sh command -v / CLI 호출 등가).
+// 전부 주입 가능 — 테스트는 stub runner/which/home 를 넘겨 실제 CLI 없이 검증한다.
+import { spawnSync } from "node:child_process";
+import { delimiter, join } from "node:path";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+
+// which(cmd) → 실행 파일 절대경로 or null. PATH를 직접 스캔 (execa 없이 내장만).
+// Windows는 PATHEXT 확장자(.cmd/.exe/.bat 등)까지 시도.
+export function which(cmd) {
+  const paths = (process.env.PATH || "").split(delimiter).filter(Boolean);
+  const exts = process.platform === "win32"
+    ? (process.env.PATHEXT || ".COM;.EXE;.BAT;.CMD").split(";").filter(Boolean)
+    : [""];
+  for (const dir of paths) {
+    for (const ext of exts) {
+      const full = join(dir, cmd + ext);
+      if (existsSync(full)) return full;
+    }
+  }
+  return null;
+}
+
+// run(cmd, args, opts) → {code, stdout, stderr}. 동기 실행.
+// opts.cwd, opts.env 지원. 실행 자체 실패(파일 없음 등)면 code=127.
+//
+// Windows: claude/gemini/codex/pi 는 .cmd/.ps1 셸 런처라 spawnSync가 직접 못 띄운다.
+// shell:true + args 배열은 DEP0190(인자 미이스케이프) 경고 → cmd.exe에 안전 인용한 단일
+// 명령 문자열을 넘긴다. args는 우리가 만든 하드코딩 값 + URL/scope뿐이라 신뢰 가능하지만,
+// 그래도 큰따옴표로 감싸 공백·특수문자를 방어한다.
+export function run(cmd, args = [], opts = {}) {
+  const common = { cwd: opts.cwd, env: opts.env || process.env, encoding: "utf8", windowsHide: true };
+  let r;
+  if (process.platform === "win32") {
+    const line = [cmd, ...args].map(winQuote).join(" ");
+    r = spawnSync(line, { ...common, shell: true });
+  } else {
+    r = spawnSync(cmd, args, common); // POSIX는 shell 불필요(안전)
+  }
+  if (r.error) return { code: 127, stdout: "", stderr: String(r.error.message || r.error) };
+  return { code: r.status ?? 0, stdout: r.stdout || "", stderr: r.stderr || "" };
+}
+
+// cmd.exe용 인용: 이미 안전한 토큰(영숫자·경로·URL 문자)이면 그대로, 아니면 "..." 로 감싸고 내부 " 이스케이프.
+function winQuote(s) {
+  if (/^[A-Za-z0-9_./:@=-]+$/.test(s)) return s;
+  return '"' + String(s).replace(/"/g, '\\"') + '"';
+}
+
+// IDE 실행 컨텍스트 기본값. 테스트는 이 shape을 스텁으로 대체.
+//   which(cmd)→path|null, run(cmd,args)→{code,stdout,stderr}, home()→string, log(msg)
+export function defaultIo() {
+  return {
+    which,
+    run,
+    home: () => homedir(),
+    log: (msg) => console.error(msg), // .sh는 안내를 stderr로 출력
+  };
+}

package/src/core/ide/util.js

@@ -0,0 +1,18 @@
+// IDE 어댑터 공용 유틸.
+
+// sort -V 근사: 버전형 디렉토리/문자열 비교기. "3.0.9" < "3.0.10" 을 올바로 정렬.
+export function compareCacheName(a, b) {
+  const pa = a.split(".").map((n) => parseInt(n, 10) || 0);
+  const pb = b.split(".").map((n) => parseInt(n, 10) || 0);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const d = (pa[i] || 0) - (pb[i] || 0);
+    if (d) return d;
+  }
+  return a.localeCompare(b);
+}
+
+// 상태 → 표시 태그 (" ✓ 최신" / " → 업데이트 가능: vX"). templateVersion 없으면 빈 문자열.
+export function versionTag(installedVersion, templateVersion) {
+  if (!templateVersion || !installedVersion) return "";
+  return installedVersion === templateVersion ? " ✓ 최신" : ` → 업데이트 가능: v${templateVersion}`;
+}

package/src/index.js

@@ -13,6 +13,7 @@ import { runVersion } from "./commands/version.js";
 import { runWorkflows } from "./commands/workflows.js";
 import { runIssues } from "./commands/issues.js";
 import { runInteractive } from "./commands/interactive.js";
+import { runSkills } from "./commands/skills.js";
 
 // 결정적 UTC 타임스탬프 (주입 가능 — 테스트/골든용)
 function utcNow(date = new Date()) {
@@ -35,10 +36,18 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
   }
   if (opts.help) { console.log(HELP_TEXT); return 0; }
 
-  // skills 모드는 IDE 설치 전용 (SP2-D)
+  // skills 모드 — IDE 스킬 설치/업데이트/제거 (템플릿 통합 없음).
+  // Cursor 복사용 skills/ 소스가 필요하므로 템플릿을 획득한 뒤 실행한다.
   if (opts.mode === "skills") {
-    console.error("skills 모드는 아직 지원되지 않습니다 (SP2-D 예정). 기존 template_integrator를 사용하세요.");
-    return 1;
+    const tempDir = join(cwd, PATHS.tempDir);
+    const interactive = !opts.force && process.stdout.isTTY;
+    try {
+      acquireTemplate({ tempDir, source });
+      const templateVersion = readTemplateVersion(tempDir);
+      return await runSkills({ templateVersion, tempDir, interactive });
+    } finally {
+      remove(tempDir);
+    }
   }
   // 대화형 모드 — 인자 없이 실행 or --mode interactive
   if (opts.mode === "interactive") {

package/src/ui/skills-prompts.js

@@ -0,0 +1,37 @@
+// IDE Skills 대화형 프롬프트 (.sh 라우터 choose_menu 등가) — @clack/prompts 기반.
+import * as clack from "@clack/prompts";
+
+export const CANCEL = Symbol("cancel");
+const wrap = (v) => (clack.isCancel(v) ? CANCEL : v);
+
+// 동작 선택: 설치/업데이트 · 제거 · 그대로. 취소=skip.
+export async function selectAction() {
+  const v = await clack.select({
+    message: "AI 스킬을 어떻게 할까요?",
+    options: [
+      { value: "apply", label: "설치 / 업데이트 — 최신 상태로 맞추기" },
+      { value: "remove", label: "제거 — 설치된 스킬 삭제하기" },
+      { value: "skip", label: "그대로 두기" },
+    ],
+  });
+  const w = wrap(v);
+  return w === CANCEL ? "skip" : w;
+}
+
+// IDE 멀티셀렉트. choices=[{id,label,disabled}], preselect=[id...], action.
+export async function selectTargets(choices, preselect = [], action = "apply") {
+  const options = choices.map((c) => ({
+    value: c.id,
+    label: c.label + (c.disabled ? " (미감지)" : ""),
+    hint: c.disabled ? "CLI 없음" : undefined,
+  }));
+  const v = await clack.multiselect({
+    message: `${action === "apply" ? "설치 / 업데이트" : "제거"}할 IDE를 고르세요 (Space 토글, Enter 확정)`,
+    options,
+    initialValues: preselect,
+    required: false,
+  });
+  return wrap(v);
+}
+
+export function note(text, title) { clack.note(text, title); }