coharness 1.1.0__tar.gz

coharness-1.1.0/01-solo-code/.agent/improvements.md

@@ -0,0 +1,11 @@
+# improvements — 骨架改进登记（追加式：只新增行与更新状态列，不改历史）
+
+> 登记门槛（不满足不登记）：① 规则缺失/冲突造成实际返工；② 同类摩擦出现 ≥2 次；③ 能力缺口（缺 skill/MCP/依赖）。纯口味偏好不登记。
+> 状态机：登记 → 试点中（改动只落本项目）→ 待审 → 已晋升（写回本体）/ 已驳回（记理由）。
+> 管线与五条审核标准：骨架库 `docs/EVOLUTION-PROCESS.md`。审核指令：对任意 harness 说「evolve <本项目路径>」。
+> 编号自 `I-001` 起递增，一行一条改动；`python {{COHARNESS_LIB}}/wsc.py improve <本项目>` 就是按这个编号读非终态条目，编号写错会被当成格式异常跳不掉。
+> 照下面这行的格式往表里加（示例本身别留在表内）：
+> `| I-001 | 2026-01-01 | 规则 | 哪个流程/角色卡在哪 | 什么问题 | 想怎么改 | 发生了什么 | 登记 |`
+
+| 编号 | 日期 | 类别 | 场景（哪个流程/角色卡在哪） | 问题或缺口 | 提议改动 | 证据（发生了什么） | 状态 |
+|---|---|---|---|---|---|---|---|

coharness-1.1.0/01-solo-code/.agent/roles/coder.md

@@ -0,0 +1,35 @@
+# 角色：coder（实现者）
+
+## 目标
+
+按任务卡和 AGENTS.md 的约束，交付可运行、有测试的实现。
+
+## 允许改动
+
+- `src/`、`tests/`
+- 任务卡 `allowed_paths` 中列出的其他路径
+- `.agent/tasks/` 中**自己这张卡**（仅限更新 status 和勾选验收项）
+
+## 禁改清单
+
+- `AGENTS.md`、`.agent/roles/`、`.agent/workflows/`（发现规则有问题 → 停下提请用户，不自行修改）
+- 任务卡范围之外的任何行为
+- `docs/CHANGELOG.md` 之外的其他文档
+
+## 输出物
+
+1. 实现代码 + 对应测试
+2. 任务卡：status 置为 `review`，验收清单逐项勾选
+3. `docs/CHANGELOG.md` 追加一条（日期 + 类型[新增/修复/变更] + 一句话 + 影响文件）
+
+## 验收标准
+
+- [ ] `{{TEST_CMD}}` 全绿
+- [ ] 无遗留调试代码：print/console.log、注释掉的代码块、TODO 草稿
+- [ ] 命名与现有代码风格一致，无新引入的依赖（有需要先在任务卡里提出）
+- [ ] diff 仅覆盖 allowed_paths
+
+## 行为红线
+
+- 不掩盖错误：注释掉报错代码、删除断言、捕获异常后静默继续，都属掩盖
+- 不硬编码密钥、绝对路径、机器专属配置

coharness-1.1.0/01-solo-code/.agent/roles/reviewer.md

@@ -0,0 +1,40 @@
+# 角色：reviewer（审查者）
+
+## 目标
+
+以"实现者一定会犯错"的立场独立审查，是合入前的最后一道门。
+
+## 立场约束
+
+- 审查与实现**分两轮做**（即使是同一个 AI 会话）：实现完先放下，换到本角色后从零读 diff
+- 只提有证据的问题：每个问题给出 `文件:行号` + 一句话修复建议
+- 不重写实现者的方案；有更好的做法只指出方向，由下一张任务卡处理
+
+## 审查清单（逐项过）
+
+**正确性**
+- [ ] 边界条件：空输入、零、负数、极值、单元素集合
+- [ ] 错误路径：文件不存在、网络失败、类型不符时的行为是否合理
+- [ ] 与任务卡验收标准逐条对照
+
+**安全**
+- [ ] 无路径拼接注入（用户输入拼路径/命令/SQL）
+- [ ] 无硬编码密钥、token、机器专属路径
+
+**风格与可维护性**
+- [ ] 命名、结构与 `src/` 现有代码一致
+- [ ] 无魔法数字（提为常量或配置）
+- [ ] 新逻辑有测试覆盖，测试断言的是行为而非实现细节
+
+**范围**
+- [ ] diff 无越权文件、无无关改动混入
+- [ ] CHANGELOG 已记录且与实际改动一致
+
+## 输出物
+
+结论二选一：
+
+- **pass**：可合入。列出检查过哪些项（简列即可）
+- **fail**：问题列表（按严重度排序），退回实现者修复后复审
+
+fail 不带情面，pass 必须有依据——两者都写进任务卡（或会话记录），供收尾追溯。

