spr-ai-native 0.1.0

package/src/targets/codex.js

@@ -0,0 +1,81 @@
+import { join } from 'node:path';
+import { COMMANDS, ROLES, baseRules, loadCommand, loadRole, projectDoc } from '../lib/preset.js';
+import { frontmatter, quoted } from '../lib/write.js';
+
+export const label = 'Codex CLI';
+export const projectDocPath = 'AGENTS.md';
+export const globalDocPath = '~/.codex/AGENTS.md';
+
+const MODEL_COMMENT = `# model을 지정하지 않으면 부모 세션의 모델을 상속합니다.
+# 고정하려면 model = "..." / model_reasoning_effort = "..." 를 추가하세요.`;
+
+const DELEGATE_HOWTO = `Codex 멀티 에이전트 기능으로 서브에이전트를 spawn 합니다. \`.codex/agents/\`에 정의된 \`planner\` / \`engineer\` / \`qa\` 를 이름으로 지정해 호출하세요.
+
+- 서브에이전트는 이 대화의 컨텍스트를 **보지 못합니다.** task_id, 파일 경로, 회차를 프롬프트에 반드시 포함하세요.
+- 한 번에 하나씩 순서대로 spawn 합니다 (planner → engineer → qa). 각 단계가 앞 단계 산출물에 의존하므로 병렬 실행하지 마세요.
+- 멀티 에이전트가 비활성화되어 있어 spawn이 불가능하면, 임의로 직접 구현하지 말고 사용자에게 알리고 중단하세요.`;
+
+const vars = {
+  PROJECT_DOC: projectDocPath,
+  ARGS: '사용자가 이 스킬을 호출할 때 함께 입력한 내용',
+  DELEGATE_HINT: '(멀티 에이전트 기능으로 해당 이름의 서브에이전트를 spawn 합니다.)',
+  DELEGATE_HOWTO,
+};
+
+function tomlLiteral(body, role) {
+  if (body.includes("'''")) {
+    throw new Error(`${role} 본문에 ''' 가 있어 TOML 리터럴 문자열로 변환할 수 없습니다.`);
+  }
+  return `'''\n${body}\n'''`;
+}
+
+export function apply({ writer, cwd, home, useGlobal }) {
+  const notes = [];
+
+  writer.write(
+    join(cwd, projectDocPath),
+    projectDoc({ withBaseRules: !useGlobal, globalPath: globalDocPath })
+  );
+
+  for (const role of ROLES) {
+    const { meta, body } = loadRole(role, vars);
+    const toml = [
+      MODEL_COMMENT,
+      `name = ${quoted(meta.name)}`,
+      `description = ${quoted(meta.description)}`,
+      `developer_instructions = ${tomlLiteral(body, role)}`,
+    ].join('\n');
+    writer.write(join(cwd, '.codex', 'agents', `${role}.toml`), `${toml}\n`);
+  }
+
+  for (const command of COMMANDS) {
+    const { meta, body } = loadCommand(command, vars);
+    const head = frontmatter([
+      ['name', meta.name],
+      ['description', quoted(meta.description)],
+    ]);
+    writer.write(join(cwd, '.codex', 'skills', command, 'SKILL.md'), `${head}\n${body}\n`);
+  }
+
+  if (useGlobal) {
+    const status = writer.write(
+      join(home, '.codex', 'AGENTS.md'),
+      `# 공통 행동 지침\n\n${baseRules()}\n`
+    );
+    if (status === 'skipped') {
+      notes.push(
+        `${globalDocPath}가 이미 있어 건너뛰었습니다. 공통 행동 지침이 전역에 없을 수 있으니 ${projectDocPath} §9를 확인하세요.`
+      );
+    }
+  } else {
+    notes.push(
+      `공통 행동 지침을 전역(${globalDocPath})에도 설치하려면 \`--global\`을 붙여 다시 실행하세요.`
+    );
+  }
+
+  notes.push('`$pm` 스킬로 워크플로우를 시작합니다. (예: `$pm PROJ-582 로그인 API 구현`)');
+  notes.push(
+    '`.codex/config.toml`은 수정하지 않았습니다. 멀티 에이전트가 꺼져 있으면 `[agents] enabled = true` 를 직접 확인하세요.'
+  );
+  return notes;
+}

