| name | mstar-harness-core |
| description | Morning Star (启明星) harness **强制全局入口** —— 信息源优先级、最小交付循环、状态机与 Done 权限、Task category 路由（含 quick 禁豁免）、@explore 边界、长任务纪律、护栏不变量、反模式索引、Morning Star Skill 索引与宿主入口。**任何**非平凡任务开始前必须先 Read 本 skill；再按角色与任务 **按需** Read 其它 `mstar-*` 专题（勿默认通读全部）。`@project-manager` 开轮必读 + `mstar-dispatch-gates` / `mstar-phase-gates` / `mstar-plan-conventions` 等；实现/审查/QA 必读本 skill + `mstar-coding-behavior` 及角色清单（见 `mstar-roles`）。Prepare/派发/Git/residual/QC 细则在专题 skill，不在此重复。 |
Morning Star Harness Core（启明星核心）
本 skill 是 harness 的唯一全局入口与裁决层。专题 skill 展开细节；冲突时以本 skill 的状态机、Done 权限与索引为准。
与其它 mstar-* skill 的加载契约
- 凡
mstar-*（name ≠ mstar-harness-core）假定读者已 Read 本 skill。
- 仅读专题、未读核心 → 未完成 harness 加载。
- 各专题 SKILL.md 含 Load order；按
mstar-harness-core 专题 skill 索引 + 角色 load contract 按需加载，禁止为「保险」通读全部专题。
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-* 必读路径。
信息源优先级
- 当轮用户显式指令
- 项目
AGENTS.md / CLAUDE.md
mstar-* skills（本 skill + 专题）mstar-roles 角色正文
冲突且用户未覆盖 → 暂停升级人工。
最小交付循环
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。
迭代级：iteration-start → [per-plan cycle × N] → iteration-close → PR delivery → PR merge-ready loop。细则 → mstar-iteration。
加载约定（强制）
| 角色 | 始终 | 按任务追加（典型） |
|---|
| 全部 | 本 skill | — |
@project-manager | 本 skill | mstar-dispatch-gates、mstar-phase-gates、mstar-plan-conventions、mstar-roles；implement 波次 mstar-sdd；派 QC 前 mstar-review-qc；并行/审查 mstar-branch-worktree；plan/status/review bundle mstar-plan-artifacts；UI 类 plan Prepare 阶段 mstar-design-md（DESIGN.md 门禁）；新建/大改 skill 时 mstar-skill-authoring；迭代管理 mstar-iteration（Phase 1–5）；战略性工作 mstar-strategy。不读 mstar-coding-behavior |
| 实现/审查/运维 | 本 skill + mstar-coding-behavior + 角色 ref | 有 git 写：mstar-branch-worktree；有 plan 路径：mstar-plan-conventions；PM 派 QC 前：mstar-review-qc；qc-specialist*：mstar-roles → references/qc-specialist/；qa-engineer：references/qa-engineer/；改 status/residual：mstar-plan-artifacts；UI：mstar-design-md；知识库：mstar-compound（PM） |
| leaf 承接方 | 上栏 + mstar-dispatch-gates（反递归节） | — |
Routing eval（Cursor 插件内回归用，非运行时必读）→ .cursor/skills/mstar-routing-eval/。
状态机
Todo → InProgress → InReview → Done | Blocked
Done：仅 @project-manager 或 @qa-engineer。- 实现类可设
InReview，不可设 Done。
status.json 字段与 residual → mstar-plan-artifacts。
Task category（路由摘要）
PM 在 Assignment 写 Task category（主类 + 可选 secondary）：
| Category | 倾向角色 |
|---|
visual | @frontend-dev（复杂 IA 可前置 @product-manager） |
deep | @explore → dev / @architect |
quick | @general 或单 dev — 不豁免 Prepare |
logic | @architect + dev |
ops | @ops-engineer |
docs | @product-manager / @architect / @writing-specialist |
硬规则：quick 从不跳过 specify → clarify → plan；禁止把新 CLI/API/多模块/新测例标为 quick。已启用 {HARNESS_DIR} 时，首次 implement 前须有主 plan 路径 + status.json 登记（见 mstar-plan-conventions）。
@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”的非热修任务，必须在 {PLAN_DIR} 主 plan、CreatePlan mirror、status.json/residual、或 PM Task Board 中写清后续路线（批次、依赖、owner/触发条件、完成定义）。只在对话或 Completion Report 里说“以后做”不算可追踪，不能进入 implement GO 或 Done。
专题 skill 索引
| Skill | 职责 |
|---|
mstar-harness-core | 本文件：入口、状态机、Task category、explore、索引、护栏 |
mstar-phase-gates | per-plan 双阶段门禁：Prepare/Execute、意图门禁、hotfix、可验证编辑 |
mstar-iteration | 迭代管理：Phase 1–5（start / Autonomous Execute / iteration-close / PR delivery / PR merge-ready loop） |
mstar-dispatch-gates | 派发、Delegation、反递归、SDD 串行、SDD 路径 plan QC 强制 tri |
mstar-sdd | Subagent-driven development：file handoff、per-task review、ledger |
mstar-branch-worktree | 功能分支、worktree、QC/QA 检出对齐 |
mstar-plan-conventions | {HARNESS_DIR} 发现、初始化、Spec 分支模型摘要、产物路径 SSOT |
mstar-plan-artifacts | 主 plan、review bundle / durable summaries、status.json、residual、knowledge、Done 归档 |
mstar-design-md | DESIGN.md 设计系统规范 —— 创建/审计/维护 design tokens，三级检查清单，light/dark 双主题 |
mstar-review-qc | PM：QC tri 编排、residual 留档、四层边界；leaf 执行 → mstar-roles/references/qc-specialist/ |
mstar-coding-behavior | Think / Simplicity / Surgical / Debugging / Review Feedback / Goal-Driven / Communication |
mstar-compound | 知识结晶 —— 已解决问题→结构化知识文档，双轨（Bug/Knowledge），「是否值得结晶」自检清单，重叠检测，可发现性检查，CONCEPTS.md 协同 |
mstar-compound-refresh | 知识维护 —— 审查/更新/合并/删除 {KNOWLEDGE_DIR} 文档；项目知识 bootstrap（无/残旧 STRATEGY.md、CONCEPTS.md、{KNOWLEDGE_DIR}）→ references/project-knowledge-bootstrap.md |
mstar-strategy | STRATEGY.md 全局战略方向 —— 产品愿景、技术方向、决策原则 |
mstar-skill-authoring | mstar-native skill authoring: trigger contracts, progressive disclosure, pressure scenarios, behavior-change evidence |
mstar-roles | 角色正文 hub |
mstar-host | 宿主适配（自动识别；references/opencode.md / cursor.md / codex.md / kimi.md / parallel-dispatch.md） |
宿主 mstar-host
Read mstar-host after this skill; detect host per its table, then Read the matching reference.
| 宿主 | 要点 |
|---|
| OpenCode | question、task tool（subagent 参数）→ references/opencode.md |
| Cursor | Task 并行 QC；Plan 双写 → references/cursor.md · cursor-plan-mode-bridge.md |
| Codex | plugin skills、sandbox/apply_patch/tool discovery；无 invoke 工具时不声称 subagent dispatch → references/codex.md |
| Kimi | Agent/AgentSwarm（仅 coder/explore/plan）；角色绑定在 prompt（C5b）；Plan 双写 → references/kimi.md · kimi-plan-mode-bridge.md |
| 其它 | 同 mstar-host skill；按工具信号选 reference |
护栏（不变量）
- 未经用户同意不改
opencode.json、凭据、secrets.env。
- 行为变更须有验证证据。
- 业务仓默认功能分支（Assignment
Branch policy 例外）→ mstar-branch-worktree。
- Dev 三角：
@fullstack-dev 后端主导；UI → @frontend-dev；第二轨 → @fullstack-dev-2（mstar-roles PM 节）。
- 工期仅 agent-oriented →
mstar-plan-conventions · effort-estimation。
- plan-writing artifacts land in
{PLAN_DIR}, not external default plan directories.
- PM Assignment 键名英文；任务正文可中文；产出/报告默认英文。
库文档 / API 问题
先 Read/Grep 项目内文档、规格与源码；仍不确定时再向用户澄清。不将第三方 MCP/CLI 文档工具写入 mstar-* load order。
升级触发
验收仍模糊、评审冲突、重复失败、根因不可收敛 → 升级报告（状态、方案、推荐路径）。
反模式（索引）
| 反模式 | 详见 |
|---|
| SDD paste-only / 跳过 task review / 并行 implementer | mstar-sdd · mstar-dispatch-gates |
SDD plan 以单席 qc.md 收尾 / 跳过 plan tri | mstar-dispatch-gates · mstar-review-qc · mstar-sdd |
fix 后无脑重派三审 / 用 -rev2 代替原位复验 | mstar-plan-artifacts · mstar-review-qc |
| 递归误派 / 误读 Handoff | mstar-dispatch-gates |
quick 跳过 Prepare | 上表 + mstar-phase-gates |
| 多 worktree 未归并就 QC | mstar-branch-worktree |
因默认 gitignore 致 feature 缺 plans 而 Worktree mode: waived（应保留 feature worktree + control 绝对 Plan Path / SDD dir；无 flock 仅 → Plan parallelism: serial） | mstar-branch-worktree · mstar-iteration §2.0 #5 · phase-2-worktree-lease |
并行 writable implement 无隔离（L2 同 plan 多轨：N invoke ≠ worktree；L1 跨 plan：无 verified execution_lease + feature worktree） | mstar-branch-worktree L1/L2 · mstar-iteration §2.6 · references/parallel-writable-pre-dispatch.md |
跨 plan 可写派发无 verified execution_lease / steal 活跃 lease / 并行 merge 入 spec_integration_branch | mstar-iteration · mstar-plan-artifacts（leases）· mstar-branch-worktree L1 |
InProgress 无 execution_lease 未恢复即可写派发 | mstar-plan-artifacts — orphan recovery |
| 混淆跨 plan lease 门控并行与单 plan 内 SDD 并行 implementer | mstar-dispatch-gates · mstar-sdd |
| residual 只写 plan 不写 SSOT | mstar-plan-artifacts |
zero-residual 下把可修 findings 登记为 open R# / 草草 Approve with residuals | mstar-plan-artifacts Findings cleanup modes · mstar-review-qc |
| 角色文件塞流程长文 | 用专题 skill |
| 无证据宣称完成 | mstar-coding-behavior / verification |
CreatePlan 不落盘 / 无 {HARNESS_DIR} mirror | mstar-host · cursor-plan-mode-bridge |
| 临时方案 / 后续计划只写在对话里 | mstar-phase-gates · Durable Roadmap Gate |
| Phase 1 review chain 未完成即 commit | mstar-iteration §1.6；PM 代做专业角色编辑；或三角色并行派发 |
| OpenCode prompt 含多个 prefix-style role mention | mstar-host/references/opencode.md § Role-mention hygiene |
| Phase 2 paste-only / PM 自实现 | mstar-dispatch-gates |
| Phase 3 折叠进 final plan closure / 跳过 §3.1 gate | mstar-iteration §3.0–§3.5 |
| Phase 4 开 PR 后跳过 merge-ready loop | mstar-iteration §5 |
| Phase 5 在 CI / AI review 仍在跑时 push | mstar-iteration §5.1a |
| iteration-close 无 frontmatter completed / 漏 compound Phase 6 | mstar-iteration §3.0.5、§3.4、§3.2 #5 |
iteration 默认 main 作 base 或 PR 目标 | mstar-iteration §1.2、§2.3；mstar-plan-conventions Spec 分支模型 |
常见 harness 说法对照（帮助理解角色分工）
| 常见说法 | 本仓库实体 |
|---|
| 总编排 | @project-manager |
| 规划/访谈 | @product-manager / @architect + Prepare 阶段 |
| category 路由 | Task category + 路由表 + 子代理选择 |
| 持续推进 / 不半途而废 | Phase Gate + Todo/tasks + 验证门禁 |
| 行级哈希锚定编辑 | 以 读后再改 + 小步 Patch 纪律落实（mstar-phase-gates） |
项目根 AGENTS.md 写什么、分层 bootstrap → mstar-plan-conventions references/harness-bootstrap-and-agents-layering.md（勿在 core 重复长文）。
专题 skill（规则在各自 SKILL.md）：mstar-phase-gates、mstar-branch-worktree、mstar-plan-artifacts 等 — 见上表索引。
