[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBV2FJS451NW7MT9QTEHK3":3,"skill-same:01M6CBV2FJS451NW7MT9QTEHK3":55},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":13,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M6CBV2FJS451NW7MT9QTEHK3","17-common-result",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F20-domain-common\u002F17-common-result\u002FSKILL.md",[],[18,19],"common","17 common result","2026-11-10 10:12:30",false,"# 17-common-result\n\nStatus: ACTIVE\nAppliesTo: v10\n\n## SSOT\n\n이 문서는 **CommonResult** 규약의 정본이다.\n\n---\n\n## 목적\u002F범위\n\nCommon 레이어에서 \"성공\u002F실패 + 에러\"를 표현하는 표준 Result 컨테이너를 고정한다.\n\n- 결과 타입: `CommonResult\u003CT>`\n- 에러 타입: `CommonError`\n- 주 용도: public\u002Fboundary API의 recoverable failure 전달\n\n경계 분리:\n- Game table lookup \u002F Ability factory \u002F Game 도메인 규칙 실패는 [21-domain-game\u002F15-game-result](..\u002F..\u002F21-domain-game\u002F15-game-result\u002FSKILL.md)의 `GameResult`를 사용한다.\n\n---\n\n## Runtime Type: CommonResult\u003CT>\n\n### 정의\n\n`CommonResult\u003CT>`는 다음을 포함한다.\n\n- `Value: T?`\n- `Error: CommonError?`\n- `IsSuccess \u002F IsFailure` 등의 판정 프로퍼티\n\n### 생성 규칙(개념)\n\n- 성공:\n  - `CommonResult\u003CT>.Success(value)`\n- 실패:\n  - `CommonResult\u003CT>.Failure(CommonError error)`\n  - `CommonResult\u003CT>.Failure(COMMON_ERROR_TYPE errorType, string message, string? details = null)`\n\nHard Rule:\n- 실패 생성 시 `CommonError.Code`는 반드시 `COMMON_ERROR_TYPE` 기반이어야 한다.\n- string 기반 error code는 정식 경로로 사용하지 않는다.\n- `COMMON_ERROR_TYPE.SUCCESS`(reserved, `0`)를 실패 코드로 사용하지 않는다.\n- 예상 가능한 validation \u002F lookup \u002F restore 실패는 `throw`보다 `CommonResult.Failure(...)`를 우선한다.\n\nBoundary-First Rule:\n- public API, data boundary, config parse, save\u002Fload, Common table lookup은 `CommonResult`를 우선한다.\n- private\u002Finternal helper는 이미 검증된 내부 invariant가 깨질 때만 예외를 허용할 수 있다.\n- helper 예외를 이유 없이 public API의 기본 실패 모델로 승격시키지 않는다.\n\n대표 경계:\n- Common config parse\u002Flookup\n- save payload deserialize\n- first-init config parse\n- SaveData codec (GameResult → CommonResult 변환: `ToCommonResult` 헬퍼)\n- LoginManager (Game manager 호출 결과를 CommonResult로 변환하여 전달)\n\n레거시(string code) Failure 오버로드가 남아있다면:\n- `COMMON_ERROR_TYPE.COMMON_UNKNOWN`으로 매핑하고\n- `Details`에 `legacyCode=...`를 보존한다.\n\n---\n\n## 소비 규칙\n\n- 호출부는 `IsFailure`\u002F`IsSuccess`로 분기한다.\n- 실패 시 `Error`는 null이 아니어야 한다(불변식 유지).\n- 성공 시 `Error`는 null이어야 하며, 성공을 `COMMON_ERROR_TYPE.SUCCESS`로 대체 표현하지 않는다.\n- 외부 응답\u002F프로토콜에서 numeric code `0`(success)를 받는 경우:\n  - `CommonError`를 만들지 말고 `CommonResult` 성공으로 매핑한다.\n- recover 가능한 경계 실패를 `catch` 없이 예외 전파에 의존하지 않는다.\n\n---\n\n## DoD\n\nHard\n- `CommonResult\u003CT>` 실패는 `CommonError(COMMON_ERROR_TYPE, ...)` 기반으로 표현됨\n- 성공은 `Error == null`로 표현되며 `COMMON_ERROR_TYPE.SUCCESS`를 `Failure(...)`에 사용하지 않음\n- public\u002Fboundary failure 모델이 `throw` 대신 `CommonResult`로 유지됨\n\nSoft\n- 없음\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian\u002F20-domain-common\u002F17-common-result","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add devwinsoft\u002Fdevian --skill 17-common-result",{"tool":37,"command":38},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 17-common-result",{"tool":40,"command":41},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 17-common-result","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F20-domain-common\u002F17-common-result\u002FSKILL.md",true,[45,51],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"agents\u002Fopenai.yaml","REFERENCE","参考文档",134,"https:\u002F\u002Fgithub.com\u002Ffernando-delosrios-sp\u002Fsailpoint-utils\u002Fblob\u002Fmain\u002FEntro\u002Fentro-connect\u002F.agents\u002Fskills\u002Fchangelog-generator\u002Fagents\u002Fopenai.yaml",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"reference.md",3517,"https:\u002F\u002Fgithub.com\u002Ffernando-delosrios-sp\u002Fsailpoint-utils\u002Fblob\u002Fmain\u002FEntro\u002Fentro-connect\u002F.agents\u002Fskills\u002Fchangelog-generator\u002Freference.md",[56,62,70,78,87,94],{"skillNo":57,"name":58,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":20},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[58],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":20},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[68,69],"archive","90 project archive",{"skillNo":71,"name":72,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":20},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[76,77],"management","30 env management",{"skillNo":79,"name":80,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":20},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[84,85,86],"push","page","19 page push send",{"skillNo":88,"name":89,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":20},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[85,93],"18 page savedata",{"skillNo":95,"name":96,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":20},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[85,100],"17 page deobfuscate"]