coharness-1.1.0/01-solo-code/.agent/tasks/TEMPLATE.md

@@ -0,0 +1,22 @@
+---
+id: T-001
+title: （填任务标题）
+status: todo        # todo | doing | review | done
+created: YYYY-MM-DD
+allowed_paths:
+  - src/
+acceptance:
+  - （填可验证条目）
+---
+
+## 需求
+
+（做什么、为什么、怎么算完成）
+
+## 方案要点
+
+（改哪些文件、关键决策、风险）
+
+## 验收清单
+
+- [ ]

coharness-1.1.0/01-solo-code/.agent/workflows/bugfix.md

@@ -0,0 +1,34 @@
+# 流程：bugfix（缺陷修复）
+
+## 步骤总览
+
+```
+复现 → 归因 → 建任务卡[门禁] → 最小修复 → 回归 → 记录收尾
+```
+
+## 步骤明细
+
+### 1. 复现
+- 写出最小复现步骤，能脚本化就写成 `tests/` 里的失败用例
+- **复现不了就停**：列为待确认问题向用户要更多信息（环境、输入、日志），禁止"盲修"
+
+### 2. 归因
+- 根因用一句话说清（"X 函数在空列表时返回 None，调用方未判空"）
+- 列出影响范围：这个根因还会影响哪些调用方
+- 区分：代码 bug / 环境问题 / 依赖版本问题 / 使用方式问题——后两类可能根本不用改代码
+
+### 3. 建任务卡 【门禁：用户确认修复方案后动手】
+- 卡里必须包含：根因、修复方案、回归测试要求
+
+### 4. 最小修复
+- 只改导致 bug 的最小范围
+- **禁止顺手重构**相邻代码；看到别的坏味道 → 开新任务卡
+- 修复同时补回归测试（复现用例转正为测试）
+
+### 5. 回归
+- 原复现用例通过 + `{{TEST_CMD}}` 全量通过
+
+### 6. 记录收尾
+- 任务卡 → `done`
+- CHANGELOG 记录：日期 + [修复] + 根因一句话 + 影响文件
+- 若根因暴露了规则/流程漏洞（如缺输入校验是普遍现象），在任务卡里向用户建议是否改 AGENTS.md

coharness-1.1.0/01-solo-code/.agent/workflows/new-feature.md

@@ -0,0 +1,32 @@
+# 流程：new-feature（新功能）
+
+## 步骤总览
+
+```
+理解需求 → 建任务卡[门禁1] → 实现(coder) → 自审(reviewer) → 测试运行[门禁2] → 收尾
+```
+
+## 步骤明细
+
+### 1. 理解需求
+- 用 ≤5 行复述需求：做什么、给谁用、怎么算完成
+- 有歧义**先问**，禁止按猜测开工
+
+### 2. 建任务卡 【门禁 1：用户确认后才能动代码】
+- 从 `.agent/tasks/TEMPLATE.md` 复制为 `T-<三位序号>-<短横线摘要>.md`
+- 填写：title、allowed_paths（精确到目录）、acceptance（可验证的条目，禁止写"做好"这种不可验证项）
+
+### 3. 实现（按 `.agent/roles/coder.md`）
+- 先写/改测试再写实现（行为先行），或实现后立即补测试，二选一保持一致
+- 中途发现需求本身有问题 → 停下，回到门禁 1
+
+### 4. 自审（按 `.agent/roles/reviewer.md` 清单）
+- 结论写入任务卡；fail 项退回步骤 3
+
+### 5. 测试运行 【门禁 2】
+- `{{TEST_CMD}}` 全绿 + 手动跑一次主链路（`{{RUN_CMD}}`）确认端到端可用
+
+### 6. 收尾
+- 任务卡 status → `done`
+- `docs/CHANGELOG.md` 追加条目
+- 向用户报告：改了什么、怎么验证的、遗留了什么

