القائمة
完整执行一周章包的 6 阶段流水线：规划 → 写作 → 润色 → 并行产出 → QA → 收敛发布。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
استنادا إلى تصنيف SOC المهني
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/h-lu/java-software-engineering --skill team-weekيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
| name | team-week |
| description | 完整执行一周章包的 6 阶段流水线：规划 → 写作 → 润色 → 并行产出 → QA → 收敛发布。 |
| argument-hint | <week_id e.g. week_01> |
| allowed-tools | Bash, Read, Write, Edit, Grep, Glob, Task |
/team-week week_XX
直接执行完整的 6 阶段流水线，把 week_XX 从零产出为完整章包，并通过 release 校验：
python3 scripts/validate_week.py --week week_XX --mode release
CLAUDE.md + shared/style_guide.mdshared/writing_exemplars.md + shared/characters.yml.research_cache.md，prose-polisher 优先读取缓存，不足时用自身的 WebSearch 补充搜索。绝对禁止编造参考链接——搜索失败时写 <!-- TODO --> 占位shared/style_guide.md）阶段 0（日期校准） → 阶段 1（规划） → 阶段 2（写作） → 阶段 2.5（联网研究）
→ 阶段 3（润色） → 阶段 4（并行产出） → 阶段 5（QA） → 阶段 6（收敛）
生成 shared/current_date.txt，供后续所有 agent 读取当前日期：
date '+%Y-%m-%d' > shared/current_date.txt
echo "当前日期已写入 shared/current_date.txt: $(cat shared/current_date.txt)"
为什么需要这一步：时代脉搏、AI 小专栏、参考链接的访问日期都需要使用当前年份。如果不显式注入日期，agent 可能使用训练数据中的旧年份。
校验：确认 shared/current_date.txt 存在且内容为当天日期。
调用 subagent syllabus-planner：
chapters/week_XX/CHAPTER.md（大纲阶段）<!-- ... --> HTML 注释包裹（Bloom 标注、概念预算表、AI 专栏规划、角色出场规划、章节结构骨架等，不能渲染为正文）校验：无需校验（规划阶段，ASSIGNMENT 等文件不存在是正常的）
在写正文之前，使用 Context7 MCP 查证本章涉及的 Java 官方文档和 API 最佳实践：
resolve-library-id 定位相关库（如 junit5、javalin、sqlite-jdbc 等）query-docs 查询具体的最佳实践和 API 用法搜索工具分工说明：
mcp__exa__get_code_context_exa)：用于搜索真实项目中的代码示例和社区实践校验：无需校验
调用 subagent chapter-writer：
shared/writing_exemplars.md + shared/characters.ymlshared/style_guide.md 的"章首导入"章节<!-- ... --> 注释包裹，不能出现在渲染正文中校验：
python3 scripts/validate_week.py --week week_XX --mode drafting
由 Lead agent 直接执行（不委派给 subagent），因为 Lead 拥有全部搜索工具。
目的：为阶段 3 的 prose-polisher 提供真实的搜索数据和参考链接，避免 AI 小专栏使用 TODO 占位。
读取阶段 1 的 AI 小专栏规划：从 CHAPTER.md 的 HTML 注释中提取 2 个侧栏的主题和建议搜索词
读取 shared/current_date.txt 获取当前日期，搜索关键词中包含当前年份
执行搜索（每个侧栏 2-3 次搜索）：
# 优先级 1: 内置 WebSearch（最可靠，无外部依赖）
WebSearch("GitHub Copilot adoption statistics 2026")
WebSearch("Java ecosystem trends 2026")
# 优先级 2: Exa MCP（AI 增强搜索，适合深度研究）
mcp__exa__web_search_exa({
"query": "GitHub Copilot adoption statistics 2026",
"numResults": 5,
"type": "auto"
})
mcp__exa__company_research_exa({
"companyName": "OpenAI",
"numResults": 3
})
# 优先级 3: perplexity MCP（如可用）
mcp__perplexity__perplexity_search({
"query": "vibe coding trend AI programming 2026",
"recency": "year",
"response_format": "json"
})
收集时代脉搏素材：搜索与本章主题相关的最新 AI/技术事件
将搜索结果写入缓存文件 chapters/week_XX/.research_cache.md：
# Week XX 研究缓存
生成日期：YYYY-MM-DD
## 时代脉搏素材
### 搜索词: "..."
- 事实: ... (来源: https://真实URL)
## AI 小专栏 #1: {主题}
### 搜索词: "..."
- 数据点: ... (来源: https://真实URL)
- 引用: "..." (来源: https://真实URL)
## AI 小专栏 #2: {主题}
### 搜索词: "..."
- 数据点: ... (来源: https://真实URL)
校验：确认 .research_cache.md 存在且至少包含 2 个侧栏的搜索数据。
调用 subagent prose-polisher：
shared/writing_exemplars.md + shared/characters.ymlshared/characters.yml）chapters/week_XX/.research_cache.md 中的搜索数据和参考链接<!-- TODO --> 占位校验：
python3 scripts/validate_week.py --week week_XX --mode drafting
同时调用以下 3 个 subagent（可以并行）：
example-engineer：产出 examples/ + CampusFlow 示例代码 + 讲解段落test-designer：产出 starter_code/src/test/java/ JUnit 5 用例矩阵exercise-factory：产出 ASSIGNMENT.md + RUBRIC.md + AI 协作练习校验（三个全部完成后执行）：
python3 scripts/validate_week.py --week week_XX --mode idle
双视角 QA：并行调用 technical-reviewer 和 student-qa（两者独立，可同时执行）。
technical-reviewer（专家视角）student-qa（学生视角）重要：两个 QA agent 都是只读角色（tools: [Read, Grep, Glob]，无 Write 权限），不要让它们写 QA_REPORT.md。它们应该通过返回消息输出评审结果。
校验：无（QA 是只读角色）
优先处理 technical-reviewer 的 S1-S4 问题：
| 问题来源 | 严重度 | 处理方式 | 回传给谁 |
|---|---|---|---|
| technical-reviewer | S1 致命 | 必须修复 | example-engineer（代码问题）或 chapter-writer（概念问题） |
| technical-reviewer | S2 重要 | 必须修复 | example-engineer 或 prose-polisher |
| technical-reviewer | S3 一般 | 必须修复 | example-engineer 或 prose-polisher |
| technical-reviewer | S4 润色 | 必须修复 | prose-polisher |
| student-qa | 总分 < 18 | 结构性重写 | chapter-writer |
| student-qa | 总分 >= 18 | 轻量修订 | prose-polisher（处理建议项） |
修订规则说明：
<!-- 需人工介入 -->一致性处理（由 Lead agent 直接执行，不再调用独立 subagent）：
在最终 release 前，Lead agent 直接执行以下一致性检查：
TERMS.yml → shared/glossary.yml，如有缺失则同步shared/characters.yml 人设落盘 QA_REPORT（由 Lead agent 直接写入）：
chapters/week_XX/QA_REPORT.md
## 技术阻塞项 下（checkbox，必须全部勾选）## 叙事阻塞项 下（checkbox）注意：QA_REPORT.md 是在阶段 6b 由 Lead agent 写入的，不是在阶段 5 由 student-qa 写入的。student-qa 只返回评分和清单，不操作文件。
调用 subagent error-fixer（如果校验有报错）：逐条修复再验证
最终 release 校验：
python3 scripts/validate_week.py --week week_XX --mode release
| 阶段 | 校验模式 | 说明 |
|---|---|---|
| 阶段 1（规划） | 无 | ASSIGNMENT 等文件不存在是正常的 |
| 阶段 2-3（写作/润色） | --mode drafting | 只检查 CHAPTER.md + TERMS.yml（如果存在） |
| 阶段 4-5（产出/QA） | --mode idle | 所有文件 + QA 阻塞项检查，无 JUnit 5/Maven |
| 阶段 6（收敛） | --mode release | 完整发布级校验（含 JUnit 5/Maven + pedagogical 检查） |
- [ ]）才能 release
starter_code/src/test/java/ / ANCHORS.yml / TERMS.yml 要一致