sayren 0.10.0 → 0.12.0

package/dist/index.mjs

@@ -8038,6 +8038,60 @@ const cli_retired_token = ((inputs = {}, options = {}) => {
 	return ko_cli_retired_token(inputs);
 });
 
+//#endregion
+//#region src/paraglide/messages/cli_skill_failed.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ status: NonNullable<unknown> }} Cli_Skill_FailedInputs */
+const ko_cli_skill_failed = (i) => {
+	return `스킬을 읽지 못했습니다(HTTP ${i?.status})`;
+};
+/**
+
+* @param {Cli_Skill_FailedInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_skill_failed = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_skill_failed(inputs);
+});
+
+//#endregion
+//#region src/paraglide/messages/cli_skill_not_found.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{ name: NonNullable<unknown> }} Cli_Skill_Not_FoundInputs */
+const ko_cli_skill_not_found = (i) => {
+	return `스킬 ${i?.name}이(가) 없습니다. npx sayren skill list로 목록을 확인하십시오`;
+};
+/**
+
+* @param {Cli_Skill_Not_FoundInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_skill_not_found = ((inputs, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_skill_not_found(inputs);
+});
+
+//#endregion
+//#region src/paraglide/messages/cli_skill_usage.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_Skill_UsageInputs */
+const ko_cli_skill_usage = () => {
+	return `스킬을 지정하십시오: npx sayren skill list 또는 npx sayren skill <이름>`;
+};
+/**
+
+* @param {Cli_Skill_UsageInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_skill_usage = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_skill_usage(inputs);
+});
+
 //#endregion
 //#region src/paraglide/messages/cli_skipped_outside.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -8746,6 +8800,7 @@ const ko_cli_usage = (i) => {
   npx sayren deploy [--no-publish] [--skip-build] [--message <메모>] [--force [--yes]]
   npx sayren status
   npx sayren verify
+  npx sayren skill list | <이름>         # sayren 스킬 목록·본문(에이전트용, 로그인 없음)
   npx sayren app <명령>                 # 서드파티 앱(init·dev·trigger·verify·deploy·release·status·logs·secret·dev-store)
 
 명령:
@@ -8757,6 +8812,7 @@ const ko_cli_usage = (i) => {
   deploy   로컬 검사 → 로컬 빌드 → 작업 트리 올리기 → 빌드 → 발행. 원격이 pull 이후 바뀌었으면 덮어쓰지 않습니다
   status   사이트·발행 버전·최근 빌드·편집 환경
   verify   로컬 규칙·경로·크기 검사(서버 빌드와 같은 규칙)
+  skill    sayren 스킬 목록(list)과 본문(<이름>)을 출력합니다. 스킬은 중앙에서 고치므로 늘 최신입니다
   app      서드파티 앱 — init <handle>로 만들고 dev로 로컬 실행, deploy로 버전을 올리고 release로 적용합니다. 자세히: https://docs.sayren.io/guides/apps-getting-started
 
 토큰은 Sayren 계정 토큰만 받고 --token → SAYREN_TOKEN 환경 변수 → 로그인(credentials.json) 순서로 읽습니다.
@@ -9688,7 +9744,7 @@ async function selectStore(auth, client, io, candidates, folderStore = null) {
 
 //#endregion
 //#region package.json
-var version = "0.10.0";
+var version = "0.12.0";
 
 //#endregion
 //#region src/client.ts
@@ -11779,11 +11835,11 @@ function lockImporterSpecifiers(lock) {
 //#endregion
 //#region src/guide-skill.ts
 /**
-* 받은 폴더의 에이전트 안내 스킬(2026-10-16 사용자 결정) — 셀러의 Claude Code가 sayren 중앙 스킬을 HTTP로 읽게 한다.
+* 받은 폴더의 에이전트 안내 스킬(2026-10-16 사용자 결정) — 셀러의 Claude Code가 기능·화면을 고치기 전에 sayren 중앙 스킬을 `npx sayren skill`로 읽게 한다(스킬은 이 하나만 설치한다).
 * 빈 템플릿이 싣는 `templates/storefront-blank/.claude/skills/sayren/SKILL.md`와 같은 내용이다(`guide-skill.test.ts`가 고정한다).
 */
 const GUIDE_SKILL_PATH = ".claude/skills/sayren/SKILL.md";