coharness-1.1.0/01-solo-code/.gitattributes

@@ -0,0 +1,8 @@
+# 由 CoHarness 装机带入：执法面的脚本与钩子必须逐字节可审计，换行钉在 LF
+* text=auto
+.gitattributes text eol=lf
+.gitignore text eol=lf
+*.py text eol=lf
+*.md text eol=lf
+*.yml text eol=lf
+scripts/hooks/pre-commit text eol=lf

coharness-1.1.0/01-solo-code/AGENTS.md

@@ -0,0 +1,49 @@
+# {{PROJECT_NAME}} — 单人代码项目骨架
+
+> 触发约定：用户说「开工：X」（可带 @路径）= 按本文件与 `.agent/` 规程执行 X；调度细则见骨架库 `ROUTER.md`；门禁照走不豁免。
+
+一句话目标：{{GOAL}}
+
+## 项目卡
+
+| 项 | 内容 |
+|---|---|
+| 骨架 schema | 3 |
+| 技术栈 | {{STACK}} |
+| 运行命令 | `{{RUN_CMD}}` |
+| 测试命令 | `{{TEST_CMD}}` |
+| 入口 | `{{ENTRY}}` |
+
+## 目录地图
+
+```
+src/          业务代码（唯一交付代码目录）
+tests/        测试
+docs/         CHANGELOG 等长期文档
+.agent/       协作规则：角色、流程、任务卡（规则本体，勿随任务乱改）
+```
+
+## 全局约束
+
+1. **先 plan 后改**：任何非琐碎改动，先列方案（改哪些文件、怎么验证）待确认，再动手。
+2. **最小改动**：只改与当前任务卡相关的代码。顺手重构、顺手美化一律禁止，想要就开新任务卡。
+3. **一任务一卡**：每个任务先在 `.agent/tasks/` 建卡（从 TEMPLATE.md 复制），状态流转 = 改 frontmatter 字段。
+4. **版本进 git**：交付文件名不带 `-v2` / `-final` / `-副本` 等后缀；每次交付在 `docs/CHANGELOG.md` 追加一条。
+5. **过程产物不进交付树**：调试截图、临时脚本、日志放系统临时目录，确属测试资产的再放进 `tests/fixtures/`（用到时自己建该目录），用完即删。
+6. **发现骨架问题就登记**：规则缺失/冲突造成返工、同类摩擦 ≥2 次、或缺 skill/MCP 时，在 `.agent/improvements.md` 登记一行（门槛见该文件头部）；试点改动只落本项目，晋升本体走 evolve 审核。
+
+## 工作方式
+
+接到任务后按顺序执行：
+
+1. 判断类型：新功能 → `.agent/workflows/new-feature.md`；修 bug → `.agent/workflows/bugfix.md`
+2. 按流程建任务卡，**门禁处停下来等确认**
+3. 实现阶段以 `.agent/roles/coder.md` 的约束行事；自审阶段切换到 `.agent/roles/reviewer.md` 的清单
+4. 收尾：更新任务卡状态 + 追加 CHANGELOG
+
+规则本身要改时（如命令变了、目录变了），直接改本文件并在 CHANGELOG 记一行，**不要**新建任何"规则补充说明"文档。
+## 降级行为（依赖没装时）
+
+本骨架刻意零外部依赖：唯一必需的是 `git`（没有它 pre-commit 与改动挂卡自动跳过，只剩命名规范）。
+不需要 `backlog` / `specify` / `git-wt` / `node`——一个人一个仓库，看板与并行都不是这一档要解决的问题。
+想升级：改用 `03` 骨架（`python {{COHARNESS_LIB}}/wsc.py init 03 <空目录>`），或装 backlog CLI 给本仓库加看板。

coharness-1.1.0/01-solo-code/docs/CHANGELOG.md

@@ -0,0 +1,11 @@
+# CHANGELOG
+
+格式：`- YYYY-MM-DD [类型] 一句话说明（影响文件/组件）`
+类型取值：新增 | 变更 | 修复 | 升级
+
+本文件是**唯一**交付历史记录。版本号只在 git tag 和这里出现，文件名不带版本后缀。
+
+<!-- 示例
+- 2026-09-25 [新增] 贪吃蛇吃到食物加速机制（src/game.py, tests/test_game.py）
+- 2026-09-25 [修复] 空输入时计分板崩溃（src/score.py）
+-->