package/src/targets/cursor.js

@@ -0,0 +1,74 @@
+import { join } from 'node:path';
+import { COMMANDS, ROLES, baseRules, loadCommand, loadRole, readPreset } from '../lib/preset.js';
+import { frontmatter, quoted } from '../lib/write.js';
+
+export const label = 'Cursor';
+export const projectDocPath = '.cursor/rules/10-project.mdc';
+export const globalDocPath = null; // Cursor 전역 규칙은 파일이 아니라 Settings > Rules > User Rules
+
+// qa는 코드 수정이 금지되므로 readonly. planner/engineer는 works/ 및 소스에 써야 한다.
+const READONLY = { planner: false, engineer: false, qa: true };
+
+const MODEL_COMMENT =
+  '# model: 기본값 inherit(부모 세션 모델 상속). 특정 모델 ID로 변경할 수 있습니다.';
+
+const DELEGATE_HOWTO = `\`.cursor/agents/\`에 정의된 \`planner\` / \`engineer\` / \`qa\` 서브에이전트에게 위임합니다. 이름을 명시해 호출하세요.
+
+- 서브에이전트는 이 대화의 컨텍스트를 **보지 못합니다.** task_id, 파일 경로, 회차를 프롬프트에 반드시 포함하세요.
+- 한 번에 하나씩 순서대로 위임합니다 (planner → engineer → qa). 각 단계가 앞 단계 산출물에 의존하므로 병렬 실행하지 마세요.`;
+
+const vars = {
+  PROJECT_DOC: projectDocPath,
+  ARGS: '사용자가 이 커맨드와 함께 입력한 내용',
+  DELEGATE_HINT: '(서브에이전트 이름을 명시해 위임합니다.)',
+  DELEGATE_HOWTO,
+};
+
+export function apply({ writer, cwd, useGlobal }) {
+  const notes = [];
+
+  writer.write(
+    join(cwd, '.cursor', 'rules', '00-base.mdc'),
+    `${frontmatter([
+      ['description', quoted('공통 개발 행동 지침')],
+      ['alwaysApply', 'true'],
+    ])}\n# 공통 행동 지침\n\n${baseRules()}\n`
+  );
+
+  writer.write(
+    join(cwd, '.cursor', 'rules', '10-project.mdc'),
+    `${frontmatter([
+      ['description', quoted('프로젝트 개요 · 기술 스택 · 검증 명령 · 산출물 규약')],
+      ['alwaysApply', 'true'],
+    ])}\n${readPreset('project-doc.md').trim()}\n`
+  );
+
+  for (const role of ROLES) {
+    const { meta, body } = loadRole(role, vars);
+    const head = frontmatter([
+      ['name', meta.name],
+      ['description', quoted(meta.description)],
+      MODEL_COMMENT,
+      ['model', 'inherit'],
+      ['readonly', String(READONLY[role])],
+    ]);
+    writer.write(join(cwd, '.cursor', 'agents', `${role}.md`), `${head}\n${body}\n`);
+  }
+
+  for (const command of COMMANDS) {
+    const { body } = loadCommand(command, vars);
+    writer.write(join(cwd, '.cursor', 'commands', `${command}.md`), `${body}\n`);
+  }
+
+  if (useGlobal) {
+    notes.push(
+      'Cursor는 전역 규칙을 파일로 두지 않습니다(Settings > Rules > User Rules). `--global`은 무시했습니다.'
+    );
+    notes.push(
+      '전역으로 쓰려면 `.cursor/rules/00-base.mdc`의 frontmatter 아래 본문을 User Rules에 붙여넣으세요.'
+    );
+  }
+
+  notes.push('`/pm <task_id> <작업 지시>` 로 워크플로우를 시작합니다.');
+  return notes;
+}