btspoony/mstar-harness/mstar-harness-core

Morning Star Harness Core（晨星核心）

本 skill 是 harness 的唯一全局入口与裁决层。专题 skill 展开细节；冲突时以本 skill 的状态机、Done 权限与索引为准。

与其它 mstar-* skill 的加载契约

• 本 skill 是 harness 的生命周期 / 授权语义权威（状态机、Done 权限、门禁、路由以本 skill 为准）；加载选择权威是 `mstar-roles`（hub bootstrap → 角色身份 → Assignment Skill presets: 决策，见其 § Load Order）。本 skill 不维护第二份全局必读角色表。
• Directly invoked mstar-* topics declare mstar-harness-core first in Load Order / First action unless lintLoadOrder exempts their exact identity: standalone mstar-coding-behavior and the inbound-only mstar-engine-legacy archive — the archive may be referenced by runtime skills, it never names another topic skill. The existing mstar-roles hub bootstraps role-preset selection; explicit none still retains identity and shared-leaf authorization, anti-recursion, and evidence obligations.
• Load only topics selected by mstar-roles and the relevant topic index; do not read all topics as a precaution. General-engineering wording is not a load-order exemption.
• 加载条件（`mstar-engine-legacy`）：mstar-engine-legacy 是 engine-absent 执行状态边界档案。engine 约束激活（或宿主含 engine 能力）时不加载——engine-present 宿主以运行时 skills 的 engine-check 指针 + engine 校验为权威；仅 engine-absent 宿主（无 mstar CLI / engine import）为确认执行状态边界而读取（触发契约见其 description）：执行状态走对话追踪（no-plan mode），不重建任何文件执行路径。字段历史与迁移形状不在该归档——它们随 engine 留在运行时侧。

Standalone harness（mstar-* 自洽）

• `mstar-*` skill 体系在本仓库内自洽运行：正文与 load order 不得依赖仓库外的 skills、CLI、或 MCP 服务。
• Commands（如 /iteration-start）可引用本仓库 bundled、非 `mstar-*` 的辅助资产（例如 skills/grill-me/）；该引用仅存在于 command 层，不进入 mstar-* 专题索引或 load matrix。
• 框架/SDK/API 问题：先 Read/Grep 项目内文档、规格与源码；仍不确定时再向用户澄清。不将第三方文档工具写入 mstar-* 必读路径。

信息源优先级

1. 当轮用户显式指令
2. 项目 AGENTS.md / CLAUDE.md
3. 当轮相关 knowledge 文档（登记/完整性查 store.db catalog：mstar catalog list / show；{KNOWLEDGE_DIR}/README.md 若存在仅为散文导览，无登记行义务）
4. mstar-* skills（本 skill + 专题）
5. mstar-roles 角色正文

冲突且用户未覆盖 → 暂停升级人工。Knowledge 永不高于用户 / AGENTS.md。

最小交付循环

per-plan：specify → clarify → plan → plan(locked) → tasks → implement（多 task 默认 SDD）→ plan QC tri + QA gate（mandatory 派 QA 或 pm-acceptance）→ Done（inline 单席例外）。阶段细则 → `mstar-phase-gates`；QA 分级 → `mstar-roles/references/project-manager/qa-trigger-matrix.md`。独立交付 development plan 在 Done 后继续交付尾段 compound disposition → submit PR → merge-ready（resumable milestone）→ verify merge → terminal close/unregister/reconcile（verification/report-only 按注册声明的替代完成政策，无强制 PR；注册与尾段语义/失败行为的权威 = 冻结契约 `mstar-artifacts/references/plan-workflow-lifecycle-contract.md`，PM 步骤序列 → `mstar-roles/references/project-manager/plan-management.md`，compound disposition 步骤 → `mstar-knowledge/references/compound-workflow.md`）。迭代内 plan 行不各自走尾段，迭代整体走一次（见下行）。

迭代级：iteration-start → [per-plan cycle × N] → iteration-close → PR delivery → PR merge-ready loop。merge 是独立的授权动作：按 compass pr_merge_policy（reviewed-auto → 本地 PR 级 review 循环的 ship it 结论，须 settled、已 posted、且 head 等于当前 PR head，并且（仅当挂载了外部 review bot 时；无 bot 记 N/A）外部 AI review 在当前 head 达到其通过线、不失败、无 blocking finding；reviewed-bot → 不自起 review loop，挂载的自动 review bot（如 mstar-inspector）在当前 head 的最新 review 达到其自身门（mstar-inspector 为 mstar-inspector review check success）且无 blocking finding，无 bot 属配置失效；owner-gated → 人类 owner（操作者/用户，不是 coordinator 席位）对当前 PR head 的显式书面批准）判定，merge-ready / CI 绿 / QC Approve 各自都不构成授权；pr_merge_policy 缺失即停并回到 Phase 1。细则 → `mstar-iteration` → references/phase-4-5-pr-delivery.md §5.1b/§5.3。

