Skip to content

教学/管理/审核/项目管理 方法论与开源工具箱

版本: v0.5-alpha · 2026-06-13 适用: 全员 核心: 复用开源, 不重复造轮子; 飞书多维表格做单一事实源


0. 工具选择 4 原则

  1. 优先开源 + 大社区 (有问题 google 到)
  2. 零依赖 / 轻依赖 (标准库 > 单 pip > 多依赖)
  3. 本地 + 团队两层 (个人脚本本地;协同飞书 Bitable)
  4. 避免 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 分)

- 业务理解
- 脚本会跑
- 飞书 Bitable 会用
- 红线意识
- 沟通话术
- 自我学习

任何 < 3 分 → 加 1 周培训。

1.3 案例式教学 (Case-based)

每周读 1 个历次踩坑案例: - 当时发生了什么? - 当时怎么做? - 现在重做该怎么改?


2. 管理方法论

2.1 OKR + KR-Driven Sprint (月度)

O: 第一类业务 6 月交付 ≥ 3 个项目
KR1: 每周交付 1 个项目
KR2: 平均 9 维度 ≥ 8.5
KR3: 拒收率 ≤ 0%

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 视图:

看板: 待办 → 进行 → 复核 → 完成 → 阻塞
WIP: 每人"进行"同时 ≤ 3 任务

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. 实战工具组合 (按角色)

出题人 / 教案人 / 评测人

- 编辑器: VS Code 或 Cursor
- claude code CLI
- Python 3.11+
- 飞书桌面端
- pre-commit

审核员

- 同上 + 浏览器 (双击 HTML dashboard)
- 飞书 Bitable 移动端

项目经理

- 同上 + 飞书 Bitable 管理员
- GitHub Projects 或 Plane (大型项目备选)
- weekly_report_gen.py

7. 禁用工具清单 (吃过亏)

工具 原因
Notion 多维表 国内访问不稳 + 数据迁移成本
Linear / Jira Cloud 同上
个人 Excel 散落 无单一事实源
微信群文档接龙 无版本控制
自写"内部系统" 无人维护

8. 新工具引入 SOP

引入前 PM 回答 4 问:

1. 解决什么具体问题? (1 句话)
2. 替代什么现有工具? (避免重复)
3. 学习成本? (新员工 1 天能学会吗?)
4. 1 年后能否替换? (避免锁定)

通过 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