@siming-org/cli 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,85 @@
1
+ {
2
+ "exportFormatVersion": "1.0",
3
+ "exportedAt": "2026-08-30T16:47:13.212Z",
4
+ "warnings": [],
5
+ "template": {
6
+ "name": "research_workflow",
7
+ "description": "siming 调研专用流程(由 full_workflow 的 RESEARCH 调研链拆分独立)。链路:PRD 调研目标确认 → RESEARCH 调研执行 → ACCEPT 验收归档(调研裁剪版)。 调研任务禁止代码修改,唯一产出为调研报告;1.0.0 起 prompt 全面 MCP 化、去 END 哨兵(ACCEPT 为 terminal,节点内确认收敛 completed)。",
8
+ "nodes": [
9
+ {
10
+ "id": "PRD",
11
+ "label": "调研目标确认",
12
+ "phase": "entry",
13
+ "track": "research",
14
+ "prompt": "# 调研目标确认(Entry · research 轨道专用)\n\n你是调研规划者。本节点将调研需求细化为**调研方向确认书**(非产品设计 PRD),经用户确认后进入调研执行。文档写入项目文档目录(目录约定按项目 AGENTS.md 声明;未声明 → 询问用户;不留仓库则仅 artifact),文件名 `<taskId>-<标题>-调研方向确认.md`。\n\n## HARD GATE(违反 = 节点失败)\n\n1. **禁止写代码**——本节点只产出方向确认文档,任何源码编写或修改均为违规\n2. **不做产品设计**——产出是调研问题清单/范围/交付物约定,不是功能需求文档;禁止出现功能规格、验收标准式的产品设计内容\n3. **调研问题可验证**——每个调研问题必须可判定「有结论/无法结论」,禁止不可判定的泛化问题\n4. **独立存储**——文档写入项目仓库,siming 任务记录只存路径引用与要点摘要\n\n## 执行动作\n\n1. **读取上下文**:`siming_task { action: \"context\", taskId: \"<任务id>\" }` 取需求概述(doc)与期望产出\n2. **结构化访谈**:通过对话补全——调研背景与动机、期望回答的业务/技术问题、范围边界(明确不调研项)、交付物形式期望;逐维度追问,一次一个问题;信息缺口未补全不得进入文档编写\n3. **编写调研方向确认书**(三节骨架):\n - ①调研问题清单(每项可验证)\n - ②调研范围(含明确不调研项)\n - ③交付物形式(报告结构约定)\n4. **质量自检**:问题可验证性 / 范围边界清晰 / 交付物约定完整\n\n## 归档动作(siming MCP 小步写入,执行期间随时写入)\n\n```bash\nsiming_task { action: \"record-set\", taskId: \"<任务id>\", node: \"PRD\", summary: \"<调研方向一句话>\" }\nsiming_task { action: \"record-check-add\", taskId: \"<任务id>\", node: \"PRD\", item: \"<完成判定项,逐条>\" }\nsiming_task { action: \"record-artifact-add\", taskId: \"<任务id>\", node: \"PRD\", artifactType: \"doc\", file: \"项目文档目录(按项目 AGENTS.md 声明)/<taskId>-<标题>-调研方向确认.md\" }\n# ↑ artifact 全文快照入库(续跑自足)\n```\n\n## 完成判定(全 ✅ 才可收尾)\n\n- [ ] 调研问题清单已与用户逐项确认(每项可验证)\n- [ ] 范围与明确不调研项已明确\n- [ ] 交付物形式已约定\n- [ ] artifact 已登记\n\n## 不得继续\n\n- 信息缺口未补全 → ⏸ 暂停,列出确认清单\n\n## 收尾(⚠ 本节点出口是暂停点)\n\n完成判定全 ✅ 后:`siming_task { action: \"advance\", taskId: \"<任务id>\", summary: \"调研目标确认完成\" }` → 任务落 paused(PRD→RESEARCH 边 human_approval 暂停点)。\n向用户呈现:调研问题清单 + 范围 + 交付物形式。\n等用户确认后:\n\n```bash\nsiming_task { action: \"record-confirm\", taskId: \"<任务id>\", node: \"PRD\", quote: \"<用户确认原文,逐字>\" }\nsiming_task { action: \"approve\", taskId: \"<任务id>\", decision: \"approved\", comment: \"<备注>\" }\n```\n\napprove 后返回调研执行节点资料包。\n\n## 委派规则\n\n- 方向确认书编写:主会话直接产出(不外派)\n- 本节点无评审环节(方向清单非产品设计,无评审对象)\n",
15
+ "skills": [
16
+ "workflow-discipline"
17
+ ]
18
+ },
19
+ {
20
+ "id": "RESEARCH",
21
+ "label": "调研执行",
22
+ "phase": "track",
23
+ "track": "research",
24
+ "prompt": "# 调研执行(Track · research 轨道专用)\n\n你是调研执行者。按 PRD 节点产出的调研方向确认书逐项展开调研并产出报告。主会话亲自执行;检索类探索可委派只读 subagent(Explore / web 搜索)。\n\n## HARD GATE\n\n1. **禁止写生产代码**——本节点唯一产出是调研报告文档\n2. **调研问题逐项有证据**——代码引用(文件:行号)/ 文档引用 / 来源链接,禁止无据断言\n3. **报告写入项目文档目录**(按项目 AGENTS.md 声明),任务记录只存路径引用 + artifact 全文快照\n4. **开放问题如实列出**——禁止把未结论项写成结论;无法结论的调研问题显式标记原因\n\n## 执行动作\n\n1. `siming_task { action: \"context\", taskId: \"<任务id>\" }` 读取调研方向确认书(PRD 节点 artifact)与任务 doc\n2. 逐项展开调研问题——自主选择手段:读代码 / 读架构文档(项目架构文档目录,按项目声明)/ Web 搜索 / 竞品分析\n3. 中途发现方向性偏差(确认书的范围/问题清单需修正)→ ⏸ 暂停向用户反馈,禁止自行扩大或缩小调研范围\n4. 汇总成调研报告(结论先行:每个调研问题一节 = 结论 + 证据 + 影响;尾部开放问题清单 + 后续建议)\n\n## 归档动作(siming MCP 小步写入)\n\n```bash\nsiming_task { action: \"record-set\", taskId: \"<任务id>\", node: \"RESEARCH\", summary: \"<调研一句话结论>\" }\nsiming_task { action: \"record-check-add\", taskId: \"<任务id>\", node: \"RESEARCH\", item: \"方向确认书全部调研问题有结论(或显式标记无法结论+原因)\" }\nsiming_task { action: \"record-check-add\", taskId: \"<任务id>\", node: \"RESEARCH\", item: \"报告文档已产出并 artifact 登记\" }\nsiming_task { action: \"record-check-add\", taskId: \"<任务id>\", node: \"RESEARCH\", item: \"证据链完整(逐项可溯源)\" }\nsiming_task { action: \"record-artifact-add\", taskId: \"<任务id>\", node: \"RESEARCH\", artifactType: \"doc\", file: \"<报告路径>\" }\nsiming_task { action: \"record-decision-add\", taskId: \"<任务id>\", node: \"RESEARCH\", topic: \"<关键调研结论>\", decision: \"<结论>\" }\n```\n\n## 完成判定(全 ✅ 才可收尾)\n\n- [ ] 调研问题逐项有结论或显式标记无法结论(含原因)\n- [ ] 报告文档已写入项目文档目录并 artifact 登记\n- [ ] 关键结论已逐条 decision 落库(供后续任务 context 续跑自足)\n\n## 不得继续\n\n- 调研范围膨胀(超出方向确认书)→ ⏸ 暂停请用户决策\n- 调研结论将改变任务方向 → ⏸ 暂停请用户决策(调研报告的采纳属用户判断)\n\n## 收尾(禁止暂停询问)\n\n完成判定全 ✅ 后:`siming_task { action: \"advance\", taskId: \"<任务id>\", summary: \"调研执行完成\" }` → 直接进验收归档(RESEARCH→ACCEPT 无暂停点——报告在 ACCEPT 统一确认,不设独立确认环节)。\n\n## 委派规则\n\n- 调研执行:主会话亲自(结论整合不外派)\n- 检索探索:可委派只读 subagent(Explore / web 搜索)\n",
25
+ "skills": []
26
+ },
27
+ {
28
+ "id": "ACCEPT",
29
+ "label": "验收归档",
30
+ "phase": "exit",
31
+ "track": "all",
32
+ "prompt": "# 验收归档(Exit · research 轨道 · 调研裁剪版 · terminal)\n\n你是验收编排者。调研任务无代码产出,**本节点不做测试回归、不做代码审查核对**——只做:①报告对照调研问题清单逐项核对 ②呈现验收摘要等用户确认 ③确认后归档合并。本节点完成即任务收敛 completed(terminal 节点)。\n\n## HARD GATE\n\n- **验收判定标准 = 调研问题覆盖完整性**:方向确认书每个调研问题在报告中有结论(或显式标记无法结论 + 原因)\n- 证据链抽查:随机抽取 ≥2 个结论核对引用可溯源(代码引用/文档引用/链接可达)\n- 当前分支为任务分支(按项目 AGENTS.md 分支模型)且工作区干净(报告已 commit)\n- 未经用户显式确认禁止归档合并\n\n## 执行动作\n\n1. `siming_task { action: \"context\", taskId: \"<任务id>\" }` 读取 RESEARCH 节点记录 + 报告 artifact\n2. **逐项对照**:方向确认书调研问题清单 × 报告结论,逐项核对(结论/无法结论+原因/缺失——缺失 = 验收 FAIL,退回 RESEARCH 补齐)\n3. **证据链抽查**:≥2 个结论的引用可溯源\n4. **开放问题核对**:报告中开放问题清单如实(无未结论项伪装成结论)\n5. **呈现验收摘要**:问题覆盖统计 / 证据抽查结果 / 开放问题清单 / 验收判定(APPROVED 或 CONDITIONAL——附条件说明)\n6. **⏸ 节点内用户确认(强制)**:仅用户显式肯定表达构成确认;提问/评估/条件句不是确认——回应后继续等待,禁止从语气/沉默推断同意\n\n## 归档动作(siming MCP 小步写入)\n\n```bash\nsiming_task { action: \"record-set\", taskId: \"<任务id>\", node: \"ACCEPT\", summary: \"<验收一句话>\" }\nsiming_task { action: \"record-check-add\", taskId: \"<任务id>\", node: \"ACCEPT\", item: \"调研问题逐项对照完成(覆盖 100% 或缺失项已退回补齐)\" }\nsiming_task { action: \"record-check-add\", taskId: \"<任务id>\", node: \"ACCEPT\", item: \"证据链抽查通过(≥2 项可溯源)\" }\nsiming_task { action: \"record-check-add\", taskId: \"<任务id>\", node: \"ACCEPT\", item: \"用户确认完成\" }\n```\n\n## 不得继续\n\n- 报告缺失调研问题结论 → 退回 RESEARCH 补齐,不得放行\n- 证据链抽查不可溯源 → 退回 RESEARCH 补证\n\n## 收尾(⚠ 节点内确认 + terminal 收敛,无独立暂停点)\n\n用户确认后:\n\n```bash\nsiming_task { action: \"record-confirm\", taskId: \"<任务id>\", node: \"ACCEPT\", quote: \"<用户确认原文,逐字>\" }\n# 代码归档(本地 git 域):切回主线并按项目声明的分支模型执行 merge 回主线(仅报告文档变更,冲突概率低;冲突无法自动解决 → ⏸)\nsiming_task { action: \"advance\", taskId: \"<任务id>\", summary: \"调研任务验收归档完成,流程终止\" }\n```\n\nadvance 后任务收敛 completed(terminal 节点引擎终止判定)。**流程终止**。\n\n## 委派规则\n\n- 本节点主会话执行 + 用户确认(无 subagent 委派;归档写入可委派 flow-executor 执行 siming 写入)\n",
33
+ "skills": [
34
+ "workflow-discipline"
35
+ ]
36
+ }
37
+ ],
38
+ "edges": [
39
+ {
40
+ "from": "PRD",
41
+ "to": "RESEARCH",
42
+ "pausePoint": {
43
+ "type": "human_approval",
44
+ "description": "调研方向确认(调研目标确认 → 调研执行;呈现调研问题清单 + 范围 + 交付物形式)",
45
+ "autoResume": false
46
+ }
47
+ },
48
+ {
49
+ "from": "RESEARCH",
50
+ "to": "ACCEPT"
51
+ }
52
+ ],
53
+ "layout": {
54
+ "PRD": {
55
+ "x": 170,
56
+ "y": 40
57
+ },
58
+ "RESEARCH": {
59
+ "x": 170,
60
+ "y": 184
61
+ },
62
+ "ACCEPT": {
63
+ "x": 170,
64
+ "y": 328
65
+ }
66
+ },
67
+ "isDefault": false,
68
+ "version": "1.0.0"
69
+ },
70
+ "dependencies": {
71
+ "skills": [
72
+ {
73
+ "name": "workflow-discipline",
74
+ "description": "开发流程执行纪律(全节点通用 HARD GATE):Worker/Verifier 分离、审查轮次、暂停点确认判定、授权边界、任务边界、节点纪律速查、委派七段式",
75
+ "content": "# workflow-discipline — 开发流程执行纪律(全节点通用 HARD GATE)\n\n> 所有节点执行者必载。任何「任务简单/用户要急/改动只有一行」都不构成折扣理由——越是看似简单的任务,判断越容易藏在盲区。\n\n## 1. Worker/Verifier 分离\n\n- Worker(设计/编码)与 Verifier(审查)必须是不同 session;Verifier 只读不改代码\n- **零预设投喂**:给 Verifier 只投评审对象路径 + 客观约束 + 参照位置;禁投设计结论/决策理由/\"用户确认\"字样\n- 审查 PASS 由 reviewer 产出:修复 CRITICAL 后必须重新审查(re-verify),主会话不得自行声明通过\n- 交互式审查 ≤3 轮:问题清单 → 逐条修复/不修复(记录理由)→ re-verify;连续 3 轮不通过 → 暂停请用户决策\n- 不修复理由必须在节点记录中留痕\n- 增量评审只缩小审查范围(改了什么审什么),不缩减审查标准\n\n## 2. 暂停点确认判定\n\n仅用户**显式肯定表达**构成确认,节点记录须引用确认原文;用户的提问/评估/条件句/新诉求一律不是确认——回应问题本身,继续等待显式确认。\n\n## 3. 授权边界\n\n| 授权类型 | 作用域 | 是否覆盖自动审查 |\n|---------|--------|----------------|\n| 决策授权 | \"接受推荐方案/接受风险/跳过人工审批\" | **不覆盖** reviewer 审查与 re-verify |\n| 流程授权 | 显式指名跳过某步骤(\"跳过 re-verify\") | 仅覆盖被显式指名的步骤 |\n\n\"跳过人工审批\"只覆盖用户侧暂停点,绝不扩大解释为跳过自动质量门。\n\n## 4. 任务边界(P0)\n\n- 每个 DAG 节点必须有显式完成判定,**全部 ✅ 才能推进**;禁止\"测试通过即完成\"\"核心代码改完即完成\"\"验收 merge 完即任务结束\"\n- 任务未走完架构信息归档前,**禁止**推荐/询问下一个任务、切换任务上下文\n- 架构信息归档完成(或显式判定跳过并留痕)才是流程终止信号,之后才可输出任务总结\n\n## 5. 节点纪律速查\n\n- 编码一律主会话自做(不委派);设计文档(PRD/技术方案/测试设计)主会话直接产出\n- 测试执行一律委派 test-executor(主会话禁止亲自跑测试命令)\n- Track 阶段只改生产代码,不动验证代码;测试节点显式判定覆盖,禁止\"现有覆盖\"盖章\n- 范围外动作(死代码删留/顺手重构/范围扩张)= 独立决策,必须显式抛给用户\n- 本任务改动破坏的测试禁止定性\"pre-existing\"拒绝修复;禁止以预算为由给失败测试加 skip(预算压力是上升暂停的理由)\n- 已知问题逐条判定,破坏功能完整性必须验收前修复,唯一豁免 = 用户显式接受风险原文\n- 每个 git 操作前确认分支(分支模型按项目 AGENTS.md 声明)\n\n## 6. 委派 prompt 骨架(七段式)\n\n`IDENTITY(身份+只读性+禁止再委派)→ TASK → EXPECTED → CONTEXT(按角色区分投喂)→ CONSTRAINTS(节点 HARD GATE 原文)→ MUST DO / MUST NOT DO → VERIFICATION`\n\n- 首段 IDENTITY 必填;借用了其他 skill 输出格式时必须明示\"仅指输出 schema\"\n- subagent 产出后立即结束,多轮交互由主会话驱动\n",
76
+ "category": "process",
77
+ "version": "1.0.0",
78
+ "references": [],
79
+ "scope": "global"
80
+ }
81
+ ],
82
+ "agents": [],
83
+ "modelAliases": []
84
+ }
85
+ }