三剪客 · 课程教研组
## ⚠️ 先申请你自己的 API Key
本 Skill 不内嵌任何密钥,也不代付费用。 请到
算力集市 api.a7w.cn 注册并创建你自己的 API Key
(新用户有赠送点数,可以先免费试跑几次)。
拿到后填进环境变量A7W_API_KEY,或直接传给--key参数。
请勿使用他人提供的 Key —— 用量与费用都记在 Key 所属账号上。
这是产品线 L3:多智能体协作型
| 层 | 形态 | 同族已有的包 |
|---|---|---|
| L1 单点生成型 | 一个输入 → 一个产出,开箱即用 | 爆款标题工坊、一稿多平台改写 |
| L2 智能体型 | 单循环:抽档 → 写 → 自检 → 迭代(一个声音在自我迭代) | 课程生产线、课件配图与排版、内容质量闭环 |
| L3 多智能体协作型 | 多角色分工互审,一条命令出成品 | 内容团队、评审委员会、短剧剧组、← 本包 |
与 L2 的分界(拿 课程生产线 与 课件配图与排版 对照)
| 维度 | L2 · 课程生产线 | L2 · 课件配图与排版 | L3 · 课程教研组(本包) |
|---|---|---|---|
| 起点 | 一个主题 | 一份讲义 | 一个主题(从课程设计开始) |
| 角色数 | 1 | 1 | 4(教研 / 讲师 / 课件 / 质检) |
| 目标函数 | 一条流水线:出大纲 → 写讲义 → 出习题 | 一条链路:分页 → 写页 → 配图 → 排版 | 四个互不相同甚至冲突的目标 |
| 最小单位 | 节 | 页 | 整门课(节 + 页 + 裁决一起交付) |
| 产出物 | 大纲 / 讲义 / 习题(纯文本三件套) | 逐页 PNG + 备注 + deck.html(排版产物) | 设计卡 + 讲义 + 课件方案 + 质检记录 + 裁决(纯文本) |
| 谁能否谁 | 没有人能否任何人 | 没有人能否任何人 | 教研能否掉设计、课件能说「这页放不下」、质检能否决 |
| 上下文 | 单条链共享 | 单条链共享 | 信息不对称:讲师自评不进课件/质检,课件意见不进质检 |
| 课程特有的闸门 | 大纲结构校验 | 文字溢出(像素级) | 目标可考核性 / 知识点依赖 / 术语一致性 |
| 失败时 | 报"结构不合格" | 报"这页放不下(实际像素 vs 可用像素)" | 报"是谁在第几轮否掉了什么、引用哪句讲义原话" |
一句话:L2 问的是"这份讲义还能不能更好、这页放不放得下";
L3 问的是"这门课该不该这么设计、谁说了算"。
⚠️ 三条产出侧的边界,先看清楚再选包(本包只做第三条):
- 要大纲 / 讲义 / 习题的纯文本三件套 → 用sanjianke-course-outline(L2);
- 要逐页 PNG / 排版 / 配图 → 用sanjianke-slide-kit(L2,需要 pillow 与中文字体);
- 要四个立场从课程设计开始协作、课件能说放不下、质检能否决、并且留下裁决记录 →
用本包。
本包不出图、不出 PPTX(python-pptx不是标准库、本包不依赖它),
课件方案只出文本(页型 / 标题 / 要点 / 备注)。要成片课件,
把本包的deck.json交给既有的课件排版包做渲染。
四个角色与职权
| 角色 | 目标函数 | 产出物 | 否决权 |
|---|---|---|---|
| 教研 | 这门课值不值得学、给谁学、学完能做到什么、拿什么考核 | 课程设计卡(课程目标 / 受众 / 前置知识 / 逐单元目标 / 考核标准) | 能否掉自己的设计并重开(--design-retries) |
| 讲师 | 每一节都要讲透 | 逐节讲义 + 自评(self_check,课件与质检都看不到) | 无 |
| 课件 | 每一页放不放得下、版式能不能看 | 逐页课件方案(页型 / 标题 / 要点 / 备注)+ 放不下清单 | 能说「这页放不下」并要求讲师拆(--slide-rework) |
| 质检 | 前后一致 + 事实与合规 | 问题清单(每条必须引用讲义原句) + 风险裁决 | 能否决(--inspect-rework) |
零成本看这张表:
python3 scripts/run.py roles
一次协作的走向
教研 design ──▶ 讲师 lecture ──▶ 课件 slides ──┬─ fits ──────▶ 质检 inspect ──┬─ pass/fix ─▶ 交付
▲ ▲ │ ├─ send_back ─┐
│ └── 放不下清单(引讲义原句)┘ cannot_fit └─ veto ──────┼─▶ 带未决项产出
└── 设计卡不达标 / 重开(上限 --design-retries) └──── 讲师按反馈改写(上限给定)──┘
三个否决是串行关系,不是投票:设计卡不达标就轮不到讲师;课件说放不下就先改讲义;
质检在两者之后仍可独立否决 —— 它看不到课件的结论。
怎么用(命令行)
第 0 步:获取 API Key
到 api.a7w.cn 注册,创建一个 API Key(形如 sk-...)。
第 1 步:装依赖
零依赖。 只要机器上有 Python 3.7+:
python3 --version
scripts/run.py 是全部实现,scripts/a7w.py 是零依赖 API 客户端
(只用 urllib / json / mimetypes)。没有任何 pip install。
第 2 步:填 Key
# Linux / macOS
export A7W_API_KEY=sk-你的key
# Windows PowerShell
$env:A7W_API_KEY="sk-你的key"
也可以存进配置文件反复用(推荐):
python3 scripts/a7w.py login --key sk-你的key
第 3 步:先做零成本自检(不联网、不花点数)
# 看四个角色的职权与信息不对称设计
python3 scripts/run.py roles
# 报价:这次协作大概花多少 token(金额要你自己填单价)
python3 scripts/run.py cost --file 材料.md --chapters 3 --sections-per-chapter 1
# 只看将要发出去的提示词,不调模型不花钱
python3 scripts/run.py run --brief 材料.md --dry-run
第 4 步:跑第一个例子
# 一条命令出整门课:教研 → 讲师 → 课件 → 质检(带裁决、轮次上限与明确出口)
python3 scripts/run.py run --brief 材料.md --chapters 3 --sections-per-chapter 1 \
--target-chars 800 --max-pages 8 --outdir /tmp/cc
# 读回全过程记录:谁在第几轮否掉了什么、引用哪句原话
python3 scripts/run.py log --outdir /tmp/cc
--outdir 里会落这些文件:
| 文件 | 内容 |
|---|---|
final.md / final.json | 定稿:讲义全文 + 设计卡 + 课件方案 + 质检裁决 + 收敛判定 |
REPORT.md / log.json | 全过程记录:职权表、裁决记录、动作流水、信息不对称实检、终止判定、成本 |
design.json / design.md | 教研交的课程设计卡 |
lectures.json + lectures/*.md | 逐节讲义(另存人读版,含不进下游的自评栏) |
deck.json + slides/deck-r*.md | 逐页课件方案(含放不下清单) |
inspect/inspection-r*.{md,json} | 每轮质检:问题清单 + 锚定判据 + 本地兜底说明 |
state.json | 断点。同一个 --outdir 重跑只会打印"已在断点里,跳过" |
也可以一个角色一个角色地跑
# 教研出设计卡(不达标会自动重开)
python3 scripts/run.py design --brief 材料.md --outdir /tmp/cc --json --out /tmp/cc-design.json
# 讲师按设计卡写全部讲义
python3 scripts/run.py lecture --brief 材料.md --design /tmp/cc/design.json --outdir /tmp/cc
# 课件出逐页方案(能说放不下)
python3 scripts/run.py slides --brief 材料.md --design /tmp/cc/design.json \
--lectures /tmp/cc/lectures.json --outdir /tmp/cc
# 质检出问题清单与风险裁决(能否决)
python3 scripts/run.py inspect --brief 材料.md --design /tmp/cc/design.json \
--lectures /tmp/cc/lectures.json --outdir /tmp/cc
直接用 curl 调(不依赖本包脚本)
curl -X POST https://api.a7w.cn/api/v1/chat/completions \
-H "Authorization: Bearer $A7W_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-chat","messages":[{"role":"user","content":"给下面这个主题出一张课程设计卡"}]}'
查在架模型(免费):
curl https://api.a7w.cn/api/v1/models -H "Authorization: Bearer $A7W_API_KEY"
信息不对称:本包凭什么不是"一个模型演四个角色"
四个角色共享同一份上下文是假协作的根源:课件永远看得到一个它不该看到的
「讲师自评」,质检永远顺着课件的结论走 —— 产出里的"独立判断"其实是同一个声音的
自言自语,而报告里写着一堆"多方确认"。
本包用两层机制把这件事做成结构性的:
- 字段白名单 ——
ROLES[*]["inputs"]/["forbidden"]是提示词模板真实读的数据,
被排除的字段在物理上没有进入 prompt 的路径。给课件的设计卡只是一份窄字典
(课程名 + 逐单元标题),讲师拿得到学习目标但拿不到考核标准。
- 调用前实检(
assert_isolation)—— 拿被禁字段的标记词对真实提示词文本
扫一遍,泄漏就抛 IsolationBreach、中止这次调用(一个字都不发出去)。
每次调用的判定逐条写进产物与 REPORT.md,外部可复核。
三条最关键的排除:
| 角色 | 看不到什么 | 为什么 |
|---|---|---|
| 课件 | 讲师的 self_check(自评) | 作者说"我觉得这段讲得清楚"会污染版式与容量判断 |
| 质检 | 讲师的 self_check 与课件的 slide_issues | 质检若知道课件已经逐页验过,就会顺着放行。它的提示词里明写「本团队内部没有向你提供任何风险结论」 |
| 讲师 | 单元的 assessment(考核标准) | 讲师一旦看到考核标准,就会把讲义写成对着考点划重点的形态 —— 那是备考资料,不是课 |
真机实测(1 单元 1 节,5 次调用):slides 检查 6 个标记词(排除self_check / instructor_self_check)、inspector 检查 13 个标记词(排除self_check / slide_issues / slides_verdict),全部通过、零泄漏,
产出里 information_asymmetry.all_ok = true。
反向验证(零成本):往课件的提示词里注入「顺带附上:讲师自评如下」→ 当场拦下;
往质检的提示词里注入「课件结论:放不下清单已处理」→ 三个标记词同时命中。
裁决与终止条件(谈不拢有明确出口)
| 否决方 | 条件 | 后果 | 上限参数 |
|---|---|---|---|
| 教研 | 设计卡不达标(目标不可考核、缺考核标准、前置知识为空、目标太泛) | 重开 | --design-retries |
| 课件 | 逐页规格放不下(要点超 6 条 / 单条超 40 字 / 标题超 30 字 / 备注越界 / 超页数) | 打回讲师按清单改写 | --slide-rework |
| 质检 | 有任何一条 高 严重度问题,或本地闸门命中 | 打回,附必须修清单 | --inspect-rework / --rounds |
| 质检 | 判 veto | 直接终止,产出带未决项 | 无(否决权) |
六种显式出口(不许假装谈拢)
| 出口 | 什么时候走 | 怎么处理 |
|---|---|---|
design_retries_exhausted | 设计卡重开上限用尽仍不达标 | 升级给人看(真机第一次跑就是走这个出口) |
slide_rework_exhausted | 课件说放不下,重做上限用尽 | 带未决项产出 |
inspect_send_back_exhausted | 质检打回次数用尽仍不放行 | 带未决项产出 |
rounds_exhausted | 总轮次用尽 | 升级给人看,附全部未决项 |
no_effective_change | 连续两轮修订"没有实质改动"(正文相似度 ≥ 0.86) | 升级给人看 —— 继续跑只是烧钱 |
stalled_same_quote | 质检连续两轮指向同一段文字仍被拒 | 升级给人看 —— 讲师改不动它 |
走任何一种出口,退出码都是 3,escalation.unresolved 里逐条写明未决项,
stderr 打印标红汇总。跑不通就说跑不通。
本地兜底:模型说了不算的五件事
- 有 高 严重度问题却判
pass→ 强制改判send_back - 本地违禁词扫描命中(且词都在安全替代表里)而质检判
pass→ 降级为fix,
由本地替换,不再花一次调用重写整节讲义;不在表里的 → send_back
- 本地占位符 / 照抄示例扫描命中而质检判
pass→send_back - 本地课程闸门(目标可考核性 / 知识点依赖 / 术语一致性)命中而质检判
pass
→ send_back
- 本地按逐页规格复核发现放不下而课件判
fits→ 强制改判cannot_fit;
反过来,课件说 cannot_fit 却引不出讲义原句 → 诉求不算数、降级为 fits
每一次改判都单独入账(log.rulings 里多一条「质检(本地兜底)→ 改判为 …」),
理由写进 forced_by_local。读报告的人要能看出是谁改的判。
驳回也必须留理由
check_ruling_completeness 在收口时核一遍:凡是send_back / veto / cannot_fit / rejected / ineffective 这类否决性裁决,
理由少于 8 个字就判「无理由裁决」→ 整次运行退出码 3 并逐条指出是哪一条。
八道本地硬闸门(确定性,跑两次结果一样,可直接进 CI)
命中一律:压分 + 标红 + stderr 汇总 + 退出码非 0。
| # | 闸门 | 拦什么 | 判据 |
|---|---|---|---|
| 1 | 合规 | 广告法违禁词 + 教育类特有(保过 / 包过 / 包学会 / 保证提分 / 保就业 / 包分配) | 本地正则表;「最X」可枚举上下文豁免(句首不豁免)+「第一」序数/枚举豁免 + 警告语境豁免 |
| 2 | 占位符残留 | {} / [待填] / XXX / (此处省略) / TODO / 待补充 | 六条正则,括号那条只认枚举词 |
| 3 | 照抄提示词示例 | 把提示词里的示例原句写进课程产出 | 去标点相等 / 二元组 Jaccard ≥ 0.75 / 覆盖度 ≥ 0.60;长度守卫是相对阈值 max(6, len(示例)//2);覆盖度判据外加适用窗口(片段 ≥ 24 字才启用) |
| 4 | 学习目标可考核性(本包特有) | 「了解 / 熟悉 / 掌握 XX」这类无法考核的目标 | 不可考核动词一票否决 + 必须有可观察行为或可测标准;逐条判、逐条列出 |
| 5 | 知识点依赖(本包特有) | 讲义里用到但前面从没讲过的术语 | 术语候选按五类来源抽取 + 出现次数 ≥ 2 + 通用词停用;「出现过」不算「讲过」 |
| 6 | 术语一致性 | 同一节里同一概念的两种叫法 | 同长度 + 只差一个字(完播率 / 完看率) |
| 7 | 质检锚点 | 编造引文 | 每条问题必须引用讲义真实存在的句子(exact / substring / fuzzy);未锚定率 > 40% 判「定位失败」,编造的引文不进讲师的修订输入 |
| 8 | 成本上限 + 产出不许进包 | 超 --budget;--outdir 在包内 | 预算核验提到每个会花钱子命令的第一步,超了就地停、一次调用都不发;--outdir 在包内 → 退出码 2 |
闸门一的两条实测修正(都是真机跑出来的)
① 教育类效果承诺单列一档高风险、无豁免。 广告法明确禁止教育、培训广告对通过
考试、获得学位学历或合格证书作保证性承诺,所以 `保过 / 包过 / 包学会 / 保证提分 /
保就业 / 包分配 / 一次通过` 全部高风险拦截。
② 产出侧与材料侧口径分开。 同族的评审委员会踩过:评审自己写
「本文已删除保证提分的表述」这类提到式表述,被自己的闸门拦下。本包是课程教研
场景,这个形态更常见 —— 质检结论里必然要写「不得出现保过这类承诺」。所以:
- 产出侧(讲稿 / 课件方案 / 质检结论):前后 24 字内有
禁止 / 不得 / 不许 / 违规 / 删除 / 避免 / 杜绝 / 风险 / 反面 / 错误示范 等标记词
→ 判为"在提到禁令而不是在承诺",放行,但每一处都留原因(exempted 列表);
- 材料侧(用户给的
--brief):照拦不误,不走这个豁免 ——
用户材料里写了就是写了。
两条真机误伤也已修正:讲义里分条列举常见错误几乎必然写「第一,边看边剪。
第二,只记内容。」—— 这是枚举标记,与「销量第一」无关,现在只在**句首 + 紧跟
顿号/逗号**时豁免(「他是第一名」照拦);
「组名是你排序、复查的唯一线索」是日常中文,现在只拦唯一(选择|指定|授权|官方|认证|品牌|推荐|渠道|合作|代理) 这类排他性搭配。
闸门三为什么是三条路径而不是两条
教训来自同族的实测事故:提示词里写过的示例,哪怕明确标着"这是错的写法",
模型照样照抄 —— 那一批最高分的产出一字不差就是提示词里的示例。
而 Jaccard 在两个长度差几十倍的对象之间会被稀释:把一条 40 字的示例原样
塞进一份 2400 字的产出,Jaccard 只有 0.171(旧判据放行 ❌),
而覆盖度是 1.000(新判据拦下 ✓)。所以加了第三条路径:
示例二元组的覆盖度 ≥ 0.60 —— 覆盖度只看"示例被抄了多少",不看产出有多长。
治本的一面在提示词侧:提示词里不许出现任何一份可直接复制的完整产出,
举例统一用跨主题示例(社区团购选品 / 机械制图停机点 / 架子鼓坐姿,
与课程主题明显不搭),登记在 PROMPT_SAMPLES 常量里。
学习目标可考核性:标定过程(一次真机误伤)
第一版要求「有行为且有刻度」,真机第一次跑就把两份合格的目标判成不可考核
(行为已经可观察,只是没写刻度),两张设计卡连续被否,整次运行停在design_retries_exhausted、一个讲义都没写。
误伤的代价很实在:一个天天误报的闸门会被用户关掉,而闸门关掉之后真正该拦的
(「了解 XX」这一类)也一起不拦了。所以现在:动词一票否决 + 必须落到行为或刻度上,
刻度不再单独构成失败。
闸门五:「出现过」不等于「讲过」
早先的版本把每一节出现过的术语都记进"已讲过",于是这个闸门永远不可能触发。
现在只有引入过的术语才进入已知集合:讲师自报的 terms_introduced 里有它,
或正文里用定义句式当场解释掉了(X,指的是…)。
术语抽取也收了三轮(真机台账 17 条 → 6 条 → 3 条):要求候选前面是边界、
引号里的例证只出现一次就丢掉、本节出现 ≥ 2 次才算术语。
第 3 版的判据来自一个观察:真正的知识点在一节里会被反复使用
(拉片 / 时间码 / 分镜清单),而「老板讲用料」这种引用一次的例子只出现一次。
一个打不响的闸门等于没有闸门;一个天天误报的闸门会被关掉。
参数说明
全局
| 参数 | 说明 |
|---|---|
--json | 以 JSON 输出;写在子命令前后都可以。成功时结果里带 "ok": true,失败时 stdout 只有一个失败信封 |
--key | 临时指定 API Key(也可用 A7W_API_KEY 或 ~/.a7w/config.json) |
--dry-run | 只打印将发送的提示词,不调模型、不花钱 |
--out | 把结果写到文件(必须在包外);run 没有它(产物是一个目录) |
--model / --temperature / --max-tokens | 模型与采样参数。模型名会变,用 models 现查 |
--no-json-mode | 个别模型不支持 response_format 时用 |
输入与规模(design / lecture / slides / inspect / run / cost 共用)
| 参数 | 说明 |
|---|---|
--brief | 用户材料(.md / .txt,UTF-8):课程主题来源 + 事实基准 |
--chapters | 单元数,默认 3 |
--sections-per-chapter | 每单元几节,默认 1 |
--target-chars | 单节讲义的目标字符数(不含空白),默认 800,可用区间 400~3000 |
--sections | 最多写前几节(上限 12;一节一次调用) |
--max-pages | 逐页课件方案的目标页数上限,默认 6 |
会花钱的选项(每个子命令都有)
| 参数 | 说明 |
|---|---|
--price-in / --price-out | 单价,单位「点 / 百万 token」。不给我就不给金额(不编价) |
--budget | 预算上限(元)。超了就地中止,退出码 5;用 --budget 必须给单价,否则退出码 2 |
run —— 一条命令出整门课
| 参数 | 说明 |
|---|---|
--design-retries | 设计卡不达标时最多重开几次,默认 1 |
--slide-rework | 课件说「放不下」后最多让讲师重做几次,默认 1 |
--inspect-rework | 质检打回后最多让讲师改几次,默认 1 |
--rounds | 质检↔讲师修订的总轮次上限,默认 2(至少 1) |
--outdir | 目录产物落这里(必须在包外) |
--force | 忽略断点文件从头重跑(key 没命中就会重新花钱) |
cost —— 报价
--file / --text、规模参数、--price-in / --price-out / --budget,
以及 --design-retries / --slide-rework / --inspect-rework(按上界估)。
不出网、不花钱。
models —— 列出在架模型(免费)
python3 scripts/run.py models # 只看文本模型
python3 scripts/run.py models --type all # 看全部
模型名会变,以现查为准。deepseek-chat 这个别名实测可用(路由到 deepseek-flash),
但它不在 /api/v1/models 的返回列表里 —— 「列表里没有」不等于「不能用」。
退出码(可直接用于 CI)
| 码 | 含义 |
|---|---|
| 0 | 收敛:课件逐页放得下 + 质检放行 + 硬闸门全过 |
| 2 | 用法 / 配置错(文件不存在、--outdir 在包内、--budget 没配单价、参数超区间、长选项缩写) |
| 3 | 硬闸门命中,或未收敛(含质检否决) |
| 4 | 调用失败(网络 / 鉴权 401 / 点数 402 / 模型名 404) |
| 5 | 预算超限,已就地中止,未发起任何调用 |
| 130 | 用户中断(Ctrl+C) |
| 1 | 没预料到的异常(代码 bug):--json 下给 internal 信封 + 完整 traceback 到 stderr |
--json 的失败信封:{"ok": false, "exit": <码>, "error": {"kind": …, "message": …}},kind 取 usage / gate / call / budget / interrupt / internal。
⚠️ Windows PowerShell 5.1 的
>重定向会写成 UTF-16LE。
存--json结果请用| Out-File -Encoding utf8 <文件>或脚本的--out。
实测记录
以下都是本包上线前在真机上跑出来的数(不编,缺就写缺),usage 是网关返回的原文:
| 动作 | usage 原文 | 折算(按 1000/2000 点每百万 token) | 结果 |
|---|---|---|---|
run 3 单元 × 1 节(6 次调用) | prompt 11439 / completion 9236 / total 20675 | 29.911 点 ≈ ¥0.299 | 课件说「放不下」1 次、教研重开 1 次;出口 slide_rework_exhausted |
run 1 单元 × 1 节(5 次调用) | prompt 8696 / completion 3699 / total 12395 | 16.094 点 ≈ ¥0.161 | 质检打回 2 次并真的改了讲义;出口 inspect_send_back_exhausted |
| 被预算闸门拦下 | prompt 0 / completion 0 / total 0 | ¥0 | 一次调用都没发出去 |
| 本地零成本自检 | 不联网 | ¥0 | 本地单测 95 项全过、CLI 契约 51 项全过 |
两轮跑通合计 13 次调用、38841 token(prompt 22564 / completion 16277),
折算 55.118 点 ≈ ¥0.551。单次调用平均输入约 1735、输出约 1252 token ——
这是估报价时最该记住的两个数(一节讲义一次调用)。
金额一律是估算口径(默认 0.02 元/千 token 或你自己填的单价):
网关不公布文本模型单价,所以账单以 api.a7w.cn 控制台为准。
排错
| 现象 | 处置 |
|---|---|
没有找到 API Key | --key / A7W_API_KEY / a7w.py login 三选一 |
鉴权失败(401) / 点数不足(402) | 到 https://api.a7w.cn/ 重新创建 Key 或充值 |
模型不存在(404) | run.py models 现查在架名,别写死 |
预估成本已超预算,未发起这次调用(退出码 5) | 提高 --budget、减少节数/篇幅,或先 cost 试算 |
用了 --budget 就必须给 --price-in / --price-out(退出码 2) | 补上单价 —— 不给单价时 --budget 是个假保险丝 |
出口 = design_retries_exhausted | 这是真实结论,不是 bug。看 unresolved 里逐条原因(通常是目标不可考核),加 --design-retries 或人工改设计卡 |
出口 = slide_rework_exhausted | 看放不下清单要拆哪几页;压低该页的内容量,或提高 --max-pages |
出口 = inspect_send_back_exhausted | 看 reason 与必须修清单;提高 --inspect-rework 或人工定口径 |
出口 = no_effective_change | 讲师在原地打转。继续加轮次只会烧钱,看必须修清单是不是写得太抽象 |
出口 = stalled_same_quote | 质检两次指向同一段文字。通常是那两个要求互相冲突,需要人来定口径 |
质检裁决 send_back 但 issues 是空的 | 本地兜底改判:看「质检(本地兜底)」那条裁决的 forced_by_local,里面写清了是哪条本地闸门 |
[前置缺失] 里出现明显不是术语的词 | 术语抽取的已知误报面(见 references/课程设计与考核.md);把该短语写进设计卡的 prerequisites 也能放行 |
| 断言「课件说放不下,但定位不到具体的节」 | 已实现「节 id → 页 id → 引文唯一锚点」三级回退;三级都失败才会报这个 |
--outdir 在包内退出码 2 | 产出必须落包外:包里只应该有待发布的白名单文件(.md .py .txt .json .sh .js .yaml .yml .csv) |
| 断点续跑没生效 | key 含材料/设计卡/产物摘要、节 id、篇幅、规模、页数上限、各角色提示词版本、裁决口径版本;任一变化都会重跑(故意的)。要强跑用 --force |
unrecognized arguments: --out | 本包不允许长选项前缀缩写(故意的)。请写全 |
更多排错见 references/成本与排错.md。
零成本自检(复核本包的说法)
# 1) 四个角色与信息不对称设计,不花钱
python3 scripts/run.py roles
# 2) 报价,不花钱
python3 scripts/run.py cost --file 材料.md --chapters 3 --sections-per-chapter 1
# 3) 只看提示词,不调模型
python3 scripts/run.py run --brief 材料.md --dry-run
# 4) 跑完之后:包里不该出现任何 .pyc
python3 -c "import pathlib,sys; p=[x for x in pathlib.Path('.').rglob('*.pyc')]; \
print('.pyc 数量:', len(p)); sys.exit(1 if p else 0)"
# 5) 跑完之后:全过程记录 —— 如果"否决 / 打回"是 0,说明互审没有真的发生
python3 scripts/run.py log --outdir /tmp/cc
文件结构
sanjianke-course-crew/
├── SKILL.md 本文件
├── README.md 上手与说明(含与 course-outline、slide-kit 的三方分界表)
├── LICENSE.md MIT
├── references/
│ ├── 角色与职权设计.md 四个角色的目标函数、产出物、否决权与信息边界
│ ├── 课程设计与考核.md 设计卡六栏、三道课程闸门的判据与真机标定
│ └── 成本与排错.md 调用构成、token 标定、退出码、排错表
└── scripts/
├── run.py 九个(含 run)子命令的全部实现(零第三方依赖)
└── a7w.py 零依赖 API 客户端(逐字节与全族一致)
端点速查
| 用途 | 方法 | 地址 |
|---|---|---|
| 大模型(OpenAI 兼容) | POST | https://api.a7w.cn/api/v1/chat/completions |
| 在架模型清单 | GET | https://api.a7w.cn/api/v1/models |
成功响应不带 code 字段;网关有时把它包一层 {"code":1,"data":{...}},两种形态都认。
联系我们
- 技术微信:9872659 —— 加好友时说一下是从哪个 Skill 找过来的,直接给你配套的 API Key 与能跑的示例。
- 要算力 / 要 API Key:算力集市 · 注册领 API Key —— 一个 Key 调用全部 AI 算力,注册、充值、创建 Key 都在这里。
- 更多 AI 插件与接口:AI 插件市场。
相关链接
| 链接 | 地址 | 说明 |
|---|---|---|
| 算力集市 · 注册领 API Key | api.a7w.cn | 一个 Key 调用全部 AI 算力;注册、充值、创建 Key 都在这 |
| AI 插件市场 | aigc.a7w.cn | 浏览全部 AI 插件与接口说明 |
| 三剪客 · 一句话批量出片 | ks.a7w.cn | 短剧二创 / 影视解说 / 矩阵号批量混剪桌面客户端 |
| 视频超清 · 在线批量超分 | vr.a7w.cn | 网页版视频超分,批量处理,最高 4K |
| 0人公司 · AI Agent 平台 | a7w.cn | 主站,了解整套 AI Agent 生态 |
免责声明:本包内置的违禁词表与判定口径是启发式自检工具,来自公开经验整理,
不构成法律意见,也不代表任何平台的官方审核标准。
四个角色都是大模型扮演的,不是人类 —— 它们的否决与裁决是结构化的质量流程,
不等于人工教研评审,也不等于法律合规审查。
课程内容的准确性、版权、以及宣发物料的合规责任由使用者承担;
医疗健康、金融投资、K12、母婴、特殊化妆品等高风险类目必须人工复核后再使用。
本包不出图、不出 PPTX:课件方案只出文本,排版请交给既有的课件排版包。
设计卡、讲义与课件方案由大模型生成,交付前请至少通读一遍 ——
脚本能拦下违禁词、占位符、照抄示例、不可考核的目标、前置缺失与引用幻觉,
拦不住事实性错误,也拦不住"这个讲法不合适"。