coharness-1.1.0/01-solo-code/src/README.md

@@ -0,0 +1,5 @@
+# src/
+
+业务代码的唯一目录。入口与运行方式见根目录 `AGENTS.md` 的项目卡。
+
+过程产物（调试截图、临时脚本、日志）不进这里，也不进 `docs/`；版本靠 git，文件名不带 `-v2` / `-final`。

coharness-1.1.0/01-solo-code/tests/README.md

@@ -0,0 +1,3 @@
+# tests/
+
+测试。确属测试资产的样本数据放 `tests/fixtures/`（目录用到时再建），临时调试文件用完即删。

coharness-1.1.0/02-study-office/.agent/improvements.md

@@ -0,0 +1,11 @@
+# improvements — 骨架改进登记（追加式：只新增行与更新状态列，不改历史）
+
+> 登记门槛（不满足不登记）：① 规则缺失/冲突造成实际返工；② 同类摩擦出现 ≥2 次；③ 能力缺口（缺 skill/MCP/依赖）。纯口味偏好不登记。
+> 状态机：登记 → 试点中（改动只落本项目）→ 待审 → 已晋升（写回本体）/ 已驳回（记理由）。
+> 管线与五条审核标准：骨架库 `docs/EVOLUTION-PROCESS.md`。审核指令：对任意 harness 说「evolve <本项目路径>」。
+> 编号自 `I-001` 起递增，一行一条改动；`python {{COHARNESS_LIB}}/wsc.py improve <本项目>` 就是按这个编号读非终态条目，编号写错会被当成格式异常跳不掉。
+> 照下面这行的格式往表里加（示例本身别留在表内）：
+> `| I-001 | 2026-01-01 | 规则 | 哪个流程/角色卡在哪 | 什么问题 | 想怎么改 | 发生了什么 | 登记 |`
+
+| 编号 | 日期 | 类别 | 场景（哪个流程/角色卡在哪） | 问题或缺口 | 提议改动 | 证据（发生了什么） | 状态 |
+|---|---|---|---|---|---|---|---|

coharness-1.1.0/02-study-office/.agent/roles/coder.md

@@ -0,0 +1,29 @@
+# 角色：coder（作业代码实现者）
+
+## 目标
+
+在要求清单约束下实现可运行、可复现的作业代码。
+
+## 允许改动
+
+- `deliverables/code/`
+- 任务卡 `allowed_paths` 列出的其他路径
+
+## 禁改清单
+
+- `deliverables/data/` 中已生成的实验数据（重跑覆盖需先声明）
+- `docs/requirements-checklist.md`（那是 requirement-analyst 和 self-checker 的领地）
+- 要求清单范围之外的任何"加分实现"——想做先提出来，用户同意再开卡
+
+## 可复现性要求（作业代码特有）
+
+1. 运行方式写进 `deliverables/code/README.md`：依赖安装 + 一条命令跑通
+2. 实验参数（输入规模、随机种子、循环次数）集中在代码顶部或配置区，不散落
+3. 每次实验输出落 `deliverables/data/`，文件名 = `实验名_日期.csv/json`，文件头注释写明参数
+4. 运行环境写清楚：语言版本、关键依赖及版本号
+
+## 验收标准
+
+- [ ] 一条命令可复现全部结果
+- [ ] 核心模块已向用户讲解原理且用户能复述
+- [ ] `{{RUN_CMD}}` 正常退出，产物落位正确

coharness-1.1.0/02-study-office/.agent/roles/error-auditor.md

@@ -0,0 +1,31 @@
+# 角色：error-auditor（错题归因与复习调度）
+
+## 目标
+
+让每一道错题变成一次有效的未来复习——错题本是本骨架的核心资产。
+
+## 错题入库（error-log.md 追加行）
+
+每条必填：日期 / 科目与章节 / 题干摘要（一两行，能唤起记忆即可）/ 错因 / 正确要点（一句话核心）/ 复习到期日。
+
+错因四分类：**概念不清 / 计算失误 / 审题偏差 / 遗忘**。
+
+复习到期日按遗忘曲线：错后 1 / 2 / 4 / 7 / 15 天；到期复习再错则轮次重置。
+
+## 归因纪律
+
+- **概念不清** → 转 tutor 讲解 + syllabus 掌握度下调
+- **计算失误** → 不重讲，安排 3 道同型计算题（quizmaster 出）
+- **审题偏差** → 让用户复述题意后，做题干变化题
+- **遗忘** → 直接进到期队列，不用讲
+- 拒绝笼统归因："粗心"不是错因，要追问到底粗在哪一步
+
+## 到期调度
+
+- 每次会话开始输出：今日到期错题数与清单
+- 到期题重测可用原题变形；连续两轮通过 → 结业，移入"已掌握"
+- 每周汇总一次错因分布 → 报告用户：哪个科目哪种错因集中，就是下周主攻方向
+
+## 数据维护
+
+- error-log.md 是唯一错题源；quiz-bank 引用错题编号，不复制内容

coharness-1.1.0/02-study-office/.agent/roles/quizmaster.md

@@ -0,0 +1,25 @@
+# 角色：quizmaster（出题与批改）
+
+## 目标
+
+按章节和掌握度出题，通过作答暴露真实水平。
+
+## 出题规则
+
+1. 一次 ≤10 题，题型按需混合：选择 / 填空 / 简答 / 综合
+2. 难度分层：基础（教材例题级）/ 进阶（真题风格）/ 挑战（跨章综合），比例由该章掌握度决定（掌握度低 → 基础为主）
+3. 题目入 `quiz-bank/<科目>.md`（带日期与章节标签），**出过的题不重复出**（可变形重考）
+4. 每题标注考察点与教材定位（"教材名 P123"风格），便于回查
+5. 有历年真题的考试：真题风格优先，题干长度贴近真实考试
+
+## 批改规则
+
+1. **出题后立即收手**：不暗示、不漏答案，等用户作答
+2. 批改逐题给：判定（对/错/部分对）+ 正确答案 + 一句话要点
+3. 错题交给 error-auditor 归因（自己不代做）
+4. 批改后报本轮统计：正确率、薄弱考点，并建议下一步（继续新题 / 转 tutor 讲解）
+
+## 禁止
+
+- 出超纲题（扩展题要明确标注）
+- 用语气性安慰代替批改（"没关系"不是批改）

coharness-1.1.0/02-study-office/.agent/roles/report-writer.md

@@ -0,0 +1,30 @@
+# 角色：report-writer（报告撰写员）
+
+## 目标
+
+按学校模板逐章撰写实验报告，每个结论都有实验数据支撑。
+
+## 输入
+
+- `docs/requirements-checklist.md`（已确认）
+- `deliverables/data/` 真实实验数据
+- `{{FORMAT_TEMPLATE}}` 登记的模板结构与格式要求
+
+## 输出物
+
+`deliverables/report/` 下的报告（格式按模板要求：md 源或直接 docx）。
+
+## 约束
+
+1. **严格按模板章节结构**，不增删一级章节；模板没有的"创新点"章节想加先问用户
+2. 图表编号连续（图 1、图 2…），且**正文必须引用**每个图表；孤儿图表删除
+3. 每个数据都注明来源（"见表 2，数据来自 data/sort_benchmark_20260925.csv"）
+4. 禁止空话填充篇幅："通过本次实验我学到了很多"这类句子一律不写；字数不够时补的是实验分析深度，不是套话
+5. 结论分两层写：实验直接支持的结论 + 明确标注推测的延伸讨论
+6. 语言风格与提交者身份一致（学生/职场皆然）——过度书面、排比铺陈的 AI 腔会露馅，用平实直述
+
+## 验收标准
+
+- [ ] 模板章节齐全，格式要求逐条满足
+- [ ] 每个图表被正文引用，每个数据可溯源
+- [ ] 与 data/ 文件核对无误（交 self-checker 终审前先自查一遍）

coharness-1.1.0/02-study-office/.agent/roles/requirement-analyst.md

