ZJUZhiyuCai/seek-zju-alumni-workflow

# Seek-ZJU 校友情报工作流 Skill 这是一个给 Codex 使用的可安装 Skill，用来搭建和维护“校友发现 → 证据核验 → 身份去重 → 联系方式补强 → 中文 Excel 外发”的完整工作流。 它提炼自一个长期运行的浙大 AI/CS 校友项目，但仓库只保留通用方法、合成示例、模板和验证脚本，不包含真实姓名、联系方式、数据库凭证或私有历史产物。 ## 它解决什么问题 校友项目最容易失控的地方不是搜索，而是口径：候选人数、确认人数、外发人数混在一起；普通证据页被误判成联系方式；同名或共享端点把多人合并；每一版 Excel 都有不同列和不同人数。 这个 Skill 把工作拆成五层： source profile -> candidate -> verified identity / person -> person-bound contact -> frozen delivery workbook 并强制执行这些规则： - discovery 先进入候选层，不直接创建 person。 - 姓名只能召回，不能单键合并。 - A1 必须有明确归属本人的公开联系入口。 - 信息缺失可以保留，身份错配必须阻断。 - 默认只读，先 dry-run；真实 apply 必须按具体批次明确批准。 - DB 人数、候选人数、来源档案数和 Excel 外发人数分别记账。 ## 安装 使用 Codex 自带的 skill-installer： python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-installer/scripts/install-skill-from-github.py" \ --repo ZJUZhiyuCai/seek-zju-alumni-workflow \ --path skill/seek-zju-alumni-workflow 安装后在新的任务或下一轮对话中使用： 使用 $seek-zju-alumni-workflow 盘点这个校友项目，先建立人数总账和质量债清单，不写数据库。 也可以手工安装： git clone https://github.com/ZJUZhiyuCai/seek-zju-alumni-workflow.git cp -R seek-zju-alumni-workflow/skill/seek-zju-alumni-workflow \ "${CODEX_HOME:-$HOME/.codex}/skills/" ## 典型用法 ### 从零初始化 python3 ~/.codex/skills/seek-zju-alumni-workflow/scripts/init_workspace.py \ --root ./my-alumni-project \ --project-name "某大学 AI 校友项目" \ --organization "某大学校友会" 会生成干净的目录、当前 facts、候选账本和反馈模板。 ### 验证候选表 python3 ~/.codex/skills/seek-zju-alumni-workflow/scripts/validate_candidate_csv.py \ ./data/candidate-ledger.csv 检查稳定 ID、A1 联系方式门禁、证据缺失、重复联系方式和分层值。 ### 验证外发 Excel python3 -m pip install openpyxl python3 ~/.codex/skills/seek-zju-alumni-workflow/scripts/validate_delivery_workbook.py \ ./output/delivery/final.xlsx 检查内部 sheet 泄漏、字段缺失、重复记录编号、A1 空联系方式和普通证据页误判。 ## 推荐提示词 使用 $seek-zju-alumni-workflow： 1. 读取当前状态和所有历史资产，区分 source_profiles、candidates、persons、contacts 和外发人数。 2. 先做只读 inventory，不新增 discovery，不写 DB。 3. 输出历史未消化资产、同名/端点冲突、证据缺口和可升档队列。 4. 任何 apply 都先生成逐行 dry-run，等我按具体批次批准。 5. 最终生成中文、人话字段、联系方式靠右的校友会 workbook，并给出 GO/NO-GO。 ## 仓库结构 skill/seek-zju-alumni-workflow/ SKILL.md Codex 主指令 agents/openai.yaml Skill UI 元数据 references/ 数据模型、证据、批次和 Excel 门禁 scripts/ 初始化和确定性验证脚本 assets/ 合成模板与示例 tests/ 单元测试 .github/workflows/ 持续验证 ## 本地验证 python3 -m pip install -r requirements.txt python3 skill/seek-zju-alumni-workflow/scripts/validate_repository.py . python3 -m unittest discover -s tests -v ## 边界 - 这是工作流 Skill，不捆绑特定搜索 API、爬虫供应商或数据库 schema。 - Codex 应根据当前环境选择搜索、浏览器、学术图谱和表格工具。 - 真实个人数据应保留在使用者自己的受控环境，不提交到本仓库。 - 对外联系前仍需人工打开来源页，确认身份、归属和联系方式新鲜度。 ## 许可证 MIT License。

标签：Codex Skill, SOC Prime, 开发工具, 逆向工具