-const GUIDE_SKILL = "---\nname: sayren\ndescription: Use for any work on this sayren storefront — pages, product display, cart, checkout, payments, buyer login, account pages, analytics, design and code quality. Loads the current sayren skills over HTTP.\n---\n\n# sayren skills (central)\n\nThe sayren skills are maintained centrally and change without updating this project. Read them over HTTP at the start of a task instead of relying on memory.\n\n1. List the skills: `GET https://api.sayren.io/v1/public/agent-skills`\n   The response is `{ \"data\": [{ \"name\", \"description\", \"version\", \"updatedAt\" }] }`.\n2. Read the skills that match the task: `GET https://api.sayren.io/v1/public/agent-skills/{name}`\n   The response is `{ \"data\": { \"name\", \"description\", \"body\", \"version\", \"updatedAt\" } }`; `body` is the guide (markdown).\n\nStart points:\n- Any code change: `code-quality`, `sayren-storefront-rules`, `sdk-client`, `template-stack`\n- Product pages: `sayren-product-display`, `sdk-catalog`\n- Cart, checkout, payment: `sdk-cart`, `sdk-checkout`, `sdk-payments`\n- Buyer login and account pages: `sdk-buyer-auth`, `sdk-account`\n- Visual design: `design-quality`\n\nFollow the project's `CLAUDE.md` first; the skills add the sayren-specific details.\n";
+const GUIDE_SKILL = "---\nname: sayren\ndescription: Load before adding, implementing or changing any feature or page of this sayren storefront. Lists the current sayren skills and loads the ones the task needs.\n---\n\n# sayren skills\n\nThe sayren skills are maintained centrally and change without updating this project.\nDo not rely on memory or earlier copies. Load them at the start of each task.\n\n1. List the skills (name and when to use each):\n   `npx -y sayren@latest skill list`\n2. Read every skill that matches the task, in full, and follow it:\n   `npx -y sayren@latest skill <name>`\n\nIf the sayren MCP server is connected, the tools `list_skills` and `get_skill` return the same content.\n\nFollow the project's `CLAUDE.md` first. The skills add the sayren-specific details.\n";
 /**
 * 받은 트리에 안내 스킬이 없으면 넣는다 — 템플릿이 싣거나 셀러가 올린 내용이 우선이다. 트리에 넣으므로 다시 받을 때 지울 파일로 잡히지 않고
 * `deploy`가 원격 작업 트리에도 올린다(AI 상점 도우미가 같은 안내를 읽는다). 넣었으면 true
@@ -12586,6 +12642,31 @@ function relativeOf(io, path) {
 	return relative(io.cwd, path) || ".";
 }
 
+//#endregion
+//#region src/skill-commands.ts
+/**
+* `sayren skill list`·`sayren skill <name>`(2026-10-16 사용자 결정) — 안내 스킬 `sayren`이 에이전트에게 부르게 하는 중앙 스킬 읽기.
+* 공개 스킬 API(`/v1/public/agent-skills`, 인증 없음)를 읽어 원문을 출력한다. 셸·OS와 무관하게 같은 명령이고 요약되지 않는다
+*/
+async function skill(args, flags, io) {
+	const [target] = args;
+	if (!target) throw new CliError(cli_skill_usage());
+	const { apiOrigin } = resolveApiOrigin(flags, io.cwd, null, io.env);
+	const path = target === "list" ? "" : `/${encodeURIComponent(target)}`;
+	const res = await io.fetch(`${apiOrigin}/v1/public/agent-skills${path}`, { headers: { "User-Agent": CLI_USER_AGENT } });
+	if (res.status === 404) throw new CliError(cli_skill_not_found({ name: target }));
+	if (!res.ok) throw new CliError(cli_skill_failed({ status: res.status }));
+	const { data } = await res.json();
+	if (target === "list") {
+		const skills = data;
+		const width = Math.max(...skills.map((s) => s.name.length));
+		for (const s of skills) io.out(`${s.name.padEnd(width)}  ${s.description}`);
+		return 0;
+	}
+	io.out(data.body);
+	return 0;
+}
+
 //#endregion
 //#region src/index.ts
 /** 도움말 — 쓰는 자리에서 만든다(로케일이 정해진 뒤) */
@@ -12725,6 +12806,7 @@ async function main(argv, io) {
 		case "login": return login(loginFlags, io, () => ask(cli_prompt_access_token()));
 		case "logout": return logout(loginFlags, io);
 		case "whoami": return whoami(common, io);
+		case "skill": return skill(parsed.positional, { apiOrigin: common.apiOrigin }, io);
 		default: throw new CliError(cli_unknown_command({
 			command: parsed.command,
 			usage: usage()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sayren",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "type": "module",
   "imports": {
     "#paraglide/*": "./src/paraglide/*"