Skip to content

Week 16 教材 - 0611 排序效能實驗室(五階段)+ AI 協作協議 - #1078

Merged
AugustChaoTW merged 19 commits into
mainfrom
wk16-update
Jun 10, 2026
Merged

AugustChaoTW merged 19 commits into
mainfrom
wk16-update

Conversation

@AugustChaoTW

Copy link
Copy Markdown
Contributor

內容

6/11 課堂專題「排序效能實驗室」完整版,五階段全部課堂內完成:

  1. Stage 1 @timeit 計時裝飾器(TDD)
  2. Stage 2 bubble/quick/merge 排序 + benchmark
  3. Stage 3 加速實驗(sorted() baseline + Cython/演算法優化)
  4. Stage 4 matplotlib 畫圖 + 報告
  5. Stage 5 依 OpenSSF Secure Coding Guide 安全自掃 + 修補

規則

  • 每階段 test:(紅)→ feat:(綠),五階段共十個 commit
  • 全程 AI 協作,下課前 PR 五階段齊,無課後補交
  • 配分 15/25/10/10/10 + style 15 + 報告 15 = 100

其他

  • 新增 AGENTS.md:Codex/agents 版 AI 協作協議(對應 CLAUDE.md)
  • starter README 內含「AI 協作協議」(訪談助教模式)
  • 移除舊備用教案 0611-solo-drill.md

⚠️ 教材類 PR,CI(submission-policy-check)必紅,請 admin merge。

🤖 Generated with Claude Code

August Chao and others added 19 commits June 11, 2026 00:20
- 依 OpenSSF Secure-Coding-Guide-for-Python 審查程式碼
- 修補 3 類安全問題(CWE-176 編碼, CWE-476 None 值, CWE-843 型別混淆)
- 補上 AI_LOG.md 含提示詞逐字紀錄與加速百分比
- 補上 TEST_LOG.md 含完整測試結果
- Deleted test_timing.py and timing.py as part of the cleanup process.
- Removed associated AI_LOG.md and TEST_LOG.md files.
- Cleaned up benchmark, plot, and sorting files along with their respective test files.
- Ensured all related assets and results.json are also removed.
- 主教案總覽表/學習目標/TDD 循環(十次)/時程(90 分鐘塞五關)/配分全面同步五階段
- Stage 5 安全自掃:OpenSSF 四章對照、紅綠燈編成 test_security.py、不適用條目要說明、bandit 加分
- 配分加 Stage 5(10),style/報告各降 5,維持總分 100
- 五階段全部課堂內完成,下課前 PR 收齊,無課後補交(移除先前 8 折規則)
- starter README 修正 Stage 3/4 標題錯位、補 Stage 5、十個 commit、檔案說明
- week-16 README 與 in_class README 描述同步

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings June 10, 2026 17:25
@AugustChaoTW
AugustChaoTW merged commit a4eadf9 into main Jun 10, 2026
@AugustChaoTW
AugustChaoTW deleted the wk16-update branch June 10, 2026 17:25

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Updates Week 16’s 6/11 in-class “sorting performance lab” materials from a 4-stage workflow to a 5-stage workflow by adding a security self-audit stage and codifying AI-collaboration instructions, while removing the unused “solo drill” handout.

Changes:

  • Expand 6/11 lab from 4 stages → 5 stages (adds Stage 5 security self-audit requirements and rubric updates).
  • Update course/week readmes and starter instructions to match the new 5-stage timeline and deliverables.
  • Add repository-wide agent instructions (AGENTS.md) and remove the unused 6/11 solo drill handout.

Reviewed changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
weeks/week-16/in_class/README.md Updates the 6/11 session description and removes the backup/unused handout link.
weeks/week-16/in_class/0611-sort-starter/README.md Updates starter instructions to a 5-stage loop; adds AI-collaboration protocol text.
weeks/week-16/in_class/0611-sort-lab.md Expands lab spec to 5 stages and adds Stage 5 security-audit section, schedule, rubric updates.
weeks/week-16/in_class/0611-solo-drill.md Deletes the unused solo drill handout.
weeks/week-16/README.md Updates week-level summary to reflect 5-stage lab completion requirements.
weeks/week-15/in_class/exam-sop-checklist-lite.md Minor checklist formatting change.
AGENTS.md Adds repository-wide instructions for coding agents, including the AI collaboration protocol.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[ ] 0. Fork + clone 自己的 fork(第一次才要做)
[ ] 1. 從 main 開 feature 分支
[ ] 2. 跟 AI 拆 ≥3 個 test case(含 ≥1 個 edge case)
[ ] 2. 跟 AI 拆 ≥3 個 test case(含 ≥1 個 edge case)

- 6/10 (三):[限時演練](./0610-timed-drill.md) — 60 分鐘完賽,只准看精簡版檢查表
- 6/11 (四):[排序效能實驗室・分階段專題](./0611-sort-lab.md) — 不發檢查表;全程 AI 協作,四階段課堂內完成,下課前 PR 收齊
- 6/11 (四):[排序效能實驗室・分階段專題](./0611-sort-lab.md) — 不發檢查表;全程 AI 協作,五階段(timeit/排序/加速/畫圖/安全自掃)**全部課堂內完成,下課前 PR 收齊,無課後補交**
Comment on lines +12 to +13
**Read spec → Dev for red(`test:` commit)→ Dev for green(`feat:` commit)→ push**,
五個階段重複同一循環,push 完才進下一階段。
Comment on lines +76 to +80
<!-- 以下為 AI 協作協議,供學生與 AI 助理共同參考 -->

> **AI 協作協議** — 以下規則對學生與 AI 助理雙方均有約束力。

當你(學生)請 AI 協助本專題時,AI 必須以「開發訪談助教」角色運作,遵循:
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants