helloagents 3.0.30 → 3.0.31

package/skills/helloagents/SKILL.md

@@ -5,9 +5,9 @@ description: 按任务类型适用 — 建立质量驱动工作流，通过技
 
 # HelloAGENTS
 
-主代理触发或读取任意 skill 时，只有本轮最终收尾消息才按通用输出格式包装；流式内容、进度或状态汇报、中间文本，以及任何仍将继续执行的文本，都保持自然输出。最终收尾中的 `🔄 下一步` 写真实动作，不写当前状态；等待用户授权时使用等待输入态收尾，已获授权且可继续执行时不得收尾。同一条最终收尾消息只包装一次；若需要分段，在同一个外层块内展开，不在正文里再次输出 `【HelloAGENTS】` 或第二个 `🔄 下一步`。
+主代理触发或读取任意 skill 时，只有当前对话的最终回复才按通用输出格式包装；流式内容、进度或状态汇报、中间文本，以及任何仍将继续执行的文本，都保持自然输出。最终回复中的 `🔄 下一步` 写真实动作，不写当前状态；等待用户授权时使用等待输入态收尾，已获授权且可继续执行时不得收尾。同一条最终回复只包装一次；若需要分段，在同一个外层块内展开，不在正文里再次输出 `【HelloAGENTS】` 或第二个 `🔄 下一步`。
 子代理只豁免输出格式、交互确认与停顿、统一执行流程、任务分层、完成判定、命令路由和流程状态，直接执行任务；安全、质量、验证和失败处理规则仍持续生效，且不得包装 HelloAGENTS 外层输出格式。
-只有运行时必须识别本轮“完成 / 等待输入 / 阻塞”时，主代理才写 turn-state；普通问候、普通问答、T0 只读分析和一次性解释不调用。必须调用场景：显式 `~auto` / `~loop`、非只读任务完成验证并进入收尾、需要让运行时识别本轮已完成、等待输入或已阻塞时、已进入项目连续流程或方案包闭环。首选 `helloagents-turn-state write --kind complete --role main`；等待或阻塞时写 `kind=waiting` / `kind=blocked`，并同时写 `reasonCategory` 与 `reason`。显式 `~auto` / `~loop` 下，还必须写入 `blocker.target`、`blocker.evidence`、`blocker.requiredAction`。不要查找、读取或拼接 `turn-state.mjs` 源码路径。子代理不得写 turn-state。
+只有运行时必须识别当前对话“完成 / 等待输入 / 阻塞”时，主代理才写 turn-state；普通问候、普通问答、T0 只读分析和一次性解释不调用。必须调用场景：显式 `~auto` / `~loop`、非只读任务完成验证并进入收尾、需要让运行时识别当前对话已完成、等待输入或已阻塞时、已进入项目连续流程或方案包闭环。首选 `helloagents-turn-state write --kind complete --role main`；等待或阻塞时写 `kind=waiting` / `kind=blocked`，并同时写 `reasonCategory` 与 `reason`。显式 `~auto` / `~loop` 下，还必须写入 `blocker.target`、`blocker.evidence`、`blocker.requiredAction`。不要查找、读取或拼接 `turn-state.mjs` 源码路径。子代理不得写 turn-state。
 普通问答、解释、分析、改写、邮件回复和其他一次性交付虽然不进入完整实现、验证或收尾流程，但仍属于交付：默认只交付与当前请求直接对应的一版最终结果；请求已满足时直接结束，不主动追加无执行价值的延伸、派生版本、不同写法、第二版或邀约式收尾，除非用户明确要求。
 
 `.helloagents/` 在所有 skill 中都统一按项目级存储路径理解：项目本地 `.helloagents/` 负责知识、方案和会话运行态，不作为项目是否已初始化的判定信号；状态文件只使用 `state_path`（实际位于 `sessions/{workspace}/{session}/STATE.md`）；会话证据使用当前 `state_path` 所在目录下的 `artifacts/*.json`；`sessions/active.json` 只作为当前活跃会话索引；若 `project_store_mode=repo-shared`，`context.md`、`guidelines.md`、`DESIGN.md`、`verify.yaml`、`modules/`、`plans/`、`archive/` 按当前上下文中已注入的“当前项目存储”/“项目知识/方案目录”解析，不要假定这些文件一定实际位于当前工作树中。
@@ -50,18 +50,18 @@ description: 按任务类型适用 — 建立质量驱动工作流，通过技
 禁止行为：
 - 禁止在 ROUTE / TIER / SPEC 阶段读取实现类技能（hello-ui/hello-test/hello-verify 等）
 - 禁止因为"可能用到"就提前读取技能文件——等到真正需要时再读
-- 同一会话内，同一路径的配置文件、模块、SKILL、模板只读一次并跨轮复用；缺少所需内容、读取失败、用户要求刷新或本轮修改后才重新读取
+- 同一会话内，同一路径的配置文件、模块、SKILL、模板只读一次并跨轮复用；缺少所需内容、读取失败、用户要求刷新或本次修改后才重新读取
 - ~command 命令只读取对应的 command SKILL.md，不连带读取其他技能
 
 ## 技能查找路径
 
 按以下路径查找，找到即停，不自行猜测或遍历其他路径。
 
-路径定义：`{HELLOAGENTS_READ_ROOT}` = 本轮已确定的 HelloAGENTS 读取根目录，统一用于读取 `skills/` 与 `templates/`
+路径定义：`{HELLOAGENTS_READ_ROOT}` = 当前对话已确定的 HelloAGENTS 读取根目录，统一用于读取 `skills/` 与 `templates/`
 先确定当前技能根目录：
-- 优先使用当前上下文中已注入的“本轮 HelloAGENTS 读取根目录”
+- 优先使用当前上下文中已注入的“当前对话 HelloAGENTS 读取根目录”
 - 若当前上下文未注入，则使用稳定运行根目录 `~/.helloagents/helloagents`
-- 宿主固定链接（Codex `~/.codex/helloagents`、Claude `~/.claude/helloagents`、Gemini `~/.gemini/helloagents`、DeepSeek `~/.deepseek/helloagents`）只作为兼容别名，不作为优先探测路径
+- 宿主固定链接（Codex `~/.codex/helloagents`、Claude `~/.claude/helloagents`、Gemini `~/.gemini/helloagents`）只作为兼容别名，不作为优先探测路径
 - 仍无法确定时，明确说明缺少 HelloAGENTS 读取根目录；不要递归扫描 `$HOME`、`Downloads`、项目目录或旧版本目录
 - 全局模式或已初始化项目时，技能是否需要使用由当前已加载 AGENTS 规则决定；不要因此额外探测项目目录里的 HelloAGENTS skills 路径
 

package/scripts/cli-deepseek.mjs

@@ -1,131 +0,0 @@
-import { spawnSync } from 'node:child_process'
-import { existsSync } from 'node:fs'
-import { join } from 'node:path'
-
-import { buildRuntimeCarrier, readCarrierSettings } from './cli-runtime-carrier.mjs'
-import { createLink, ensureDir, injectMarkedContent, removeLink, removeMarkedContent, safeRead } from './cli-utils.mjs'
-
-export const DEEPSEEK_COMMAND = process.env.HELLOAGENTS_DEEPSEEK_CMD || 'deepseek'
-
-function looksLikeCommandPath(command = '') {
-  return /[\\/]/.test(command) || /^[A-Za-z]:/.test(command)
-}
-
-function injectDeepseekCarrier(home, pkgRoot, bootstrapFile, options = {}) {
-  const deepseekDir = join(home, '.deepseek')
-  ensureDir(deepseekDir)
-
-  const bootstrapContent = safeRead(join(pkgRoot, bootstrapFile))
-  if (!bootstrapContent) return false
-
-  injectMarkedContent(
-    join(deepseekDir, 'AGENTS.md'),
-    buildRuntimeCarrier(bootstrapContent, readCarrierSettings(home), options).trimEnd(),
-  )
-  createLink(pkgRoot, join(deepseekDir, 'helloagents'))
-  return true
-}
-
-export function installDeepseekStandby(home, pkgRoot) {
-  return injectDeepseekCarrier(home, pkgRoot, 'bootstrap-lite.md')
-}
-
-export function installDeepseekGlobal(home, pkgRoot) {
-  return injectDeepseekCarrier(home, pkgRoot, 'bootstrap.md', { profile: 'full' })
-}
-
-export function uninstallDeepseekStandby(home) {
-  const deepseekDir = join(home, '.deepseek')
-  if (!existsSync(deepseekDir)) return false
-
-  removeMarkedContent(join(deepseekDir, 'AGENTS.md'))
-  removeLink(join(deepseekDir, 'helloagents'))
-  return true
-}
-
-export function uninstallDeepseekGlobal(home) {
-  return uninstallDeepseekStandby(home)
-}
-
-function runDeepseekCommand(command, args = []) {
-  if (looksLikeCommandPath(command) && !existsSync(command)) {
-    return {
-      ok: false,
-      missing: true,
-      exitCode: null,
-      stdout: '',
-      stderr: '',
-      errorMessage: '',
-      combinedOutput: '',
-    }
-  }
-  const needsShell = process.platform === 'win32' && /\.cmd$/i.test(command)
-  const result = spawnSync(command, args, {
-    encoding: 'utf-8',
-    errors: 'replace',
-    shell: needsShell,
-    windowsHide: true,
-  })
-  const stdout = String(result.stdout || '').trim()
-  const stderr = String(result.stderr || '').trim()
-  const errorMessage = result.error?.message || ''
-  return {
-    ok: result.status === 0,
-    missing: result.error?.code === 'ENOENT',
-    exitCode: typeof result.status === 'number' ? result.status : null,
-    stdout,
-    stderr,
-    errorMessage,
-    combinedOutput: [stdout, stderr, errorMessage].filter(Boolean).join('\n').trim(),
-  }
-}
-
-function tryParseJson(text = '') {
-  if (!text) return null
-  try {
-    return JSON.parse(text)
-  } catch {
-    return null
-  }
-}
-
-function buildDoctorSummary(report = {}) {
-  const skills = report.skills || {}
-  const capability = report.capability || {}
-  const sandbox = report.sandbox || {}
-  const mcp = report.mcp || {}
-  return {
-    version: typeof report.version === 'string' ? report.version : '',
-    configPath: typeof report.config_path === 'string' ? report.config_path : '',
-    skillsSelected: Array.isArray(skills.selected) ? skills.selected : [],
-    mcpPresent: Boolean(mcp.present),
-    sandboxAvailable: typeof sandbox.available === 'boolean' ? sandbox.available : null,
-    resolvedProvider: typeof capability.resolved_provider === 'string' ? capability.resolved_provider : '',
-    resolvedModel: typeof capability.resolved_model === 'string' ? capability.resolved_model : '',
-  }
-}
-
-export function inspectNativeDeepseekDoctor() {
-  const result = runDeepseekCommand(DEEPSEEK_COMMAND, ['doctor', '--json'])
-  if (result.missing) {
-    return {
-      available: false,
-      command: DEEPSEEK_COMMAND,
-      exitCode: null,
-      ok: false,
-      summary: null,
-      note: 'command-not-found',
-    }
-  }
-
-  const parsed = tryParseJson(result.stdout) || tryParseJson(result.combinedOutput)
-  return {
-    available: true,
-    command: DEEPSEEK_COMMAND,
-    exitCode: result.exitCode,
-    ok: result.ok,
-    summary: parsed ? buildDoctorSummary(parsed) : null,
-    parseError: parsed ? '' : (result.combinedOutput ? 'invalid-json' : ''),
-    output: parsed ? '' : result.combinedOutput,
-  }
-}