拾穗（shí suì）——大户收割之后，系统化地捡边角还能活的穗；不与头部抢主粮仓。
一张机会卡 = 一个可审议、可裁定、可回看的机会。系统用证据与硬门推荐，三态由你裁定。
- 一句话：有商业收益通常都要获客；差别在于要不要你经常主动去推、去谈。系统不替你回答，只把证据摆到你面前。
- 硬门 G1–G5：证据可检 · 死区反驳写得出 · 不当头部仍可活 · 不靠先融资可启动 · 问题真实解法可窄。五条全过才可推荐「可行动」。
- 三态裁定：系统推荐（可行动 / 仅观察 / 淘汰）→ 用户自选 → 复述确认。系统不拦覆盖，主观能动性在「选态 + 确认」。
- 信号源：HN Algolia（社区痛点 / Show HN 对照 / 需求片段）+ 本地 Markdown 语料；Reddit（官方 OAuth，自备凭据，未配置自动跳过）。探针可编排、可离线。
- 不是 AI 每日点子机：不空想、不推销独角兽叙事；每条断言尽量带可点开的来源。
| 域 | 状态 |
|---|---|
| 产品规格（定位 / 门禁 / 入门 / 机会卡 / 档案 / 信号源） | ✅ v0 定稿 · docs/spec/ |
| CLI | ✅ v0.3.0 · profile / opp / probe / hunt / opp decide |
| 硬门 G1–G5 + 档案软对照 | ✅ 可跑 · src/shisui/gates.py |
三态裁定写回 user_decision |
✅ v0.3.0 · src/shisui/decide.py |
| 测试 | ✅ 12 passed（pytest tests/） |
| 信号源扩展（评测站）· LLM 辅助摘要 | ⏳ 规划中 · ROADMAP.md |
git clone https://github.com/NinjaSln-labs/shisui.git
cd shisui
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
shisui init
shisui profile onboard # 入门 8 题 + 获客勾选跑一条猎场链：
shisui hunt run -q "indie developer side project" --draft # 联网 HN + 建机会卡草稿
shisui hunt run -q "micro saas" --probes local-corpus # 离线：本地笔记语料
shisui opp validate opportunities/opp-*.yaml --fix # 硬门校验
shisui opp fit opportunities/opp-*.yaml --apply # 档案软对照 + 推荐态
shisui opp decide opportunities/opp-*.yaml # 三态裁定（你说了算）完整命令参考：docs/cli.md。
| 目录/文件 | 内容 |
|---|---|
src/shisui/gates.py |
硬门 G1–G5 计算 |
src/shisui/fit.py |
档案软对照（时间 / 获客 / 能力 / 红线 / 形态） |
src/shisui/decide.py |
三态裁定写回 |
src/shisui/hunt.py |
猎场多探针编排 |
src/shisui/probes/ |
探针注册表与执行器 |
src/shisui/signals/ |
信号源（HN Algolia、本地语料、URL 摘要） |
docs/spec/ |
产品规格六篇（定位、门禁、入门、机会卡、档案、信号源） |
docs/cli.md |
CLI 参考 |
examples/opp-example-001.yaml |
完整示例机会卡：证据 → 硬门全过 → fit 对照 → 三态裁定，开源走查对照用 |
ROADMAP.md |
计划与路线图（公开披露） |
- 门禁可映射 — G1–G5 在卡上有对应必填块，缺块不得推荐「可行动」
- 证据可点开 — 凡断言尽量带
sources[] - 推荐 ≠ 裁定 —
recommendation与user_decision分栏，系统不锁死用户 - 形态可进化 —
shape.now+shape.evolve[]，第一版允许是小工具 - 个人数据默认不入库 —
profiles/、opportunities/、runs/、notes/已 gitignore
MIT · 由 NinjaSln-labs 维护