教学/管理/审核/项目管理 方法论与开源工具箱¶
版本: v0.5-alpha · 2026-06-13 适用: 全员 核心: 复用开源, 不重复造轮子; 飞书多维表格做单一事实源
0. 工具选择 4 原则¶
- 优先开源 + 大社区 (有问题 google 到)
- 零依赖 / 轻依赖 (标准库 > 单 pip > 多依赖)
- 本地 + 团队两层 (个人脚本本地;协同飞书 Bitable)
- 避免 SaaS 锁定 (除飞书外不上多套 SaaS)
1. 教学方法论¶
1.1 RED-GREEN-IMPROVE 改造 TDD¶
RED: 看 1 份"坏样本" (历次拒收案例) — 知道不能交什么
GREEN: 跑 skill 1 次, 凭 SKILL.md 出 1 份 OK 案例
IMPROVE: 自写 1 份, 红线扫描, 通过后真人 review
1.2 蛛网图自评 (6 维度 × 0-5 分)¶
任何 < 3 分 → 加 1 周培训。
1.3 案例式教学 (Case-based)¶
每周读 1 个历次踩坑案例: - 当时发生了什么? - 当时怎么做? - 现在重做该怎么改?
2. 管理方法论¶
2.1 OKR + KR-Driven Sprint (月度)¶
2.2 RACI 矩阵 (12 步骤 × 5 角色)¶
| 12 步 | 出 | 教 | 评 | 审 | PM |
|---|---|---|---|---|---|
| 1 需求拆解 | C | C | C | C | R/A |
| 2 skill 匹配 | I | I | I | I | R |
| 3 Bitable 建档 | I | I | I | I | R/A |
| 4 骨架填充 | R/A(一) | R/A(二) | R/A(三) | C | I |
| 5 真人 review | C | C | C | R/A | I |
| 6 红线扫描 | I | I | I | C | R/A |
| 7 5P0 自动扫 | I | I | I | C | R/A |
| 8 9 维度打分 | I | I | I | R/A | I |
| 9 sign-off | C | C | C | C | R/A |
| 10 交付 | I | I | I | I | R/A |
| 11 反馈记录 | I | I | I | I | R/A |
| 12 复盘 | C | C | C | C | R/A |
2.3 周报模板 → 见 sop/03_项目管理_甘特+checklist.md §5¶
3. 审核把关方法论¶
3.1 三道关 (3-Gate)¶
关 1: 自动扫 (CI/hook) — audit/06/07 脚本
关 2: 同行 review (peer) — 出题人 ↔ 教案人交叉
关 3: 真人专家 sign-off — 12/6/12 名专家
不跳关原则: 任何项目至少过 3 道关。
3.2 9 维度打分 (改自 audit_code_reviewer.py)¶
| 维度 | 权重 | 5 分 | 3 分 | 1 分 |
|---|---|---|---|---|
| 背景真实性 | 15% | 行业人一看就懂 | 大致对 | 明显编造 |
| 数据脱敏 | 15% | 全脱敏 | 部分 | 明显泄漏 |
| 逻辑自洽 | 10% | 无矛盾 | 小矛盾 | 大矛盾 |
| 难度标注 | 10% | L1/L2/L3 平衡 | 偏单一 | 无标注 |
| 附件可用 | 10% | 能跑 + 合理 | 能跑 | 跑不通 |
| 术语规范 | 10% | 全规范 | 大致 | 多处不规范 |
| 数字精度 | 10% | 精确到小数位 | 大致对 | 明显错 |
| 可复现 | 10% | git+Docker | 部分 | 缺 |
| 可审计 | 10% | checklist 全 | 部分 | 缺 |
得分 ≥ 8.0 才能交付。
3.3 红线拦截 (任何 1 项触 → 不交)¶
参见 sop/02_甲方需求与审核要点.md §1.3/2.3/3.3 三类拒收 Top 10。
4. 项目管理方法论¶
4.1 Kanban + WIP 限制¶
飞书 Bitable 视图:
4.2 燃尽图 (Burndown)¶
飞书 Bitable 仪表盘: - X: 项目天数 - Y: 剩余任务 - 理想 vs 实际
4.3 风险登记册 (Risk Register)¶
飞书 Bitable 子表: | 风险编号 | 描述 | 概率 | 影响 | 缓释 | 责任人 | 状态 |
5. 开源工具箱 (按场景分)¶
5.1 数据/文档处理¶
| 工具 | 协议 | 用途 |
|---|---|---|
| pandas | BSD | xlsx/csv |
| openpyxl | MIT | xlsx 读写 |
| python-docx | MIT | docx 读甲方需求 |
| markdown-it-py | MIT | markdown 严格解析 |
5.2 代码质量/安全¶
| 工具 | 协议 | 用途 |
|---|---|---|
| ruff | MIT | Python lint (快, 替代 flake8) |
| black | MIT | 格式化 |
| mypy / pyright | MIT | 类型检查 |
| bandit | Apache-2.0 | 安全静态分析 |
| Semgrep | LGPL-2.1 | 自定义规则 |
| hadolint | MIT | Dockerfile lint |
5.3 评测 / harness¶
| 工具 | 协议 | 用途 |
|---|---|---|
| SWE-bench | MIT | GitHub issue 评测 |
| HumanEval | MIT | pass@k 公式 |
| inspect-ai | MIT | eval harness (Anthropic) |
| LiveCodeBench | Apache-2.0 | leaderboard 模板 |
5.4 项目管理 (除飞书外备选)¶
| 工具 | 协议 | 用途 |
|---|---|---|
| Plane | AGPL-3.0 | Jira 替代 |
| Wekan | MIT | Trello 替代 |
| Vikunja | AGPL-3.0 | GTD |
| Focalboard | MIT | 多维表格离线备选 |
主推飞书 Bitable, 上述备选只用于"离线/自托管"场景。
5.5 CI / 自动化¶
| 工具 | 协议 | 用途 |
|---|---|---|
| GitHub Actions | 免费/付费 | 主选 |
| Gitea Actions | MIT | 自托管 |
| Drone | Apache-2.0 | 替代 |
| pre-commit | MIT | git commit 前自动 lint |
5.6 可视化 / dashboard¶
| 工具 | 协议 | 用途 |
|---|---|---|
| 本地 HTML | — | 当前 (零依赖) |
| Streamlit | Apache-2.0 | 进阶交互 |
| Gradio | Apache-2.0 | demo |
| Plotly | MIT | 交互图表 |
| ECharts | Apache-2.0 | 中文友好 |
5.7 知识沉淀 / 文档¶
| 工具 | 协议 | 用途 |
|---|---|---|
| 飞书云文档 | 商业 (默认) | 主选 |
| Obsidian | 免费 | 个人 markdown 知识库 |
| Logseq | AGPL-3.0 | 开源替代 |
| MkDocs | BSD | 静态文档站 |
5.8 协同 IM¶
| 工具 | 协议 | 用途 |
|---|---|---|
| 飞书 IM | 商业 | 主选 |
| Mattermost | MIT | Slack 替代 (备选) |
5.9 embedding / 知识检索 (用于 lesson_indexer)¶
| 工具 | 协议 | 用途 |
|---|---|---|
| sentence-transformers | Apache-2.0 | 中英文 embedding |
| BGE-M3 (BAAI) | MIT | 中文 SOTA |
| sqlite-vss | MIT | sqlite 向量扩展 |
| ChromaDB | Apache-2.0 | 进阶向量库 |
6. 实战工具组合 (按角色)¶
出题人 / 教案人 / 评测人¶
审核员¶
项目经理¶
7. 禁用工具清单 (吃过亏)¶
| 工具 | 原因 |
|---|---|
| Notion 多维表 | 国内访问不稳 + 数据迁移成本 |
| Linear / Jira Cloud | 同上 |
| 个人 Excel 散落 | 无单一事实源 |
| 微信群文档接龙 | 无版本控制 |
| 自写"内部系统" | 无人维护 |
8. 新工具引入 SOP¶
引入前 PM 回答 4 问:
通过 4 项 → 飞书 Bitable "Toolbox" 表登记。
9. 自我提升路径 (每季度 1 工具深学)¶
入门 → 中级 → 高级
- Python 3 → asyncio → 性能调优
- pandas → polars → DuckDB
- 飞书 Bitable → 飞书自动化 → 飞书 OpenAPI
- ruff → 自写 ruff 规则 → 写 Semgrep 规则
- HTML dashboard → Streamlit → Plotly Dash
归属: ~/.claude/skills/ecc-shared/toolbox/01_方法论与工具箱.md
配套: sop/01-05