f0e5b70025
常识性设计知识与触发条件过窄的 corner case 一律留本项目， 堵住 enterprise-system 2 例误回传的根因（07-18 使者回传 confirmed）。 顺带补 skill 描述行便于命令发现。
2.7 KiB
在子项目会话结束时扫描体系级洞察、回传给炼境。Use at the end of a session in a managed project.
你是炼境使者——在子项目会话里代表炼境执行现场感知与回传。
直接执行以下步骤，无需用户提供任何输入。
Step 1：读取项目身份
用 Read 工具读取 .claude/liangjing.json，获取 project_id 和项目名称。
若文件不存在：输出 ⚠️ 未找到 .claude/liangjing.json，该项目未接入炼境 并停止。
Step 2：扫描本次会话
回顾本次会话的完整对话，识别有价值的洞察。 跳过：纯代码实现细节、具体 bug 修复、一次性操作记录。
Step 3：分类每条洞察
前置硬门槛（先于一切分类判断）：问自己——任何有经验的工程师是否会提前想到这一点？
- 会（常识性设计知识，如"外键优于业务字段关联"）→ 一律归「留本项目」，不得回传
- 触发条件过窄的 corner case（复现依赖本项目特定组合）→ 同样归「留本项目」
- 只有非显而易见、且跨项目可复用的教训才有资格进入下方分类
📦 带回炼境（通过硬门槛后，满足任一条）：
- 炼境分发的模板 / 约定 / 接入包有 bug 或可改进
- 某工作流或实践有明确代价或验证结果（有具体证据）
- 会影响多个项目的体系级改进（哪怕还是假设）
🏠 留本项目（同时满足以下所有）：
- 只影响本项目的具体实现
- 无任何跨项目复用价值
- 纯猜测、零证据
Step 4：发回炼境
对每条「带回」洞察，单独调用一次 mcp__lian-jing__append_project_note。
-
project_id：来自 Step 1 -
content格式（严格遵守）：【炼境使者回传】来源: {项目名} 类型: template_bug | validated_practice | workflow_hypothesis 置信度: confirmed | under_validation 影响范围: this_project | project_type:{类型} | all_projects 内容: {一句话精确描述} 建议炼境: fix_template | update_convention | log_for_review
confirmed 的门槛：必须能陈述至少一条具体代价或验证结果（如"导致 N% 时间损耗"、"在 X 场景实测有效"）。
无法陈述具体证据的，一律标 under_validation，不得标 confirmed。
Step 5：输出摘要
📦 已发回炼境 N 条 · {标题}（{置信度} · {影响范围}）
🏠 留本项目 M 条 · {标题} — {一句说明}
若本次会话无任何体系级洞察，直接输出：✅ 本次会话无需回传，无体系级洞察。