projectops 4.71.3 → 4.73.0

package/README.md

@@ -11,7 +11,7 @@
 **Status: actively maintained.** npm `latest` is exactly what is on the `main` branch; work in progress on `develop` is never published. Versions can still ship several times a day. To stay on a version you have tested, run `npx projectops@<version>` ([releases](https://github.com/Cassiiopeia/projectops/releases)).
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## Latest version : v4.71.2 (2026-10-21)
+## Latest version : v4.72.0 (2026-10-22)
 
 [View full version history](CHANGELOG.md)
 
@@ -51,7 +51,7 @@ This project automates your development workflow on two axes.
 | Format every issue by hand | `/pro-github` writes and files an issue from the standard template in one step |
 | Copy the issue URL into commit messages | `/pro-commit` completes the message from the issue context, in your own style |
 | Write PR descriptions and reports by hand | `/pro-report` analyzes the git diff and generates one |
-| Re-type prompts for every code review or analysis | 14 skills give consistent results without re-typing |
+| Re-type prompts for every code review or analysis | 15 skills give consistent results without re-typing |
 
 ---
 
@@ -140,11 +140,11 @@ What it changed: descriptions were cut to short English triggers, a shared contr
 | Part | What it does | Docs |
 |---|---|---|
 | **GitHub Actions** | One push to main handles versioning, changelogs, and CI/CD deployment | [Versioning](https://cassiiopeia.github.io/projectops/version-control) |
-| **Agent Skills** (14) | `/pro-github`, `/pro-commit`, `/pro-report` and more let an AI agent drive each step: issues, commits in your style, reports, release PRs | [Skills guide](https://cassiiopeia.github.io/projectops/skills) |
+| **Agent Skills** (15) | `/pro-github`, `/pro-commit`, `/pro-report` and more let an AI agent drive each step: issues, commits in your style, reports, release PRs | [Skills guide](https://cassiiopeia.github.io/projectops/skills) |
 | **npx CLI** | Installs and updates workflows in an existing project, and diagnoses its state | [CLI reference](https://cassiiopeia.github.io/projectops/cli) |
 
 <details>
-<summary>See all 14 Agent Skills</summary>
+<summary>See all 15 Agent Skills</summary>
 
 ### 🔄 Development cycle automation
 
@@ -168,6 +168,7 @@ What it changed: descriptions were cut to short English triggers, a shared contr
 |------|------|
 | `/pro-figma` | Move a Figma design into code, then compare the result with the design pixel by pixel |
 | `/pro-launch` | Launch, drive, and capture apps, web, and servers: fixed status bar, width changes, response mocking (empty list, failures), render from code |
+| `/pro-desktop-control` | Drive programs on this computer's screen that are not web pages or emulators (installer wizards, OS dialogs, desktop apps): reads elements, presses without moving the mouse, asks before installs, hands security prompts to the user. Windows for now (macOS planned, issue #985) |
 | `/pro-design-brief` | A design request for a screen you built before the mockup exists: state captures, alternatives, copy candidates, and must-keep rules as a board for the designer |
 | `/pro-oss-consult` | Diagnose a GitHub repo as an open-source project: type detection, 6-axis scoring, maturity stage, and edits to About, topics, labels, and files only after approval. One repo or a whole account |
 
@@ -229,7 +230,7 @@ flowchart TD
 </details>
 
 <details>
-<summary>Install Agent Skills only (Claude Code, Gemini CLI, Codex CLI, Cursor)</summary>
+<summary>Install Agent Skills only (Claude Code, Gemini CLI, Codex CLI, Cursor, GitHub Copilot)</summary>
 
 ```bash
 # Claude Code
@@ -252,7 +253,7 @@ The `--mode skills` wizard registers the Codex marketplace and also prepares the
 Where the Codex plugin marketplace is unavailable, use the fallback install described in the [Skills guide](docs/en/skills.md).
 
 ```bash
-# Cursor / the full Agent Skills install menu (recommended: npx)
+# Cursor / GitHub Copilot (~/.copilot/skills) / the full Agent Skills install menu (recommended: npx)
 npx projectops --mode skills
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.71.3",
+  "version": "4.73.0",
   "description": "ProjectOps: installer CLI for a fully automated GitHub project management template (versioning, CI/CD, release notes, agent skills)",
   "keywords": [
     "devops",

package/src/cli/args.js

@@ -37,6 +37,7 @@ export function parseArgs(argv) {
     projectsSync: null,  // #716 — Projects 보드 동기화 워크플로우 포함 여부 (null=미지정)
     json: false,         // --json: 기계가 읽는 출력 (--mode options)
     removeLegacy: false, // #809 — 구세대 배포 워크플로우(confirm 티어)도 .bak 으로 치운다
+    createDevelopmentBranch: false, // #715 — 비대화형에서 개발 브랜치 생성·push (원격에 쓰므로 명시할 때만)
     pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
     force: false,
     lang: null,              // --lang en|ko (null = decided by src/i18n resolveLang)
@@ -177,6 +178,7 @@ export function parseArgs(argv) {
       case "--projects-sync": result.projectsSync = true; break;
       case "--no-projects-sync": result.projectsSync = false; break;
       case "--remove-legacy": result.removeLegacy = true; break;
+      case "--create-development-branch": result.createDevelopmentBranch = true; break;
       case "--json": result.json = true; break;
       case "--npm-publish":
         process.stderr.write(t("args.npmPublishDeprecated") + "\n");

package/src/cli/help.js

@@ -50,6 +50,9 @@ Options
       --publish CSV        library registries: nexus,npm,github-packages. omitted: none
       --deploy-branch NAME the DEVELOPMENT branch (head of the release PR), default develop. It is NOT the branch that deploys;
                            that is the repository default branch. This flag does not create the branch
+      --create-development-branch   create the development branch from the default branch and push it to origin when it
+                           is missing. Does nothing if it exists. A failed push does not fail the run; the summary prints
+                           the command to run yourself. omitted: off (pushing to the remote is never done without asking)
       --secret-backup / --no-secret-backup   upload GitHub Secrets to your server over SSH (needs SERVER_* secrets). omitted: excluded
       --ai-summary / --no-ai-summary         AI change summary comment on work PRs. Works with no extra setup. omitted: included
       --coderabbit / --no-coderabbit         install .coderabbit.yaml (only --mode full). Needs the CodeRabbit GitHub app. An existing
@@ -129,6 +132,9 @@ AI agent 나 CI 는 항상 이렇게 실행한다:      npx projectops --mode <
       --publish CSV        라이브러리 레지스트리: nexus,npm,github-packages. 생략: 없음
       --deploy-branch NAME **개발** 브랜치(릴리스 PR 의 head), 기본 develop. 배포가 도는 브랜치가 아니다 —
                            그것은 레포 기본 브랜치다. 이 플래그는 브랜치를 만들지 않는다
+      --create-development-branch   개발 브랜치가 없으면 기본 브랜치에서 만들고 origin 에 push 한다. 이미 있으면
+                           아무것도 하지 않는다. push 가 실패해도 실행은 실패하지 않고 직접 실행할 명령을 요약에 남긴다.
+                           생략: 꺼짐 (묻지 않고 원격에 push 하지 않는다)
       --secret-backup / --no-secret-backup   GitHub Secret 을 SSH 로 서버에 올린다 (SERVER_* secret 필요). 생략: 제외
       --ai-summary / --no-ai-summary         작업 PR 에 AI 변경 요약 댓글. 추가 설정 없이 동작. 생략: 포함
       --coderabbit / --no-coderabbit         .coderabbit.yaml 설치 (--mode full 에서만). CodeRabbit GitHub 앱이 필요하다.

package/src/commands/doctor.js

@@ -20,6 +20,7 @@ import { verifyInstall } from "../core/verify.js";
 import { readBaseline } from "../core/baseline.js";
 import { detectRepoName } from "../core/detect-fs.js";
 import { detectMigrations } from "../core/migrations/index.js";
+import { scanPlaceholderTriggers } from "../core/placeholder-triggers.js";
 import { t } from "../i18n/index.js";
 
 // 언어 전환(withLang 등) 시점에 평가되도록 함수로 둔다
@@ -96,6 +97,22 @@ export function localChecks(cwd = ".") {
     ],
   });
 
+  // 자동 트리거 + 예시 값 (#662) — 미치환 토큰 검사에 안 걸리는 your-project 류 값이 실패 런을 계속 만든다
+  const autoPlaceholders = scanPlaceholderTriggers(wfDir);
+  add({
+    name: t("doctor.ph.name"), purpose: t("doctor.ph.purpose"),
+    status: autoPlaceholders.length ? "WARN" : "OK",
+    value: autoPlaceholders.length ? t("doctor.count", { n: autoPlaceholders.length }) : t("doctor.none"),
+    detail: autoPlaceholders.length ? [
+      t("doctor.ph.l1"),
+      ...autoPlaceholders.flatMap((w) => [
+        `  ${w.file}  (${w.triggers.join(", ")})`,
+        ...w.values.map((p) => `    ${w.file}:${p.line}  ${p.key}: "${p.value}"`),
+      ]),
+      t("doctor.ph.fix"),
+    ] : null,
+  });
+
   const secretNames = [...v.secrets.keys()];
   add({
     name: t("doctor.sec.name"), purpose: t("doctor.sec.purpose"),

package/src/commands/full.js

@@ -58,7 +58,7 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
     })), { version, versionCode });
 
   // 2. README 버전 섹션
-  step("update-readme", () => addVersionSectionToReadme(version, targetRoot), { version });
+  step("update-readme", () => addVersionSectionToReadme(version, targetRoot, language), { version });
 
   // 5. scripts / config
   //    워크플로우 밖 영역도 기록한다 (#561) — "내 스크립트가 갱신됐나"를 로그만 보고 알 수 있게.

package/src/commands/version.js

@@ -37,7 +37,7 @@ export function runVersion(context, tempDir, targetRoot = ".") {
       // 호출부가 recordMode로 기존 값을 넘긴다 (full이 우세 — 업데이트 재실행 범위 축소 방지).
       templateOptions: toTemplateOptions(context, { mode: recordMode, optionsDate: today }),
     }));
-  addVersionSectionToReadme(version, targetRoot);
+  addVersionSectionToReadme(version, targetRoot, context.language);
   copyScripts(tempDir, targetRoot);
   copyConfigFolder(tempDir, targetRoot);
   applyLabelStyle(targetRoot, labelStyle); // #776

package/src/core/copy/readme.js

@@ -3,27 +3,35 @@ import { join } from "node:path";
 import { existsSync, readFileSync, appendFileSync } from "node:fs";
 
 const MARKER = "<!-- AUTO-VERSION-SECTION";
-// ## (최신 버전|최신버전|Version|버전) : vX.Y.Z (대소문자 무시)
-const VERSION_LINE_RE = /##\s*(최신\s*버전|최신버전|Version|버전)\s*:\s*v[0-9]+\.[0-9]+\.[0-9]+/i;
+// ## (최신 버전|최신버전|Latest version|Version|버전) : vX.Y.Z (대소문자 무시)
+const VERSION_LINE_RE = /##\s*(최신\s*버전|최신버전|Latest\s+version|Version|버전)\s*:\s*v[0-9]+\.[0-9]+\.[0-9]+/i;
+
+// 레포 언어별 섹션 문구 (.github/scripts/i18n 의 readme.version_heading 과 같은 값)
+const SECTION_TEXT = {
+  en: { heading: "Latest version", changelogLink: "View the full version history" },
+  ko: { heading: "최신 버전", changelogLink: "전체 버전 기록 보기" },
+};
 
 // README.md 없으면 스킵. 마커 또는 버전 라인 있으면 스킵. 없으면 파일 끝에 append.
 // 반환: 'skip-no-readme' | 'skip-marker' | 'skip-version-line' | 'added'
-export function addVersionSectionToReadme(version, targetRoot = ".") {
+// language 미지정은 ko — 언어를 넘기지 않는 기존 호출부의 결과를 바꾸지 않기 위함
+export function addVersionSectionToReadme(version, targetRoot = ".", language = "ko") {
   const p = join(targetRoot, "README.md");
   if (!existsSync(p)) return "skip-no-readme";
   const content = readFileSync(p, "utf8");
   if (content.includes(MARKER)) return "skip-marker";
   if (VERSION_LINE_RE.test(content)) return "skip-version-line";
 
+  const text = SECTION_TEXT[language] ?? SECTION_TEXT.ko;
   // append 본문은 빈 줄 + "---"로 시작 (원본 파일이 개행으로 끝난다는 전제).
   const section =
     "\n" +
     "---\n" +
     "\n" +
     "<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->\n" +
-    `## 최신 버전 : v${version}\n` +
+    `## ${text.heading} : v${version}\n` +
     "\n" +
-    "[전체 버전 기록 보기](CHANGELOG.md)\n";
+    `[${text.changelogLink}](CHANGELOG.md)\n`;
   appendFileSync(p, section);
   return "added";
 }

package/src/core/copy/simple.js

@@ -35,6 +35,8 @@ export function copyScripts(tempDir, targetRoot = ".") {
     "asc_client.py",
     // iOS 버전 사전 점검, 업로드 거부 분류, 아카이브부터 업로드까지 재시도 (#643).
     "ios_release.py",
+    // Flutter iOS 빌드의 Xcode 선택(빈 값 = 러너 최신)과 SDK 누락 진단 (#758). 선택 규칙의 유일한 위치.
+    "select_xcode.py",
     // 릴리스 머지 때 완료 라벨이 붙은 이슈를 닫는다 (#771). close_on_release 옵션이 켜진 레포에서만 동작한다.
     "close_issues_on_release.py",
     // Play Store/TestFlight 배포 모드를 코드 설정(.github/config/store-deploy.json)에서 읽는다 (#767).
@@ -60,7 +62,7 @@ export function copyScripts(tempDir, targetRoot = ".") {
   const i18nSrc = join(tempDir, PATHS.scriptsDir, "i18n");
   if (exists(i18nSrc)) {
     for (const f of readdirSync(i18nSrc)) {
-      if (!/\.(py|json)$/.test(f)) continue; // __pycache__ 등은 제외
+      if (!/\.(py|json|cjs)$/.test(f)) continue; // __pycache__ 등은 제외 (cjs: 워크플로우 댓글 런타임)
       copyFileSync(join(i18nSrc, f), join(targetRoot, PATHS.scriptsDir, "i18n", f));
       copied++;
     }

package/src/core/development-branch.js

@@ -0,0 +1,58 @@
+// 비대화형 개발(릴리스 소스) 브랜치 생성 (#715) — --create-development-branch 를 준 실행에서만.
+// 대화형 ensureDeployBranch 를 "모든 질문에 예"로 다시 쓴다: 존재 판단·생성·push 경로를 한 벌로 유지.
+// 실패해도 예외를 던지지 않는다 — 통합 전체를 실패시키지 않고 수동 명령만 남긴다.
+import { ensureDeployBranch } from "./options-ask.js";
+
+// ensureDeployBranch state > 결과 3종 (created · skipped · failed)
+const STATUS_BY_STATE = {
+  "exists-local": "skipped",
+  "exists-remote": "skipped",
+  "pushed": "created",
+  "push-failed": "failed",
+  "create-failed": "failed",
+  "not-a-repo": "failed",
+  "not-checked": "failed",
+};
+
+// 실패 사유별 수동 명령 (push 실패는 로컬 브랜치가 이미 생겼으므로 push 만)
+function manualCommandFor(state, branch, base) {
+  if (state === "push-failed") return `git push -u origin ${branch}`;
+  if (state === "create-failed" && base) return `git branch ${branch} ${base} && git push -u origin ${branch}`;
+  return `git checkout -b ${branch} && git push -u origin ${branch}`;
+}
+
+/**
+ * 개발 브랜치 확인 > 없으면 기본 브랜치에서 생성 > origin push
+ * 반환: { status, reason, branch, base, pushed, manualCommand(실패 시만) }
+ */
+export async function createDevelopmentBranchUnattended({ targetRoot = ".", branch = "develop", defaultBranch = "", say = () => {} }) {
+  const answerYes = { confirm: async () => true };
+  const outcome = await ensureDeployBranch({ targetRoot, deployBranch: branch, defaultBranch, io: answerYes, say });
+  const status = STATUS_BY_STATE[outcome.state] ?? "failed";
+  return {
+    status,
+    reason: outcome.state,
+    branch,
+    base: defaultBranch,
+    pushed: outcome.pushed === true,
+    manualCommand: status === "failed" ? manualCommandFor(outcome.state, branch, defaultBranch) : null,
+  };
+}
+
+/**
+ * 실행 단계 래퍼: 플래그 확인 > 생성 시도 > 실행 기록(trace) 남김
+ * 플래그가 없으면 만들지 않고 "왜 안 만들었는지"만 기록. 반환: 결과 | null(플래그 없음)
+ */
+export async function runDevelopmentBranchStep({ isRequested = false, targetRoot, branch, defaultBranch, trace = null, say = () => {} }) {
+  const name = branch || "develop";
+  if (!isRequested) {
+    trace?.event("dev-branch", "not-requested", name, { flag: "--create-development-branch", note: "left as a manual step" });
+    return null;
+  }
+  const result = await createDevelopmentBranchUnattended({ targetRoot, branch: name, defaultBranch, say });
+  // action 이 곧 결과 — failed 는 로그에서 ERROR 로 보인다 (run-trace levelOf)
+  trace?.event("dev-branch", result.status, name, {
+    base: defaultBranch || null, reason: result.reason, pushed: result.pushed, manualCommand: result.manualCommand,
+  });
+  return result;
+}

package/src/core/ide/adapter.js

@@ -19,7 +19,7 @@
 //   remove(io, ctx): boolean                  제거(미설치면 no-op, true)
 //   manualHint(io): string                    CLI 없을 때 보여줄 수동 설치 명령(선택)
 //
-// io = runner.defaultIo() 또는 테스트 stub: { which, run, home, log }
+// io = runner.defaultIo() 또는 테스트 stub: { which, run, home, log, projectopsHome?(없으면 home/.projectops) }
 // ctx = { templateVersion, sourceSkillsDir } — 버전 표기·Cursor 복사 소스 등 공용 컨텍스트
 //
 // 규칙:

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

@@ -0,0 +1,84 @@
+// GitHub Copilot 어댑터 (agent skills 복사·메타 기록·제거).
+// 개인 스킬 폴더 ~/.copilot/skills/<이름>/SKILL.md 를 VS Code·Copilot CLI·JetBrains 플러그인이 모두 기본으로 읽는다
+//   (JetBrains 1.18 기본 위치: .agents/.github/.claude skills + ~/.agents·~/.copilot·~/.claude skills)
+// ~/.copilot/intellij-skills 는 JetBrains 플러그인이 내장 스킬을 덮어쓰는 관리 폴더라 쓰지 않는다.
+// 스킬 이름(frontmatter name)은 폴더명과 같아야 로드된다 — pro-* 폴더가 이미 그 규칙을 지킨다.
+import { join } from "node:path";
+import { existsSync, readdirSync } from "node:fs";
+import { migrateConfigRoot } from "../legacy.js";
+import { t } from "../../../i18n/index.js";
+import { readSkillsMeta } from "../skills-copy.js";
+import { applyHomeSkills, removeHomeSkills } from "../home-skills.js";
+
+const META_FILE_NAME = "copilot-skills-meta.json";
+const MESSAGE_PREFIX = "ide.copilot";
+// Copilot 사용 흔적 4종: copilot CLI, ~/.copilot 폴더(CLI·JetBrains 가 만듦), VS Code 확장, JetBrains 플러그인
+const COPILOT_CLI_NAME = "copilot";
+const COPILOT_HOME_DIR = ".copilot";
+const VSCODE_EXTENSION_DIRS = [".vscode/extensions", ".vscode-insiders/extensions"];
+// VS Code 확장 폴더명: github.copilot-1.2.3 · github.copilot-chat-0.30.0
+const VSCODE_EXTENSION_PREFIX = "github.copilot";
+// IDE 설정 루트 (macOS · Windows · Linux) > <제품><버전>/plugins/github-copilot-intellij
+//   Linux 는 플러그인이 <제품><버전>/ 바로 아래에 깔린다. Android Studio 도 같은 플러그인을 쓴다.
+const JETBRAINS_CONFIG_ROOTS = [
+  "Library/Application Support/JetBrains", "AppData/Roaming/JetBrains", ".local/share/JetBrains",
+  "Library/Application Support/Google", "AppData/Roaming/Google", ".local/share/Google",
+];
+const JETBRAINS_PLUGIN_PREFIX = "github-copilot";
+
+function skillsDir(io) { return join(io.home(), COPILOT_HOME_DIR, "skills"); }
+function metaPath(io) { return join(skillsDir(io), META_FILE_NAME); }
+function homeSkillsOptions(io) { return { skillsDest: skillsDir(io), metaFileName: META_FILE_NAME, messagePrefix: MESSAGE_PREFIX }; }
+
+// 쓰지 않는 사람 홈에 ~/.copilot 을 만들지 않도록, 흔적이 있을 때만 설치 후보로 둔다
+function isCopilotDetected(io) {
+  if (io.which(COPILOT_CLI_NAME)) return true;
+  if (existsSync(join(io.home(), COPILOT_HOME_DIR))) return true;
+  if (VSCODE_EXTENSION_DIRS.some((dir) => hasEntryWithPrefix(join(io.home(), dir), VSCODE_EXTENSION_PREFIX))) return true;
+  return JETBRAINS_CONFIG_ROOTS.some((root) => hasJetBrainsCopilotPlugin(join(io.home(), root)));
+}
+
+function hasJetBrainsCopilotPlugin(configRoot) {
+  for (const productDir of listNames(configRoot)) {
+    const productPath = join(configRoot, productDir);
+    if (hasEntryWithPrefix(join(productPath, "plugins"), JETBRAINS_PLUGIN_PREFIX)) return true;
+    if (hasEntryWithPrefix(productPath, JETBRAINS_PLUGIN_PREFIX)) return true;
+  }
+  return false;
+}
+
+function hasEntryWithPrefix(dir, prefix) {
+  return listNames(dir).some((name) => name.toLowerCase().startsWith(prefix));
+}
+
+function listNames(dir) {
+  if (!existsSync(dir)) return [];
+  try { return readdirSync(dir); } catch { return []; }
+}
+
+function detect(io) {
+  const { installed, version } = readSkillsMeta(metaPath(io));
+  if (installed) return { installed, version, cliMissing: false };
+  if (isCopilotDetected(io)) return { installed: false, version: null, cliMissing: false, note: t("ide.copilot.detected") };
+  return { installed: false, version: null, cliMissing: true, note: t("ide.copilot.notDetected") };
+}
+
+function apply(io, ctx = {}) {
+  if (detect(io).cliMissing) { io.log(manualHint()); return false; }
+  migrateConfigRoot(io);    // 공용 config 루트 이관
+  return applyHomeSkills(io, ctx, homeSkillsOptions(io));
+}
+
+// 사용자가 직접 넣은 스킬이 남으면 폴더 유지
+function remove(io, ctx = {}) {
+  return removeHomeSkills(io, ctx, homeSkillsOptions(io));
+}
+
+function manualHint() {
+  return t("ide.copilot.manual");
+}
+
+export const copilotAdapter = {
+  id: "copilot", label: "GitHub Copilot", order: 45,
+  detect, apply, remove, manualHint,
+};

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

@@ -1,95 +1,35 @@
 // Cursor 어댑터 (skills 복사·메타 기록·제거).
-// 마켓플레이스 없음 → ~/.cursor/skills/ 에 skills/ 폴더를 복사하고 meta.json으로 버전 추적.
+// 마켓플레이스 없음 → ~/.cursor/skills/ 에 skills/ 폴더, ~/.cursor/scripts/ 에 공용 파이썬을 복사하고 meta.json으로 버전 추적.
 import { join } from "node:path";
-import { existsSync, readFileSync, mkdirSync, cpSync, rmSync, writeFileSync, readdirSync } from "node:fs";
+import { existsSync, readFileSync, rmSync } from "node:fs";
 import { migrateConfigRoot, isLegacyVersion } from "../legacy.js";
 import { t } from "../../../i18n/index.js";
-import { TEMPLATE_REPO_WEB_URL } from "../../paths.js";
+import { readSkillsMeta, ownedEntries } from "../skills-copy.js";
+import { applyHomeSkills, removeHomeSkills } from "../home-skills.js";
 
 const LEGACY_NAMES = ["cassiiopeia", "suh-devops-template"];
 const LEGACY_MAX_VERSION = "4.2.4";
+const META_FILE_NAME = "cursor-skills-meta.json";
+const MESSAGE_PREFIX = "ide.cursor";
 
-// 스킬을 쓰는 사람에게 필요 없는 것. projectops 자신을 검사하는 테스트다.
-// skills/ 는 통째로 복사되므로 여기서 걸러내지 않으면 사용자 홈에 그대로 쌓인다.
-const SKIP_IN_COPY = new Set(["conftest.py", "pytest.ini"]);
-const TEST_PATH = /(^|[\\/])(tests?|__pycache__)([\\/]|$)/;
-
-function metaPath(io) { return join(io.home(), ".cursor/skills/cursor-skills-meta.json"); }
+function skillsDir(io) { return join(io.home(), ".cursor/skills"); }
+function metaPath(io) { return join(skillsDir(io), META_FILE_NAME); }
+function homeSkillsOptions(io) { return { skillsDest: skillsDir(io), metaFileName: META_FILE_NAME, messagePrefix: MESSAGE_PREFIX }; }
 
 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 };
+  const { installed, version } = readSkillsMeta(metaPath(io));
+  return { installed, version, cliMissing: false };
 }
 
 function apply(io, ctx = {}) {
   migrateLegacy(io, ctx);   // 옛 이름/버전 감지 시 projectops 소유 항목 선별 삭제
   migrateConfigRoot(io);    // 공용 config 루트 이관
-  const src = resolveSkillsSrc(ctx);
-  if (!src) { io.log(t("ide.cursor.noSource")); return false; }
-  const dest = join(io.home(), ".cursor/skills");
-  io.log(t("ide.cursor.copying"));
-  try {
-    mkdirSync(dest, { recursive: true });
-    for (const e of readdirSync(src, { withFileTypes: true })) {
-      if (SKIP_IN_COPY.has(e.name)) continue;
-      cpSync(join(src, e.name), join(dest, e.name), {
-        recursive: true,
-        // 이 저장소 자기 코드를 검사하는 테스트는 남의 컴퓨터로 나갈 이유가 없다 (#591).
-        filter: (p) => !TEST_PATH.test(p),
-      });
-    }
-    // 소스에서 사라진 우리 스킬을 지운다. 복사는 overlay 라 덮어쓰기만 하면
-    // **폐기한 스킬이 남의 컴퓨터에 영영 남아** 계속 잡힌다 — util 복사가 같은
-    // 함정에 빠졌던 자리다 (#500). 남의 스킬은 접두사로 걸러 건드리지 않는다.
-    const srcNames = new Set(readdirSync(src));
-    for (const name of readdirSync(dest)) {
-      if (srcNames.has(name) || name === "cursor-skills-meta.json") continue;
-      if (!/^(pro|suh)-/.test(name)) continue;
-      try {
-        rmSync(join(dest, name), { recursive: true, force: true });
-        io.log(t("ide.cursor.obsolete", { name }));
-      } catch { /* 무시 — 지우지 못해도 설치는 계속한다 */ }
-    }
-    writeMeta(io, dest, ctx.templateVersion);
-    io.log(t("ide.cursor.installed", { dest, version: ctx.templateVersion || "unknown" }));
-    return true;
-  } catch {
-    io.log(t("ide.cursor.copyFailed"));
-    return false;
-  }
+  return applyHomeSkills(io, ctx, homeSkillsOptions(io));
 }
 
+// 타 스킬(somansa-tools 등) 남으면 폴더 유지
 function remove(io, ctx = {}) {
-  const dir = join(io.home(), ".cursor/skills");
-  if (!existsSync(join(dir, "cursor-skills-meta.json"))) { io.log(t("ide.cursor.removeNone")); return true; }
-  try {
-    for (const name of ownedEntries(io, ctx)) rmSync(join(dir, name), { recursive: true, force: true });
-    // 폴더가 비면 폴더 자체 제거, 타 스킬(somansa-tools 등) 남으면 유지
-    if (existsSync(dir) && readdirSync(dir).length === 0) rmSync(dir, { recursive: true, force: true });
-    io.log(t("ide.cursor.removed", { dir }));
-    return true;
-  } catch { io.log(t("ide.cursor.removeFailed", { dir })); return false; }
-}
-
-// projectops가 이 폴더에 설치했다고 볼 항목만 골라낸다.
-// 소스 skills/ 폴더명(pro-*, references, config.json.example) ∪ /^suh-/ ∪ meta 파일.
-// 접두어 없는 폴더(analyze·gitlab 등 somansa-tools)는 제외 → 보존.
-function ownedEntries(io, ctx) {
-  const dir = join(io.home(), ".cursor/skills");
-  if (!existsSync(dir)) return [];
-  let srcNames = new Set();
-  const src = resolveSkillsSrc(ctx);
-  if (src && existsSync(src)) srcNames = new Set(readdirSync(src));
-  const EXTRA = new Set(["cursor-skills-meta.json"]);
-  // suh- 는 옛 접두사, pro- 는 현행 접두사다. 둘 다 우리 것으로 친다 —
-  // 폐기한 스킬은 소스에 없으므로 srcNames 로는 잡히지 않는다 (#619).
-  return readdirSync(dir).filter((name) => srcNames.has(name) || /^(pro|suh)-/.test(name) || EXTRA.has(name));
+  return removeHomeSkills(io, ctx, homeSkillsOptions(io));
 }
 
 // 옛 이름/버전 meta면 projectops 소유 항목만 선별 삭제 → apply가 신규 재설치.
@@ -101,8 +41,8 @@ function migrateLegacy(io, ctx) {
   const oldName = meta.name && LEGACY_NAMES.includes(String(meta.name).toLowerCase());
   const oldVer = isLegacyVersion(meta.version, LEGACY_MAX_VERSION);
   if (!(oldName || oldVer)) return;
-  for (const name of ownedEntries(io, ctx)) {
-    try { rmSync(join(io.home(), ".cursor/skills", name), { recursive: true, force: true }); } catch { /* 무시 */ }
+  for (const name of ownedEntries(skillsDir(io), ctx, META_FILE_NAME)) {
+    try { rmSync(join(skillsDir(io), name), { recursive: true, force: true }); } catch { /* 무시 */ }
   }
   io.log(t("ide.cursor.legacy", { name: meta.name, version: meta.version }));
 }
@@ -111,29 +51,6 @@ function manualHint() {
   return t("ide.cursor.manual");
 }
 
-// ── 헬퍼 ──
-// 스킬 소스: 다운로드된 템플릿(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: "projectops", version, scope: "user",
-    source: TEMPLATE_REPO_WEB_URL,
-    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/home-skills.js

@@ -0,0 +1,52 @@
+// 홈 복사형 IDE(Cursor·Copilot) 설치·제거 흐름 공용: 소스 찾기 > 복사 > 진입점 > 로그
+// 메시지는 어댑터별 키 묶음(<messagePrefix>.copying 등)을 쓴다.
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { t } from "../../i18n/index.js";
+import { resolveSkillsSrc, resolveScriptsSrc, installHomeSkills, removeOwnedEntries } from "./skills-copy.js";
+import { refreshStableEntrypoints, projectopsHomeOf } from "./stable-entry.js";
+
+/**
+ * 설치·업데이트: 스킬 소스 확인 > 스킬·공용 파이썬 복사 > 고정 진입점 > 결과 로그
+ * options: { skillsDest, metaFileName, messagePrefix }
+ */
+export function applyHomeSkills(io, ctx, { skillsDest, metaFileName, messagePrefix }) {
+  const skillsSrc = resolveSkillsSrc(ctx);
+  if (!skillsSrc) { io.log(t(`${messagePrefix}.noSource`)); return false; }
+  const scriptsSrc = resolveScriptsSrc(ctx, skillsSrc);
+  io.log(t(`${messagePrefix}.copying`));
+  try {
+    const { obsoleteNames, hasSharedScripts } = installHomeSkills({
+      skillsSrc, scriptsSrc, skillsDest, metaFileName, templateVersion: ctx.templateVersion,
+    });
+    for (const name of obsoleteNames) io.log(t("ide.skillsCopy.obsolete", { name }));
+    // 공용 파이썬이 없으면 스킬 CLI 가 import 에 실패 → 알림만 (문서형 스킬은 동작)
+    if (!hasSharedScripts) io.log(t("ide.skillsCopy.noScripts"));
+    io.log(t(`${messagePrefix}.installed`, { dest: skillsDest, version: ctx.templateVersion || "unknown" }));
+  } catch {
+    io.log(t(`${messagePrefix}.copyFailed`));
+    return false;
+  }
+  installStableEntrypoints(io, skillsSrc, scriptsSrc);
+  return true;
+}
+
+// 진입점 실패는 설치 실패가 아니다 (CLI 첫 실행 때 파이썬이 다시 깐다)
+function installStableEntrypoints(io, skillsSrc, scriptsSrc) {
+  try {
+    const projectopsHome = projectopsHomeOf(io);
+    for (const name of refreshStableEntrypoints(projectopsHome, { skillsSrc, scriptsSrc })) {
+      io.log(t("ide.skillsCopy.entrypoint", { path: join(projectopsHome, "bin", name) }));
+    }
+  } catch { io.log(t("ide.skillsCopy.entrypointFailed")); }
+}
+
+// 제거: 메타 없으면 건너뜀 > 우리 항목·공용 파이썬만 삭제 (남의 스킬이 남으면 폴더 유지)
+export function removeHomeSkills(io, ctx, { skillsDest, metaFileName, messagePrefix }) {
+  if (!existsSync(join(skillsDest, metaFileName))) { io.log(t(`${messagePrefix}.removeNone`)); return true; }
+  try {
+    removeOwnedEntries(skillsDest, ctx, metaFileName);
+    io.log(t(`${messagePrefix}.removed`, { dir: skillsDest }));
+    return true;
+  } catch { io.log(t(`${messagePrefix}.removeFailed`, { dir: skillsDest })); return false; }
+}

package/src/core/ide/registry.js

@@ -9,6 +9,7 @@ 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 { copilotAdapter } from "./adapters/copilot.js";
 import { piAdapter } from "./adapters/pi.js";
 import { piHarnessAdapter } from "./adapters/pi-harness.js";
 
@@ -18,6 +19,7 @@ export const ADAPTERS = [
   cursorAdapter,
   geminiAdapter,
   codexAdapter,
+  copilotAdapter,
   piAdapter,
   piHarnessAdapter,
 ].map(assertAdapter).sort((a, b) => (a.order ?? 100) - (b.order ?? 100));

package/src/core/ide/runner.js

@@ -54,6 +54,8 @@ export function defaultIo() {
     which,
     run,
     home: () => homedir(),
+    // 파이썬 stable_entry 와 같은 규칙: PROJECTOPS_HOME > ~/.projectops
+    projectopsHome: () => process.env.PROJECTOPS_HOME || join(homedir(), ".projectops"),
     log: (msg) => console.error(msg), // 안내는 stderr로 (stdout 파이프 오염 방지)
   };
 }