knowme-careerforge-skill 0.0.7 → 0.0.8

package/scripts/pipeline/forge.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Run an isolated user-input resume build with explicit artifact and QA states."""
+"""Build a verified resume in isolation; retain only delivery files unless archiving is requested."""
 import argparse
 import contextlib
 import copy
@@ -53,7 +53,7 @@ def file_hash(path):
 def publish_aliases(pairs):
     """Stage every requested copy before publishing; rollback ordinary write failures.
 
-    The run directory remains canonical. Lock files reject concurrent publishers
+    Source bytes have already passed QA. Lock files reject concurrent publishers
     to the same requested destination instead of interleaving their outputs.
     """
     staged, locks, replaced = [], [], []
@@ -97,8 +97,11 @@ class Parser(argparse.ArgumentParser):
 
 def main():
     parser = Parser(description=__doc__)
-    parser.add_argument('--profile-json', required=True, help='User/Agent supplied facts or Draft/Master document; never a repository')
-    parser.add_argument('--workspace', default='workspace/runs', help='Parent directory for unique run directories')
+    inputs = parser.add_mutually_exclusive_group(required=True)
+    inputs.add_argument('--profile-json', help='User/Agent facts file, or - to read JSON from stdin without saving an input file')
+    inputs.add_argument('--html-input', help='Existing edited canvas file, or - for HTML on stdin; validates and publishes the pair without reconstructing a profile')
+    parser.add_argument('--workspace', help='Explicit archive parent; implies --keep-workspace (legacy behavior)')
+    parser.add_argument('--keep-workspace', action='store_true', help='Retain full diagnostic runs under --workspace or workspace/runs; default uses temporary staging')
     parser.add_argument('--draft', action='store_true', help='Create an incomplete draft canvas without claiming PDF delivery')
     parser.add_argument('--role')
     parser.add_argument('--jd', help='Optional JD path or inline text; used only as highlighting/search hints')
@@ -106,95 +109,133 @@ def main():
     parser.add_argument('--font-preset', choices=('system', 'arial-unicode'), default='system', help='Explicit local font choice; missing fonts fail verification')
     for key in ('name', 'email', 'phone'):
         parser.add_argument('--' + key)
-    parser.add_argument('--output', '-o', help='Optional verified PDF copy; default is the isolated run PDF')
-    parser.add_argument('--html-output', help='Optional verified HTML copy; default is the isolated run canvas')
+    parser.add_argument('--output', '-o', help='Verified PDF destination; default resume/resume.pdf in clean mode')
+    parser.add_argument('--html-output', help='HTML destination; default beside the PDF, or resume/draft.html for Draft')
     parser.add_argument('--expected-pages', type=int, choices=(1, 2), default=1)
     parser.add_argument('--auto-heal', action='store_true')
     parser.add_argument('--quiet', '-q', action='store_true')
-    parser.add_argument('--summary', action='store_true', help='Compact report with manifest path; full diagnostics stay on disk')
+    parser.add_argument('--summary', action='store_true', help='Compact report (default in clean mode); manifest exists only for archived runs')
     args = parser.parse_args()
+    if (args.profile_json == '-' or args.html_input == '-') and sys.stdin.isatty():
+        parser.error('Stdin input is required; pipe the prepared JSON/HTML or provide an input file')
+    if args.draft and args.output:
+        parser.error('--output is a PDF destination and cannot be used with --draft')
+    if args.html_input is not None and (any(getattr(args, key) is not None for key in ('role', 'jd', 'template', 'name', 'email', 'phone')) or args.font_preset != 'system'):
+        parser.error('Existing HTML keeps its own content, template and fonts; edit the canvas instead of passing profile overrides')
+    retained = args.keep_workspace or args.workspace is not None
+    try:
+        if not retained:
+            if args.draft:
+                args.html_output = args.html_output or 'resume/draft.html'
+            else:
+                args.output = args.output or str(Path(args.html_output).with_suffix('.pdf') if args.html_output else Path('resume/resume.pdf'))
+                args.html_output = args.html_output or str(Path(args.output).with_suffix('.html'))
+    except ValueError as error:
+        parser.error(str(error))
     report = {'schemaVersion': '1.0', 'runId': uuid.uuid4().hex, 'status': 'RUNNING',
               'stage': 'input', 'errors': [], 'warnings': [], 'checks': {}, 'outputs': {}}
     run = None
+    temporary = None
     exit_code = 1
     try:
-        parent = Path(args.workspace).resolve()
-        parent.mkdir(parents=True, exist_ok=True)
-        run = parent / report['runId']
-        run.mkdir(mode=0o700)
-        report['runDirectory'] = str(run)
+        if retained:
+            parent = Path(args.workspace or 'workspace/runs').resolve()
+            parent.mkdir(parents=True, exist_ok=True)
+            run = parent / report['runId']
+            run.mkdir(mode=0o700)
+        else:
+            temporary = tempfile.TemporaryDirectory(prefix='knowme-run-')
+            run = Path(temporary.name).resolve()
+        report['retention'] = 'archived' if retained else 'temporary'
+        report['runDirectory'] = str(run) if retained else None
         report['startedAt'] = datetime.now(timezone.utc).isoformat()
         write_json(run / 'manifest.json', report)
-        source = Path(args.profile_json).resolve()
+        input_arg = args.profile_json if args.profile_json is not None else args.html_input
+        source = None if input_arg == '-' else Path(input_arg).resolve()
         aliases = [Path(p).resolve() for p in (args.html_output, args.output) if p]
-        if len(set([source] + aliases)) != len([source] + aliases):
+        paths = ([source] if source is not None else []) + aliases
+        if len(set(paths)) != len(paths):
             raise ValueError('Input, HTML and PDF output paths must be distinct')
         for target in aliases:
             if target == run or run in target.parents:
                 raise ValueError('Explicit output cannot replace an internal run artifact')
-        raw_bytes = source.read_bytes()
-        atomic_write(run / 'input.json', raw_bytes)
-        supplied = contract.load_document(json.loads(raw_bytes))
-        if supplied['kind'] == 'variant':
-            raise ValueError('A Variant is not a Master; use its original Master to derive another resume')
-        if supplied['kind'] == 'draft' and not args.draft:
-            raise ValueError('Draft input cannot be delivered; review facts and provide a Master, or use --draft')
-        facts = copy.deepcopy(supplied['profile'])
-        for key in ('name', 'email', 'phone'):
-            if getattr(args, key) is not None:
-                facts['basics'][key] = getattr(args, key)
-        kind = 'draft' if args.draft else 'master'
-        master = contract.document(kind, facts, {'type': 'user-input', 'path': str(source),
-                     'inputSha256': hashlib.sha256(raw_bytes).hexdigest(),
-                     'suppliedKind': supplied['kind'], 'suppliedSource': supplied['source']})
-        write_json(run / (kind + '.json'), master)
-        report['checks']['missingFields'] = master['missingFields']
-        report['warnings'].extend('Missing optional contact/position field: ' + v for v in master['missingFields'] if v != 'basics.name')
-        if not args.draft:
-            errors = contract.delivery_errors(master['profile'])
-            if errors:
-                raise ValueError('; '.join(errors))
-        profile = copy.deepcopy(master['profile'])
-        if args.role is not None:
-            profile['basics']['title'] = args.role
-        keywords = []
-        if args.jd:
-            report['stage'] = 'jd'
-            try:
-                jd_file = Path(args.jd)
-                jd = jd_file.read_text(encoding='utf-8') if jd_file.is_file() else args.jd
-            except OSError:
-                jd = args.jd
-            atomic_write(run / 'jd.txt', jd)
-            analyzer = load_module('jd_analyzer', 'evidence/analyze-jd.py')
-            with contextlib.redirect_stdout(io.StringIO()):
-                result = analyzer.analyze_jd_text(jd)
-            write_json(run / 'jd-analysis.json', result)
-            keywords = result.get('detectedSkills', [])
-        report['stage'] = 'template'
-        template = args.template
-        if not template:
-            search = load_module('template_search', 'template/search-template.py')
-            with contextlib.redirect_stdout(io.StringIO()):
-                results = search.search_templates(role=args.role or profile['basics'].get('title') or '',
-                                                  keywords=','.join(keywords), target_pages=args.expected_pages, engine='hybrid')
-            if not results:
-                raise ValueError('No matching template available')
-            template = results[0].get('id') or results[0]['template']['id']
-        variant = contract.document('draft' if args.draft else 'variant', profile,
-                     {'masterSha256': master['profileSha256'], 'masterPath': str(run / (kind + '.json')),
-                      'template': template, 'targetRole': args.role, 'fontPreset': args.font_preset})
-        variant_path = run / ('draft-canvas-profile.json' if args.draft else 'variant.json')
-        write_json(variant_path, variant)
-        report['templateUsed'] = template
-        report['fontPreset'] = args.font_preset
-        report['stage'] = 'binding'
-        inst = load_module('instantiate_resume', 'template/instantiate-resume.py')
+        raw_bytes = sys.stdin.read().encode('utf-8') if source is None else source.read_bytes()
         canvas, pdf = run / 'resume.html', run / 'resume.pdf'
-        with contextlib.redirect_stdout(io.StringIO()):
-            inst.instantiate_workspace(template, str(variant_path), ','.join(keywords), str(canvas), font_preset=args.font_preset)
+        if args.html_input is not None:
+            report.update(stage='binding', templateUsed='existing-canvas', fontPreset='existing', inputMode='html')
+            atomic_write(run / 'input.html', raw_bytes)
+            atomic_write(canvas, raw_bytes)
+        else:
+            atomic_write(run / 'input.json', raw_bytes)
+            supplied = contract.load_document(json.loads(raw_bytes))
+            if supplied['kind'] == 'variant':
+                raise ValueError('A Variant is not a Master; use its original Master to derive another resume')
+            if supplied['kind'] == 'draft' and not args.draft:
+                raise ValueError('Draft input cannot be delivered; review facts and provide a Master, or use --draft')
+            facts = copy.deepcopy(supplied['profile'])
+            for key in ('name', 'email', 'phone'):
+                if getattr(args, key) is not None:
+                    facts['basics'][key] = getattr(args, key)
+            kind = 'draft' if args.draft else 'master'
+            master = contract.document(kind, facts, {'type': 'user-input', 'path': str(source) if source else None, 'inputMode': 'file' if source else 'stdin',
+                         'inputSha256': hashlib.sha256(raw_bytes).hexdigest(),
+                         'suppliedKind': supplied['kind'], 'suppliedSource': supplied['source']})
+            write_json(run / (kind + '.json'), master)
+            report['checks']['missingFields'] = master['missingFields']
+            report['warnings'].extend('Missing optional contact/position field: ' + v for v in master['missingFields'] if v != 'basics.name')
+            if not args.draft:
+                errors = contract.delivery_errors(master['profile'])
+                if errors:
+                    raise ValueError('; '.join(errors))
+            profile = copy.deepcopy(master['profile'])
+            if args.role is not None:
+                profile['basics']['title'] = args.role
+            keywords = []
+            if args.jd:
+                report['stage'] = 'jd'
+                try:
+                    jd_file = Path(args.jd)
+                    jd = jd_file.read_text(encoding='utf-8') if jd_file.is_file() else args.jd
+                except OSError:
+                    jd = args.jd
+                atomic_write(run / 'jd.txt', jd)
+                analyzer = load_module('jd_analyzer', 'evidence/analyze-jd.py')
+                with contextlib.redirect_stdout(io.StringIO()):
+                    result = analyzer.analyze_jd_text(jd)
+                write_json(run / 'jd-analysis.json', result)
+                keywords = result.get('detectedSkills', [])
+            report['stage'] = 'template'
+            template = args.template
+            if not template:
+                search = load_module('template_search', 'template/search-template.py')
+                with contextlib.redirect_stdout(io.StringIO()):
+                    results = search.search_templates(role=args.role or profile['basics'].get('title') or '',
+                                                      keywords=','.join(keywords), target_pages=args.expected_pages, engine='hybrid')
+                if not results:
+                    raise ValueError('No matching template available')
+                template = results[0].get('id') or results[0]['template']['id']
+            variant = contract.document('draft' if args.draft else 'variant', profile,
+                         {'masterSha256': master['profileSha256'], 'masterPath': str(run / (kind + '.json')),
+                          'template': template, 'targetRole': args.role, 'fontPreset': args.font_preset})
+            variant_path = run / ('draft-canvas-profile.json' if args.draft else 'variant.json')
+            write_json(variant_path, variant)
+            report['templateUsed'] = template
+            report['fontPreset'] = args.font_preset
+            report['stage'] = 'binding'
+            inst = load_module('instantiate_resume', 'template/instantiate-resume.py')
+            with contextlib.redirect_stdout(io.StringIO()):
+                inst.instantiate_workspace(template, str(variant_path), ','.join(keywords), str(canvas), font_preset=args.font_preset)
         if args.draft:
-            report.update(status='DRAFT', stage='draft', outputs={'draft': str(run / 'draft.json'), 'htmlCanvas': str(canvas)})
+            if args.html_output:
+                report['stage'] = 'publish'
+                publish_aliases([(canvas, Path(args.html_output).resolve())])
+            draft_outputs = {'htmlCanvas': str(canvas)}
+            if args.profile_json is not None:
+                draft_outputs['draft'] = str(run / 'draft.json')
+            report.update(status='DRAFT', stage='draft', outputs=draft_outputs)
+            if not retained:
+                report['outputs'] = {'htmlCanvas': str(Path(args.html_output).resolve())}
+            report['sha256'] = {'html': file_hash(canvas)}
             exit_code = 0
         else:
             report['stage'] = 'qa'
@@ -244,11 +285,16 @@ def main():
             if args.output:
                 pairs.append((pdf, Path(args.output).resolve()))
             publish_aliases(pairs)
-            report.update(status='PASS', stage='complete', outputs={
-                'master': str(run / 'master.json'), 'variant': str(variant_path),
-                'htmlCanvas': str(canvas), 'pdfDelivery': str(pdf), 'qa': str(run / 'qa.json'),
-                'copies': [str(target) for _, target in pairs]},
-                sha256={'html': file_hash(canvas), 'pdf': file_hash(pdf), 'master': master['profileSha256']})
+            outputs = {'htmlCanvas': str(canvas), 'pdfDelivery': str(pdf), 'qa': str(run / 'qa.json'),
+                       'copies': [str(target) for _, target in pairs]}
+            hashes = {'html': file_hash(canvas), 'pdf': file_hash(pdf)}
+            if args.profile_json is not None:
+                outputs.update(master=str(run / 'master.json'), variant=str(variant_path))
+                hashes['master'] = master['profileSha256']
+            report.update(status='PASS', stage='complete', outputs=outputs, sha256=hashes)
+            if not retained:
+                report['outputs'] = {'htmlCanvas': str(Path(args.html_output).resolve()),
+                                     'pdfDelivery': str(Path(args.output).resolve())}
             exit_code = 0
     except Exception as error:
         if report['status'] == 'RUNNING':
@@ -258,22 +304,50 @@ def main():
         exit_code = 2 if report['status'] == 'UNVERIFIED' else 1
     finally:
         report['finishedAt'] = datetime.now(timezone.utc).isoformat()
-        if run:
+        if run and retained:
             try:
                 write_json(run / 'manifest.json', report)
             except OSError as error:
                 report.update(status='FAIL', outputs={})
                 report['errors'].append('Could not persist manifest: ' + str(error))
                 exit_code = 1
+        if temporary:
+            try:
+                temporary.cleanup()
+            except OSError as error:
+                report['warnings'].append('Temporary staging cleanup failed: ' + str(error))
         emitted = report
-        if args.summary:
-            emitted = {key: report[key] for key in ('runId', 'status', 'stage', 'templateUsed', 'fontPreset', 'errors', 'warnings', 'outputs') if key in report}
+        if args.summary or not retained:
+            emitted = {key: report[key] for key in ('runId', 'status', 'stage', 'retention', 'templateUsed', 'fontPreset', 'errors', 'warnings', 'outputs', 'sha256') if key in report}
             emitted['outputs'] = {}
             if report['status'] in ('PASS', 'DRAFT'):
-                emitted['outputs']['html'] = str(Path(args.html_output).resolve()) if report['status'] == 'PASS' and args.html_output else report['outputs']['htmlCanvas']
+                emitted['outputs']['html'] = str(Path(args.html_output).resolve()) if args.html_output else report['outputs']['htmlCanvas']
             if report['status'] == 'PASS':
                 emitted['outputs']['pdf'] = str(Path(args.output).resolve()) if args.output else report['outputs']['pdfDelivery']
-            emitted['manifest'] = str(run / 'manifest.json') if run else None
+            emitted['manifest'] = str(run / 'manifest.json') if run and retained else None
+            if report['status'] in ('FAIL', 'UNVERIFIED'):
+                failed_checks = report['checks'].get('qa', {}).get('checks', {})
+                details = {}
+                for key, check in failed_checks.items():
+                    if check.get('status') != 'PASS':
+                        details[key] = {'status': check.get('status')}
+                        if key == 'dom':
+                            if 'totalPagesFound' in check:
+                                details[key]['totalPagesFound'] = check['totalPagesFound']
+                            for field in ('issues', 'unsupported'):
+                                if isinstance(check.get(field), list):
+                                    details[key][field + 'Count'] = len(check[field])
+                                    details[key][field] = check[field][:20]
+                        if key == 'pdf':
+                            for field in ('pageCount', 'pages'):
+                                if field in check:
+                                    details[key][field] = check[field]
+                        if key == 'text' and isinstance(check.get('pages'), list):
+                            details[key]['pages'] = [
+                                {field: page[field] for field in ('pageIndex', 'missingCodepoints', 'missingFragments', 'extractedRadicals') if field in page}
+                                for page in check['pages'] if isinstance(page, dict)]
+                if details:
+                    emitted['diagnostics'] = details
         print(json.dumps(emitted, ensure_ascii=False, indent=None if args.quiet else 2))
     return exit_code
 

package/scripts/rendering/browser-engine.js

@@ -74,13 +74,17 @@ function inspectDOM() {
         continue;
       }
       if (e !== p) for (const r of e.getClientRects()) check(r, e.parentElement);
+      const tt = window.getComputedStyle(e).textTransform;
       for (const node of e.childNodes) {
         if (node.nodeType !== Node.TEXT_NODE || !node.textContent.trim()) continue;
         const range = document.createRange();
         range.selectNodeContents(node);
         const rs = [...range.getClientRects()];
         if (!rs.length) continue;
-        text.push(node.textContent);
+        const transformed = tt === 'uppercase' ? node.textContent.toUpperCase() :
+                            tt === 'lowercase' ? node.textContent.toLowerCase() :
+                            node.textContent;
+        text.push(transformed);
         for (const r of rs) check(r, e);
       }
     }

package/scripts/template/instantiate-resume.py

@@ -160,12 +160,14 @@ def render_profile_into_html(html_str, profile, keywords=None, *, css=""):
             heading += "".join(field(item, k, "role-badge", "span") for k in ("role", "degree", "field"))
             heading += dates(item)
             content = f'<div class="item-header">{heading}</div>' if heading else ""
-            content += field(item, "location") + field(item, "summary")
+            content += field(item, "location", "item-location fact-text") + field(item, "summary", "item-summary fact-text")
             gpa = item.get("gpa")
             if gpa is not None and gpa != "":
                 content += element("p", "edu-detail", f"GPA: {gpa}")
-            content += field(item, "repoUrl") + field(item, "demoUrl")
-            content += "".join(element("span", "tech-tag", t) for t in strings(item, "techStack"))
+            content += field(item, "repoUrl", "project-url fact-text") + field(item, "demoUrl", "project-url fact-text")
+            tags = "".join(element("span", "tech-tag", t) for t in strings(item, "techStack"))
+            if tags:
+                content += f'<div class="tech-stack-tags">{tags}</div>'
             content += "".join(element("p", "edu-detail", honor) for honor in strings(item, "honors"))
             content += bullets(item)
             if content:

package/skill.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/skill.json",
   "name": "knowme-careerforge",
   "displayName": "KnowMe CareerForge",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "An agent-native skill for self-discovery, career positioning, and tailored resume engineering. Know yourself. Define your direction. Forge your opportunity.",
   "author": "Miles <https://github.com/Max-Samson>",
   "license": "MIT",

package/src/knowledge/career/seniority-signals.json

@@ -1,4 +1,5 @@
 {
+  "usage": "职级仅提供关注角度。动词依据实际职责选择，指标仅作为追问方向；不由年限或目标职级推断主导权、成果和熟练度。",
   "levels": {
     "junior": {
       "focus": "执行力、任务交付、代码质量与基础扎实度",

package/src/knowledge/index.json

@@ -1,7 +1,7 @@
 {
-  "version": "0.0.7",
+  "version": "0.0.8",
   "totalRoles": 9,
-  "totalTemplates": 10,
+  "totalTemplates": 13,
   "roles": [
     {
       "id": "ai-agent-engineer",
@@ -795,6 +795,63 @@
         "--resume-space-section"
       ]
     },
+    {
+      "id": "editorial",
+      "name": "Editorial · 经历叙事",
+      "version": "1.0.0",
+      "style": "single-column-editorial",
+      "roleCategory": "professional",
+      "description": "经历优先，左侧章节索引与右侧正文对齐；适合已有连续工作经历的候选人。",
+      "layout": {
+        "type": "single-column",
+        "targetPages": 1,
+        "maxPages": 1,
+        "density": "balanced"
+      },
+      "visualStyle": {
+        "tone": "editorial-readable",
+        "accentColor": "#254665",
+        "fontFamily": "System Sans-Serif"
+      },
+      "atsScoreTier": "tier-1-optimal",
+      "supportedRoles": [
+        "professional",
+        "consultant"
+      ],
+      "languages": [
+        "zh-CN",
+        "en-US"
+      ],
+      "customizableTokens": [
+        "--resume-font-size-body",
+        "--resume-line-height-body",
+        "--resume-space-section",
+        "--resume-space-item",
+        "--resume-space-bullet",
+        "--resume-color-accent"
+      ],
+      "directory": "src/templates/editorial",
+      "detectedTokens": [
+        "--resume-color-accent",
+        "--resume-color-border",
+        "--resume-color-muted",
+        "--resume-color-primary",
+        "--resume-color-secondary",
+        "--resume-color-tag-bg",
+        "--resume-font-body",
+        "--resume-font-size-body",
+        "--resume-font-size-h2",
+        "--resume-font-size-meta",
+        "--resume-font-size-name",
+        "--resume-font-size-target",
+        "--resume-line-height-body",
+        "--resume-page-padding",
+        "--resume-space-bullet",
+        "--resume-space-header-bottom",
+        "--resume-space-item",
+        "--resume-space-section"
+      ]
+    },
     {
       "id": "executive",
       "name": "Executive Modern Split",
@@ -849,6 +906,7 @@
         "--resume-font-size-body",
         "--resume-font-size-meta",
         "--resume-font-size-name",
+        "--resume-font-size-target",
         "--resume-font-size-title",
         "--resume-left-col-width",
         "--resume-line-height-body",
@@ -857,6 +915,65 @@
         "--resume-space-section"
       ]
     },
+    {
+      "id": "graduate",
+      "name": "Graduate · 校园起点",
+      "version": "1.0.0",
+      "style": "single-column-education-first",
+      "roleCategory": "early-career",
+      "description": "教育与项目优先，宽松单栏；适合应届生、实习申请和较少工作经历。",
+      "layout": {
+        "type": "single-column",
+        "targetPages": 1,
+        "maxPages": 1,
+        "density": "balanced"
+      },
+      "visualStyle": {
+        "tone": "editorial-readable",
+        "accentColor": "#0f766e",
+        "fontFamily": "System Sans-Serif"
+      },
+      "atsScoreTier": "tier-1-optimal",
+      "supportedRoles": [
+        "graduate",
+        "intern",
+        "应届",
+        "实习"
+      ],
+      "languages": [
+        "zh-CN",
+        "en-US"
+      ],
+      "customizableTokens": [
+        "--resume-font-size-body",
+        "--resume-line-height-body",
+        "--resume-space-section",
+        "--resume-space-item",
+        "--resume-space-bullet",
+        "--resume-color-accent"
+      ],
+      "directory": "src/templates/graduate",
+      "detectedTokens": [
+        "--resume-color-accent",
+        "--resume-color-border",
+        "--resume-color-muted",
+        "--resume-color-primary",
+        "--resume-color-secondary",
+        "--resume-color-tag-bg",
+        "--resume-font-body",
+        "--resume-font-size-body",
+        "--resume-font-size-h2",
+        "--resume-font-size-meta",
+        "--resume-font-size-name",
+        "--resume-font-size-target",
+        "--resume-line-height-body",
+        "--resume-page-padding",
+        "--resume-space-bullet",
+        "--resume-space-header-bottom",
+        "--resume-space-item",
+        "--resume-space-section"
+      ]
+    },
     {
       "id": "international-flow",
       "name": "International Text Flow",
@@ -1046,6 +1163,63 @@
         "--resume-space-section"
       ]
     },
+    {
+      "id": "project-focus",
+      "name": "Project Focus · 项目实践",
+      "version": "1.0.0",
+      "style": "single-column-project-first",
+      "roleCategory": "portfolio",
+      "description": "项目优先，项目条目以细边线分隔；适合项目证据比工作履历更突出的候选人。",
+      "layout": {
+        "type": "single-column",
+        "targetPages": 1,
+        "maxPages": 1,
+        "density": "balanced"
+      },
+      "visualStyle": {
+        "tone": "editorial-readable",
+        "accentColor": "#334155",
+        "fontFamily": "System Sans-Serif"
+      },
+      "atsScoreTier": "tier-1-optimal",
+      "supportedRoles": [
+        "project-engineer",
+        "portfolio"
+      ],
+      "languages": [
+        "zh-CN",
+        "en-US"
+      ],
+      "customizableTokens": [
+        "--resume-font-size-body",
+        "--resume-line-height-body",
+        "--resume-space-section",
+        "--resume-space-item",
+        "--resume-space-bullet",
+        "--resume-color-accent"
+      ],
+      "directory": "src/templates/project-focus",
+      "detectedTokens": [
+        "--resume-color-accent",
+        "--resume-color-border",
+        "--resume-color-muted",
+        "--resume-color-primary",
+        "--resume-color-secondary",
+        "--resume-color-tag-bg",
+        "--resume-font-body",
+        "--resume-font-size-body",
+        "--resume-font-size-h2",
+        "--resume-font-size-meta",
+        "--resume-font-size-name",
+        "--resume-font-size-target",
+        "--resume-line-height-body",
+        "--resume-page-padding",
+        "--resume-space-bullet",
+        "--resume-space-header-bottom",
+        "--resume-space-item",
+        "--resume-space-section"
+      ]
+    },
     {
       "id": "startup-generalist",
       "name": "Startup Generalist Cards",

package/src/knowledge/resume/action-verbs.json

@@ -1,7 +1,8 @@
 {
+  "usage": "按用户实际动作选择动词；分类不代表职级或熟练度，不为了增强语气升级职责。中文优先具体表达，如实现、排查、协调；不用赋能、突破等词替代可描述的行动。",
   "categories": {
     "leadership": [
-      "主导", "统筹", "规划", "搭建", "驱动", "赋能", "重构", "制定",
+      "主导", "统筹", "规划", "搭建", "协调", "组织", "重构", "制定",
       "Spearheaded", "Led", "Architected", "Orchestrated", "Formulated", "Pioneered"
     ],
     "engineering_architecture": [
@@ -9,7 +10,7 @@
       "Designed", "Engineered", "Implemented", "Refactored", "Decoupled", "Migrated"
     ],
     "optimization_performance": [
-      "优化", "缩减", "压榨", "降本", "提速", "消除", "治理", "排查",
+      "优化", "缩减", "分析", "降本", "提速", "消除", "治理", "排查",
       "Optimized", "Reduced", "Accelerated", "Mitigated", "Eliminated", "Benchmarked"
     ],
     "business_impact": [

package/src/knowledge/resume/fab-model.json

@@ -1,6 +1,6 @@
 {
   "model": "FAB (Feature - Advantage - Benefit)",
-  "description": "结构化叙事模型，将经历转化为具有商业与技术说服力的量化论据",
+  "description": "可选写作辅助：组织已有动作、方法与结果；缺失部分省略，不要求量化，不补写经历。",
   "components": {
     "F": {
       "name": "Feature (功能/动作)",
@@ -9,14 +9,15 @@
     },
     "A": {
       "name": "Advantage (优势/技术亮点)",
-      "meaning": "采用了什么先进架构、技术选型或创新解法",
+      "meaning": "用户实际采用的方法、技术或协作方式，不要求先进或创新",
       "example": "基于 LangGraph 状态图与动态路由剪枝机制进行状态流转"
     },
     "B": {
       "name": "Benefit (成效/量化价值)",
-      "meaning": "达成了什么业务提升、延迟降低、成本节约或团队赋能",
+      "meaning": "用户提供的结果，可以是定性变化、交付事实或有依据的指标",
       "example": "实现端到端任务成功率从 68% 提升至 94%，并缩减 Token 成本 35%"
     }
   },
-  "standardBulletFormula": "[强动词] + [Feature 核心系统/项目] + [Advantage 核心技术选型/创新解法] + [Benefit 量化业务/技术成效]"
+  "standardBulletFormula": "[实际职责动词] + [已知动作与对象] + [已知方法，可省略] + [已知结果，可省略]",
+  "usage": "示例为虚构写法，不是候选人事实。依据用户材料选择适合的结构，不把所有条目强制扩成完整 FAB。"
 }

package/src/knowledge/resume-schema.json

@@ -60,7 +60,7 @@
             "string",
             "null"
           ],
-          "description": "Core Value Proposition (15-30 words)"
+          "description": "Optional concise synthesis of supported experience; length follows the language and content, not a fixed word count"
         }
       },
       "additionalProperties": false