yichaoli921/china-policy-pilot-search

---

👋 这是什么？

🎯 一个专门面向中国政策研究的 Codex Skill：把政策试点从"中央文件 → 省 → 地市 → 县区"一节一节追踪下来，整理成研究可直接使用的结构化表格。

china-policy-pilot-search 适用于一类反复出现的中国政策研究工作流：

1. 🎯 从一个政策名出发
2. 🔒 锁定官方中央文件与试点年份
3. 🗺️ 按省 × 年拆解
4. 🏛️ 继续深挖到地市与县区证据
5. 🏷️ 地名标准化，留下可追溯的链接与 备注

它特别适合用来做下面这些事情：

• 🔬 DID 样本构建：把"哪一年进入试点"还原成可用的面板
• 📅 试点时间线重建：把零散的官方公告拼成完整时间表
• 🗄️ 政策试点数据库：把反复出现的工作流沉淀成可复用的 Skill

---

✨ 这个 Skill 能帮你做什么？

---

🧭 核心工作流

flowchart TD
    A[🧾 与用户确认政策名与年份窗口] --> B[🔒 锁定中央政策文件与国家试点年份]
    B --> C[🗺️ 逐省展开检索]
    C --> D[🏛️ 恢复地市级试点单位]
    D --> E[🏘️ 深挖县区证据]
    E --> F[🧩 必要时做保守补录]
    F --> G[🏷️ 地名标准化 & 保留证据链接]
    G --> H[📦 导出两张 Excel + 一份 Markdown 检索过程说明]

这套 Skill 在设计上有意把下面三类工具组合在一起：

• 🅱️ 中文搜索引擎：用于广义召回
• 🌐 官方域名检索：用于硬证据
• 🖱️ web-access 工具：用于深层抓取、附件、PDF、XLS、深度官方页面

---

🤝 两个人工确认环节

这个 Skill 在必要时强制设置两个人工确认步骤：

1️⃣ 政策名称确认

• 当政策名容易混淆时（例如口号相近、标题只差一两个字），必须让用户确认实际要研究哪一份官方政策

2️⃣ 年份窗口确认

• 当用户没明确说清楚时，要问用户想要全部试点年份，还是要子集

💡 用户已经清楚给出年份窗口时，就不要反复再问啦～

---

📦 最终交付物

默认固定输出：

1. 📊 市级来源表（city-level source table）
2. 📊 县级主表（county-level master table）
3. 📝 一份简短 Markdown 检索过程说明

🧷 每一条样本都要有一条可追溯的网页链接，可以放在专门的 URL 字段，也可以写在 备注 里。

---

🧪 案例：数字乡村试点

本仓库最早是在 首批国家数字乡村试点 这项任务上跑通的。

那一次的工作流：

1. 🔒 锁定了中央政策通知 & 首批名单公告
2. 🕵️ 发现官方名单是被嵌成"图片"而不是纯文本表格
3. 🖱️ 用 web-access 把图片源恢复回来
4. 🧱 把首批名单整理成：
   • 市级来源工作簿
   • 县级主工作簿
   • 一份简短的 Markdown 检索过程说明

这个案例的价值在于：它说明这个 Skill 处理"图片嵌入名单"这种困难官方格式也没问题，不只是能处理干净的文本附件 ✨

---

🚀 快速上手

下面是一份极简的上手引导，详细规则请翻阅仓库内的说明文件。

0️⃣ 前置准备

• ✅ 已安装 Codex（或支持 Skill 的 AI 助手）
• ✅ 已经能调用 web-access 工具
• ✅ 一颗好奇心 ❤️

1️⃣ 启用 Skill

把仓库放进你的 Codex skills 目录（具体路径视 Codex 版本而定），重启后即可识别 china-policy-pilot-search。

2️⃣ 发起任务

在对话中给出一句类似：

使用 china-policy-pilot-search，帮我梳理「数字乡村」试点的首批县区名单，重点关注 2020 年的批次。

🪄 Skill 会在合适的时候向你确认两件事：政策名和年份窗口。

3️⃣ 查看产出

任务结束后，你会拿到类似下面这套结果：

output/
├── city_level_sources.xlsx     # 市级来源表
├── county_master.xlsx          # 县级主表
└── process_note.md             # 检索过程说明

---

🗂️ 仓库结构

china-policy-pilot-search/
├── 📘 SKILL.md                                  # Skill 定义与工作流
├── 📖 README.md                                 # 你正在看的这份文档
├── 📜 LICENSE                                   # MIT 许可证
├── 🙈 .gitignore                                # Git 忽略规则
├── 🤖 agents/
│   └── openai.yaml                              # Codex Agent 配置
└── 📚 references/
    ├── query-playbook.md                        # 中文检索手册
    ├── output-spec.md                           # 输出字段与结构规范
    └── evidence-and-naming.md                   # 证据等级与命名规则

---

📚 参考模块

---

🤝 贡献指南

非常欢迎各种形式的贡献 🎉！无论是：

• 🐛 反馈 Bug
• 💡 提出新功能建议
• 📝 改进文档
• 🧪 补充更多真实政策案例
• 🌍 翻译成其他语言

都可以通过下面这些方式：

1. 在 Issues 区发起讨论
2. Fork 仓库，提交 Pull Request
3. 邮件联系维护者（见下方联系方式）

🧷 提交 PR 前，建议先在 Issue 中描述你想要解决的问题，避免重复劳动。

🧑‍💻 本地开发

git clone https://github.com/yichaoli921/china-policy-pilot-search.git
cd china-policy-pilot-search
# 直接修改 SKILL.md 与 references/ 下的文档即可

---

👥 贡献者

感谢下面这些小伙伴让这个项目变得更好 ✨：

🏆 核心维护者

💡 想要成为贡献者？提交一个 PR 并在 CONTRIBUTORS.md 中加上自己就行啦～

---

📮 联系方式

• 🐙 GitHub Issues: github.com/yichaoli921/china-policy-pilot-search/issues
• 📧 Email: [email protected]
• 🌐 项目主页: github.com/yichaoli921/china-policy-pilot-search

---

🙏 致谢

• 感谢所有为这个 Skill 提供过测试用例、反馈与建议的研究者 🙇
• 感谢开源社区里无数默默奉献的工具与文档 💖
• 如果这个 Skill 对你的研究有帮助，欢迎在论文致谢或 README 中 cite 一下 ✨

---

📜 许可证

本项目使用 MIT 许可证 发布，欢迎自由使用、修改与分发。

MIT License

Copyright (c) 2026 李毅超 (Yichao Li)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

---

🌟 Star History

如果你喜欢这个项目，欢迎点一下右上角的 ⭐ Star，这是对我最大的鼓励！

---

⭐ 如果这个 Skill 对你有帮助，欢迎 Star · 提 Issue · Fork 二次开发 ⭐