Capture duty：确认的 finding 即落为 {HARNESS_DIR}/store.db 的 issue（计划内 mstar plan issue-add，计划外 mstar issue add；同一 finding 再次出现追加 occurrence，不新开第二个）——捕获只记证据，处置是独立的授权动作。cutover 落地后 open issue 即 residual SSOT（project register 只作迁移历史）。契约唯一权威 → `mstar-project-governance`「Issue capture」（本 skill 不复述）。

加载约定（强制）

加载选择 SSOT：`mstar-roles` hub § Load Order（Assignment Skill presets: 决策；PM required reading 不受 preset 门控）。下表是各角色的典型追加指引，不是第二套选择机制；冲突时以 hub 为准。

Routing eval（宿主插件内回归用，非运行时必读）→ .cursor/skills/mstar-routing-eval/。

状态机

Todo → InProgress → InReview → Done | Blocked

• Done sign-off belongs to project-manager or qualified QA evidence; the authoritative row write uses the sole primary coordinator's direct complete operation with QC/QA and declared-route proof. Leaf implementers never write Done.
• The primary coordinator uses revisable prepare, progress and direct complete; no per-row PM identity/bind/claim, sealed Assignment or transfer protocol. Default cleanup is allow-residual. Ordinary metadata/defaults need no ceremonial prepare record.

ACTIVE 状态字段权威在 store.db 的 root register / workflow / plan 行（唯一执行权威）；无 store 的 harness plan 不登记——走对话追踪（no-plan mode）；status.json / snapshot 仅迁移源/历史，project register 无条件退役为迁移历史。字段与 issue severity/lifecycle → `mstar-artifacts`。

Task category（路由摘要）

PM 在 Assignment 写 `Task category`（主类 + 可选 secondary）：

硬规则：quick 从不跳过 specify → clarify → plan；禁止把新 CLI/API/多模块/新测例标为 quick。已启用 {HARNESS_DIR} 时，首次 implement 前须有主 plan 路径 + workflow/plan 行登记（ACTIVE 在 store.db，经 mstar workflow register 等公共注册动词；无 store 则 plan 不登记——走对话追踪（no-plan mode），见 `mstar-conventions`）。workflow 注册本身是 authorized domain operation（经授权 producer 的引擎原语，不自创第二注册机制），语义 → 冻结契约 mstar-artifacts/references/plan-workflow-lifecycle-contract.md。

@explore 边界

• 已分派角色的 Assignment：禁止用 @explore 代替实现/测试/审查/文档交付。
• 允许短窄只读辅助；glob/grep/read 够用时不必 @explore。
• PM 分派前摸底：推荐；分派后承接方勿转包。

长任务纪律

可追踪清单（plan tasks 或 Todo）；偏离时 PM 拉回；完成前须可核对证据（实现侧自检见 `mstar-coding-behavior`；门禁证据见 `mstar-phase-gates` / `mstar-review-qc`）。

Durable Roadmap Gate：凡声明“分批 / 后续 / next plan / later / temporary workaround”的非热修任务，必须在可追踪载体写清后续路线（批次、依赖、owner/触发条件、完成定义）。可接受载体：{PLAN_DIR} 主 plan、CreatePlan mirror、store.db issue、PM Task Board，或 {HARNESS_DIR}/store.db 的 milestone —— milestone ID + 关联 issue 的 acceptance/owner/dependency/trigger 证据（mstar milestone 家族写入与只读 rollup；规则唯一权威 → `mstar-project-governance`「Milestone」，本 skill 不复述）。只在对话或 Completion Report 里说“以后做”不算可追踪，不能进入 implement GO 或 Done。

专题 skill 索引

宿主 mstar-host

Read `mstar-host` after this skill; it detects the active host and routes to the matching reference — host names, tool shapes and per-host entry details live only there（本表不重复维护）。

版本对齐（CLI ↔ host 插件）

• 全局 CLI 与已安装的宿主插件独立升级；版本漂移是已知故障源（skills/commands 与 CLI 预期不再匹配）。
• 检查：mstar-harness doctor --target <host>（各宿主 target 名 = mstar-host 检测表中该宿主的 id；已实现的宿主以 mstar-host 与 CLI --help 为准）。
• CLI 较新 → 提示用户更新宿主插件；插件较新 → 提示用户更新全局 CLI（npm i -g @mstar-harness/cli@latest）。
• 触发纪律：harness 行为异常/疑似过期、已知新版本发布后、或用户要求时运行——不是每个会话都跑。

定向执行与验证边界

本节是全部角色的范围与验证授权 SSOT；角色方法只展开其执行细节，Skill presets: none 仍由共享 leaf 边界承接这些限制。