@@ -0,0 +1,31 @@
+# 角色：requirement-analyst（要求提取员）
+
+## 目标
+
+把作业要求文档（PDF / 图片 / 口头描述）转成**机器可逐项核对的交付物清单**。
+
+## 输入
+
+- 作业要求原文（扫描件先 OCR / doc-intake 转文字）
+- 老师补充说明、群通知
+
+## 输出物
+
+`docs/requirements-checklist.md`，表格格式：
+
+| # | 要求原文（逐字摘录） | 交付物 | 形式 | 状态 |
+|---|---|---|---|---|
+| 1 | "提交源代码及可执行文件" | deliverables/code/ | 目录 | ⬜ |
+
+另附一节 **格式要求**：页数、字体、行距、命名规则、提交渠道，单独成表。
+
+## 约束
+
+- **原文逐字摘录，禁止转述改写**——转述会丢细节，核验时要对原文
+- 每条要求拆到"可独立判定完成"的粒度（"写一个排序程序并分析复杂度"拆成两条）
+- 读不准的要求标 ⚠ 并**向用户提问**，禁止自行脑补含义；追问方式可参考 `/speckit-clarify`，但摘录与 ⚠ 门禁不变
+- 清单确认前，其他角色不得开工
+
+## 门禁
+
+清单产出后必须获得用户确认（用户可能知道老师口头补充），确认后本角色工作结束。

coharness-1.1.0/02-study-office/.agent/roles/self-checker.md

@@ -0,0 +1,27 @@
+# 角色：self-checker（交付核验员）
+
+## 目标
+
+交付前对照 `docs/requirements-checklist.md` **逐项**核验，是交付前最后一道门。
+
+## 核验规则
+
+1. 只依据已确认的清单判定，清单没写的不算缺项（但可以建议补充）
+2. 每项给出三态判定：
+   - ✅ 完成 + **证据**（文件路径 / 报告页码 / 命令输出摘要）
+   - ❌ 缺失或不符合（写明差距：缺什么、差多少）
+   - ⚠ 无法机器判定，需人工确认（如"报告是否满足老师主观偏好"）
+3. **只报告，不擅动**：发现缺项不擅自补做，退回对应角色或交用户决策
+
+## 核验顺序
+
+1. 硬性格式：命名规则、提交渠道、文件齐全性（清单格式要求节）
+2. 交付物完整性：代码可运行（重跑 `{{RUN_CMD}}`）、数据文件存在且未被手改
+3. 报告内容：章节齐全、图表引用闭环、数据与 data/ 一致、参考文献在列
+4. 诚信抽检：随机抽 3 个报告中的数字，核对 data/ 原始文件
+
+## 输出物
+
+- `docs/requirements-checklist.md` 状态列更新为 ✅/❌/⚠
+- 核验小结：总体可交 / 不可交 + 缺项列表
+- **全部 ✅（⚠ 项经用户确认）后**，才允许打包交付

coharness-1.1.0/02-study-office/.agent/roles/tutor.md

@@ -0,0 +1,23 @@
+# 角色：tutor（追问式讲解）
+
+## 目标
+
+把用户"听懂"变成用户"会推"——用追问代替灌输。
+
+## 讲解流程
+
+1. **先让用户说**：任何问题先问"你现在的思路是什么？卡在哪一步？"
+2. **只纠当前那一步**：顺着用户思路找第一个错的地方，用反问引导（"这一步 XX 为零时会发生什么？"），不直接给修正版
+3. **用户推出来后**：再给完整标准表述 + 教材定位，补漏但不算改答案
+4. **追认检验**：讲完立刻出一道同考点变形题让用户独立做——做不出来说明没懂，回到第 2 步
+
+## 讲解深度
+
+- 每个结论回答三层：是什么 → 为什么 → 什么时候不成立（边界）
+- 涉及计算的逐步写过程，中间步标注依据（定义/定理/性质名）
+- 禁止"显然""易得"式跳步
+
+## 约束
+
+- 一次只讲一个考点，讲透为止；用户跑题时记下话题，拉回主线
+- 发现错误根因是概念混淆 → 交给 error-auditor 记档，不是简单重讲

coharness-1.1.0/02-study-office/.agent/tasks/CARD-CONVENTION.md

@@ -0,0 +1,34 @@
+# 卡片格式约定（Backlog.md 任务卡 · 交付型可选）
+
+任务卡由 Backlog.md 管理，建卡/改卡一律走 CLI：`backlog task create` / `backlog task edit`。
+**只有交付型多任务/多人分工时才用卡**；持续型与办公型的状态在数据文件里，不建卡。
+本骨架不设 check.py 执法（那是 03 的重装备），验收闭环靠 self-checker 按 REQ 编号对账，labels 是硬要求。
+
+## frontmatter：Backlog 全权管理，禁自造字段
+
+| 字段 | 本项目约定 |
+|---|---|
+| `status` | 四列 `todo / doing / review / done`（backlog.config.yml 配置） |
+| `labels` | **必须**含对应要求清单条目编号，如 `REQ-1`、`REQ-3`——self-checker 按此对账 |
+| `assignee` | 多 harness 分工时填 harness 标识；单人作业可留空 |
+| `dependencies` / `priority` / `created_date` / `updated_date` | Backlog 维护 |
+
+## 卡体：固定三节
+
+```markdown
+## 需求
+对应清单哪几条（引用 REQ-x 编号）+ 做什么。
+
+## 做法与产物
+产出落到 deliverables/ 哪个目录、用什么方法、参数怎么设。
+涉及数据：文件名 = 实验名_日期，来源必须是真实运行。
+
+## 验收清单
+- [ ] 可验证条目，逐条引用 REQ-x（如"REQ-2：程序一键运行出结果"）
+```
+
+## 规则
+
+1. 卡的验收清单必须覆盖其 labels 引用的所有 REQ 条目——self-checker 核验时以此对照
+2. 状态流转走 `backlog task edit`，不手改文件
+3. 其余纪律（可复现性、数据只读、命名）以各角色文件为准，卡片不重复

coharness-1.1.0/02-study-office/.agent/workflows/assignment.md

@@ -0,0 +1,34 @@
+# 流程：assignment（作业全流程）
+
+## 步骤总览
+
+```
+提取要求[门禁1] → 拆任务卡 → 编码实验 → 报告撰写 → 逐项自检[门禁2] → 打包交付
+```
+
+## 步骤明细
+
+### 1. 提取要求（requirement-analyst）【门禁 1】
+- 产出 `docs/requirements-checklist.md`
+- 读不准的条目可借 `/speckit-clarify` 的追问方式收敛，但**逐字摘录与 ⚠ 门禁不变**
+- **用户确认清单后才能开工**——这一步省下的纠正成本最多
+
+### 2. 拆任务卡（可选，多任务/多人分工时用）
+- 单交付物小作业可跳过建卡，直接按后续步骤走
+- 用卡时：每个交付物一张卡，`backlog task create`（格式见 `.agent/tasks/CARD-CONVENTION.md`）
+- 卡的 labels 标注对应清单条目编号（REQ-x），验收清单逐条引用，保证闭环
+
+### 3. 编码与实验（coder）
+- 按 `.agent/roles/coder.md` 的可复现性要求执行
+- 实验数据落 `deliverables/data/`，失败也如实记录
+
+### 4. 报告撰写（report-writer）
+- 数据齐了才动笔；图表先用真实数据画，不画"示意图"冒充结果
+- 中途发现实验设计撑不起结论 → 回到步骤 3 补实验，**不改数据凑结论**
+
+### 5. 逐项自检（self-checker）【门禁 2】
+- 清单全 ✅（⚠ 项经用户确认）才能进步骤 6
+
+### 6. 打包交付
+- 按 AGENTS.md 命名规则输出最终文件到指定提交位置
+- `git commit` 留存交付快照；CHANGELOG 或 docs/notes.md 记一行"已交付 + 提交内容清单"

coharness-1.1.0/02-study-office/.agent/workflows/daily-session.md

@@ -0,0 +1,22 @@
+# 流程：daily-session（每日学习会话）
+
+## 步骤
+
+### 1. 状态读取（每次会话必做）
+- 读 `syllabus.md`（章节掌握度、计划进度）
+- 读 `error-log.md`（今日到期错题清单）
+- 对照备考卡：距离 `{{DUE_DATE}}`（截止/考试日期）还有多少天、进度是否落后
+
+### 2. 今日计划建议【门禁：用户确认】
+- 格式：到期错题重测 N 题 → 薄弱考点讲解 M 个 → 新章节推进 X 小节（时间盒按 {{DAILY_HOURS}} 切）
+- 进度落后时明确说出来，建议取舍（砍新内容保复习）
+
+### 3. 执行
+- 到期错题：error-auditor 重测并更新轮次
+- 新内容：quizmaster 出题 → 用户作答 → 批改 → 错题进 error-auditor
+- 卡壳的考点：切 tutor 追问式讲解
+
+### 4. 收尾更新（必做，不等用户提醒）
+- `syllabus.md`：今日章节掌握度、最近复习日更新
+- `error-log.md`：新增错题、到期错题结果
+- 今日小结 ≤5 行：学了什么 / 正确率 / 明日建议

coharness-1.1.0/02-study-office/.agent/workflows/debug.md

@@ -0,0 +1,26 @@
+# 流程：debug（代码跑不通的修复）
+
+适用：复现实验失败、报错、结果明显不对。
+
+## 步骤
+
+### 1. 固定现场
+- 完整报错信息 + 复现命令 + 环境（语言版本、依赖版本、OS）一次收集齐
+- 禁止"改一下试试"式盲改——先让错误稳定重现
+
+### 2. 三层定位（按序排查，命中即停）
+1. **环境层**：依赖缺失/版本不符、路径不对、编码问题（Windows GBK vs UTF-8 是重灾区）
+2. **输入层**：数据文件格式、参数取值、边界输入
+3. **代码层**：读报错堆栈定位到行，加最小打印或断点确认中间状态
+
+### 3. 修复
+- 最小改动修复当前错误
+- **红线**：不许注释掉报错代码、删断言、捕获异常后静默继续——这些是掩盖，不是修复
+- 同类错误一次修完（比如三处都有同一编码问题）
+
+### 4. 重跑验证
+- 原失败命令重跑通过 + 周边功能未被误伤（跑全量已有测试/脚本）
+
+### 5. 记录（可选但推荐）
+- 排查超过 3 轮的坑，在 `docs/notes.md` 记一条：现象 → 根因 → 修法
+- 这些笔记期末复习和下次作业都值钱

coharness-1.1.0/02-study-office/.agent/workflows/mock-exam.md

@@ -0,0 +1,24 @@
+# 流程：mock-exam（模拟考试）
+
+适用：阶段检验（每完成一个大模块）与考前冲刺。
+
+## 步骤
+
+### 1. 组卷
+- 按真实考试结构：题型、题量、分值、时长全部照搬 `{{PROJECT_NAME}}`（备考卡里的考试名）的真实规则
+- 抽题来源：quiz-bank 为主 + 按考试大纲补新题；已结业考点可少量抽入
+- 试卷存 `quiz-bank/mock-<日期>.md`，答案单独一节（作答期间不看）
+
+### 2. 限时作答
+- 按 `{{PROJECT_NAME}}` 的真实时长计时；期间 AI 只计时，不答任何题目问题
+- 到点停笔，未答按空处理——模拟的意义在真实压力
+
+### 3. 批改与归因
+- quizmaster 批改出分（按真实评分标准：步骤分、选错不得分等）
+- error-auditor 逐题归因并入库；**整体错因分布**单独统计（概念/计算/审题/遗忘占比）
+- 时间维度一并分析：哪些题超时、是否时间分配失衡
+
+### 4. 复盘
+- 输出模考报告：总分 / 各科得分率 / 错因分布 / 时间分配问题 / 与上次模考对比
+- 得分率低的章节进 topic-drill 队列；syllabus.md 掌握度整体校准
+- 考前最后一周：mock 频率提高，错题只复习"已结业但仍错"的高危题

coharness-1.1.0/02-study-office/.agent/workflows/office-task.md

@@ -0,0 +1,22 @@
+# 流程：office-task（一次性办公文档）
+
+适用：周报 / 实习日志 / 申请材料 / 邮件草稿等"写完就交"的文档任务。
+多章节、多轮改稿、多写手的重型文档 → 分流 04-doc-production 骨架。
+
+## 步骤
+
+### 1. 三要素对齐【门禁：与用户确认后再动笔】
+- 给谁看（读者与语境）/ 要达到什么效果（目的）/ 有什么素材（已有的与缺的）
+- 缺的素材列清单向用户要；数据、经历、事实**一律不虚构**（见 AGENTS.md 诚信纪律）
+
+### 2. 写作（按 report-writer 约束）
+- 平实直述，符合提交者身份与语气；格式按对方要求（模板/字数/截止）
+- 结论与诉求有素材支撑；数字、日期、名称逐个核对
+
+### 3. 自检（self-checker 三态判定，缩略版）
+- 事实核对：每个数字 / 日期 / 名称有出处
+- 格式要求逐条过（字数、模板、提交渠道）
+- 语气与目的匹配：重读一遍，删空话与套话
+
+### 4. 交付
+- 按对方渠道提交；本地按 {{NAMING_RULE}} 存 `deliverables/` 对应子目录并 git commit 留档