Jaxon1216/interview-analyzer-skill / skill/project-interview-skill
project-interview-skill
Verified基于项目描述与仓库证据生成目标简历、完整核心源码课程与项目面经,含学习路线、重点难点 HTML 专题和第一人称回答。 适用于项目分析、面试准备、简历亮点和导学材料。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.3 KB |
| assets/topic.html | other | 6.4 KB |
| references/examples/bullet-few-shots.md | markdown | 10.5 KB |
| references/examples/oral-style-samples.md | markdown | 4.6 KB |
| references/excellent-resumes/README.md | markdown | 1.6 KB |
| references/excellent-resumes/ai4se-agent-infra.md | markdown | 4.9 KB |
| references/excellent-resumes/deer-flow-harness.md | markdown | 5.4 KB |
| references/excellent-resumes/susu-bullet-template.md | markdown | 6.1 KB |
| references/rules/course-design.md | markdown | 9.3 KB |
| references/rules/html-teaching.md | markdown | 3.3 KB |
| references/rules/internal-terms.md | markdown | 4.6 KB |
| references/rules/interview-rubric.md | markdown | 1.7 KB |
| references/rules/oral-and-resume-patterns.md | markdown | 13.8 KB |
| references/rules/repository-investigation.md | markdown | 6.0 KB |
| references/rules/star-framework.md | markdown | 4.4 KB |
| references/templates/output-templates.md | markdown | 5.7 KB |
| scripts/build_prompt.py | script | 13.5 KB |
| scripts/check_inputs.py | script | 5.2 KB |
| scripts/validate_output.py | script | 12.8 KB |
scripts/build_prompt.py
View on GitHub#!/usr/bin/env python3
"""
Build a prompt for the project guide, interview notes, lessons, and HTML topics.
Reads fields from CLI flags or a JSON file and prints UTF-8 Markdown for agent consumption.
"""
from __future__ import annotations
import argparse
import json
import sys
from pathlib import Path
from typing import Any
ILLEGAL_SHORT_NAME_CHARS = {"/", "\\", ":", "*", "?", '"', "<", ">", "|"}
def _escape_md(text: str) -> str:
"""Avoid accidental markdown break when embedding user text."""
return text.replace("```", "``\u200b`")
def _validate_short_name(short_name: str) -> str:
"""
Validate directory-safe short name used in interview-prep/{简称}/.
"""
cleaned = short_name.strip()
if not cleaned:
return ""
if cleaned in {".", ".."}:
raise ValueError("short name cannot be '.' or '..'.")
if any(ch in cleaned for ch in ILLEGAL_SHORT_NAME_CHARS):
chars = "".join(sorted(ILLEGAL_SHORT_NAME_CHARS))
raise ValueError(f"short name contains illegal path chars. disallowed: {chars}")
if len(cleaned) > 24:
raise ValueError("short name is too long (max 24 characters).")
return cleaned
def build_prompt(
description: str,
tech_stack: str | None,
role_focus: str | None,
short_name: str | None,
extra: str | None,
) -> str:
"""
Compose the master prompt for the analyzing agent.
Args:
description: Required project description.
tech_stack: Optional stack string.
role_focus: Optional direction; omitted means fullstack.
short_name: Optional short name for `interview-prep/{简称}/`.
extra: Optional free-form notes.
Returns:
Markdown string to paste into a chat or pipe to an LLM.
"""
lines: list[str] = [
"请按 `project-interview-skill` 执行:写入 `interview-prep/{简称}/导学.md`、`面经.md` 与全部核心课程;单项目课程使用 `interview-prep/guide-{方向}/`,多项目输出根目录使用各项目子目录。",
"",
"## 已确认输入",
"",
"### 项目简称(用于目录名)",
"",
]
if short_name and short_name.strip():
lines.append(short_name.strip())
else:
lines.append("_(未提供,请从描述提炼并在写入前写明)_")
lines.extend(["", "### 项目描述(必须)", "", "```text", _escape_md(description.strip()), "```", ""])
lines.append("### 技术栈(可选)")
lines.append("")
if tech_stack and tech_stack.strip():
lines.append("```text")
lines.append(_escape_md(tech_stack.strip()))
lines.append("```")
else:
lines.append("_(未提供,请合理推断并列出假设)_")
lines.append("")
lines.append("### 求职方向(可选)")
lines.append("")
if role_focus and role_focus.strip():
lines.append(role_focus.strip())
else:
lines.append("_(未提供,默认全栈;课程目录 guide-fullstack,按真实源码调整比重)_")
lines.append("")
if extra and extra.strip():
lines.append("### 补充说明")
lines.append("")
lines.append(extra.strip())
lines.append("")
lines.extend(
[
"## 输出要求(摘要)",
"",
"- 选材:按 references/rules/repository-investigation.md 从完整范围识别核心职责、主要状态和组件分工,查证系统机制后再按系统重要性、目标相关性和设计辨识度组织支柱;不把材料分组、目录或接口数量直接当成 bullet 结构。文件读取、权限校验等细节归入所服务的机制,保留解释设计的实现;课程仍覆盖必要核心机制。",
"- 先探索仓库:确认入口与实际技术范围,追踪 2~4 条核心链路,逐条记录问题/演进、已实现机制、失败边界、具体效果、源码/测试相对路径与验证状态;只有用户描述时标明证据限制,不虚构源码、实测指标或旧架构。",
"- 项目简介:用 1~2 句说明产品与核心能力,其下增加 `### 技术栈`,用一行核心技术组合概括实现路线,可用 + 连接;选语言、核心框架及关键基础设施/领域技术,不展开职责分组、依赖版本、客户端包名、标准库 API 或可选配置全集。具体库和 API 按作用放入 bullet,未知技术不猜测。",
"- 面经:先写目标简介与 bullet;每条一级 bullet 独立成行,格式为 `- **具体支柱名:** 正文`,围绕同一使用需求或工程问题连起为什么做、怎么做与具体变化。用职责、协作和行为条件解释因果,复杂机制可分二级;动机可从场景、约束、风险或真实演进表达,不机械套 STAR 或固定四槽。最后填「简历 → 面试展开」表并按表出题。证据不足时缩小主张。",
"- 默认目标简历:仓库已有机制均可入选,不主动核验 commit author;用户明确参与在同等含金量下优先。未实现增强另列进阶,只有明确要求实际贡献时才限制职责。",
"- 证据边界:实现、责任与结果分别归档,责任仅在贡献模式限制入选;有指标时按仓库探索规则保留基线、统计对象、时间窗口、环境/负载、来源与归属,不跨口径计算改善或把工程效果推成业务收益。证据缺口留在索引或相关回答,不塞进简历尾注。",
"- 决策叙述:当前实现不能证明当时比较过方案;历史选型、阶段演进与本人推进过程须有来源,事后替代方案用“现在回看/如果重新设计”表述。第一人称学习口播不补造实验、上线或个人经历。",
"- 面经 bullet:先读 references/excellent-resumes/susu-bullet-template.md 的原文片段,再对照领域中立 few-shot;学习金样如何把设计动机、具体做法与变化相连,以及具体动词和信息分层,禁止复制样例的项目事实、身份或数字。产品背景可在简介共用,各条仍须让读者看懂相应设计的必要性。",
"- Bullet 术语:按 references/rules/oral-and-resume-patterns.md 的技术术语选择,从已核实的框架、库、协议、公开 API 与通用机制中保留能解释关键做法的名称,不因自然中文而泛化成普通动作。具体库可说明用途,不要求人人熟悉;私有类名不充当架构概念。中英文采用更准确自然的一种,不设英文数量、不固定括号翻译,取舍理由不进入简历正文。技术栈只概括核心组合,bullet 解释技术怎样起作用。",
"",
"## Bullet few-shot(仅学习结构,不复制素材)",
"",
"**合格**:- **分层容错:** 将错误处理集中到统一入口,按错误类型选择有限重试、降级或快速失败;为避免重试产生重复副作用,仅对幂等操作重试,各分支统一返回处理结果,调用方无需分别判断底层异常。",
"",
"**不合格**:接入缓存和重试,优化接口请求。",
"",
"**改写原则**:标题点名具体机制,正文连起动机、做法与变化;只有当前实现也可解释其工程目的和应对的风险,不能编造旧架构、事故或当时的选型过程。结果写可验证的架构变化或真实指标,也可写调用方可见的具体能力;作用已融入动作与条件时不重复总结,不把目的当作实测收益,不把待测或测量计划塞进简历。",
"",
"- 面经 bullet 成稿审读:先看整组是否抓住项目核心,再逐条复述为什么需要该设计、如何起作用、改变什么;只能复述实现步骤时补回有依据的动机。保留解释因果的关键实现,删除重复条件与空泛总结。未实现计划、待测尾注放证据记录或相关回答。",
"- 面经 bullet 事实与术语审读:另行核对主张和名称;不可验证的收益直接删除。支柱名使用目标领域熟悉的机制或架构概念;`RunManager`、`Stream Bridge`、`execution id` 等项目实现名与私有函数、路径、内部枚举下沉到源码证据索引。结构或术语通过不能替代成稿审读。",
"- 面经:每条 bullet 至少一组 Q&A,通常 1 主问与 2~4 个递进追问;主问通常 4~10 道,按实际主张调整,追问不计入总数。每题记录 B 编号、简历触发依据、考查目标与 C 课程链接;追问来自简历或前序回答。",
"- 面经:正文重心放在面试题口播,不单独输出「亮点拆解」章节。",
"- 口播:先正面回答,按方案/原理/故障/演进题选择结构;项目口播第一人称,不设统一最低字数,不强制每道追问完整 STAR。",
"- 默认读者能写 CRUD;方向未指定用全栈。基础按需补齐,核心精力用于数据流、特色机制、运行原理、工程质量和设计取舍。",
"- 导学:总览含项目地图、核心课程路线与 B/Q/C 导航;首次完整展开全部核心课程,选读只列入口;课程直接写本课重点、主链、源码阅读、机制边界、需要懂什么、需要记住什么。默认不生成预测、动手验证、实验任务或理解题;用户明确要求时再补充。",
"- HTML 专题:保留完整 Markdown 课程。主会话从本次课程挑 1~3 个有证据、适合展示分支、时序或状态变化的难点,每页讲一个机制;无合适题材可跳过。支持子 agent 的宿主按专题实际委派,否则由主会话沿用同一模板。以 skill 的 assets/topic.html 为模板,写入对应课文目录的 topics/C01-短名.html(用实际课程 ID)。主会话验收后,把相对链接同时写入导学对应路线行第二格和该课课文。",
"- HTML 教学:先确定一个学习成果,用一个实例逐步走到结局;按机制画图,每次操作改变一个主要条件并即时解释原因。遵从 references/rules/html-teaching.md,页面骨架不限定三栏或 radio;默认不强制答题/实验。事实、教学、运行呈现分开验收,不能用分支数或截图通过代替是否好学。",
"- HTML 验收:用无头浏览器走完示例并改变条件,检查反馈、重置、桌面/手机布局和截图,默认不打开用户可见预览;缺少实际浏览器验证就说明限制。新页截图审阅与有历史基线的视觉回归分开报告。",
"- 源码引用:相对文件链接+符号名+必要片段,链接相对当前文档计算;课程反向链接主导学和面经,保留用户笔记。",
"- 源码查证是生成者职责,不转成读者作业;用户明确要求验证材料时才提供测量方法,未执行不写已通过。",
"",
]
)
return "\n".join(lines)
def _load_json(path: Path) -> dict[str, Any]:
raw = path.read_text(encoding="utf-8")
data = json.loads(raw)
if not isinstance(data, dict):
raise ValueError("JSON root must be an object")
return data
def main(argv: list[str] | None = None) -> int:
"""CLI entry point."""
parser = argparse.ArgumentParser(
description="Build consolidated prompt for project-interview-skill."
)
parser.add_argument(
"--description",
"-d",
help="Project description text.",
)
parser.add_argument(
"--short-name",
"-s",
default="",
help="Short name for output directory: interview-prep/{简称}/",
)
parser.add_argument("--tech", default="", help="Technology stack string.")
parser.add_argument(
"--role",
default="",
help="Job direction, e.g. 前端 / 后端 / 全栈 / AI; default 全栈.",
)
parser.add_argument(
"--extra",
default="",
help="Additional notes appended under 补充说明.",
)
parser.add_argument(
"--json-file",
help="Path to JSON with keys: description, short_name?, tech_stack?, role_focus?, extra?.",
)
args = parser.parse_args(argv)
description = args.description or ""
tech = args.tech or ""
role = args.role or ""
short_name = args.short_name or ""
extra = args.extra or ""
if args.json_file:
try:
payload = _load_json(Path(args.json_file))
except (OSError, json.JSONDecodeError, ValueError) as exc:
print(f"Error loading JSON: {exc}", file=sys.stderr)
return 1
description = str(payload.get("description", "")).strip()
tech = str(payload.get("tech_stack", payload.get("tech", ""))).strip()
role = str(payload.get("role_focus", payload.get("role", ""))).strip()
short_name = str(payload.get("short_name", payload.get("简称", ""))).strip()
extra = str(payload.get("extra", "")).strip()
try:
short_name = _validate_short_name(short_name)
except ValueError as exc:
print(f"Error: invalid --short-name: {exc}", file=sys.stderr)
return 1
if not description:
print(
"Error: missing description. Use -d, or --json-file with description field.",
file=sys.stderr,
)
return 1
prompt = build_prompt(
description,
tech or None,
role or None,
short_name or None,
extra or None,
)
sys.stdout.write(prompt)
if not prompt.endswith("\n"):
sys.stdout.write("\n")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |