@chenguangyao/devflow-kit 0.1.43

package/src/reports/detect.js

@@ -0,0 +1,143 @@
+'use strict';
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Detect the test framework(s) for a given project.
+ *
+ * Returns an array of frameworks ordered by priority. Each entry:
+ *   { framework, kind, command, coverageHint }
+ *
+ *   framework: 'jest' | 'vitest' | 'mocha' | 'tap' | 'node-test' | 'go' | 'pytest' | 'unittest' | 'junit'
+ *   kind:      'unit' (default) - we only suggest unit by default; integ/e2e usually have separate scripts
+ *   command:   the recommended invocation
+ *   coverageHint: { format, file }  - hint for the coverage parser
+ *
+ * Heuristic — light, no execution:
+ *  - read package.json (deps, devDeps, scripts.test)
+ *  - read go.mod
+ *  - read pyproject.toml / setup.cfg / requirements*.txt
+ *  - look for known config files (jest.config.*, vitest.config.*, pytest.ini)
+ */
+function detect(root) {
+  const out = [];
+  const pkgJson = readJsonSafe(path.join(root, 'package.json'));
+  if (pkgJson) {
+    const deps = { ...(pkgJson.dependencies || {}), ...(pkgJson.devDependencies || {}) };
+    const scripts = pkgJson.scripts || {};
+    const has = (n) => deps[n] !== undefined;
+    const haveAny = (...names) => names.some(has);
+
+    if (has('vitest') || hasFile(root, /vitest\.config\.(c|m)?[jt]s$/)) {
+      out.push({
+        framework: 'vitest',
+        kind: 'unit',
+        command: scripts.test && /vitest/.test(scripts.test) ? 'npm test' : 'npx vitest run',
+        coverageHint: { format: 'json-summary', file: 'coverage/coverage-summary.json' },
+      });
+    }
+    if (has('jest') || hasFile(root, /jest\.config\.(c|m)?[jt]s$/)) {
+      out.push({
+        framework: 'jest',
+        kind: 'unit',
+        command: scripts.test && /jest/.test(scripts.test) ? 'npm test' : 'npx jest --ci',
+        coverageHint: { format: 'json-summary', file: 'coverage/coverage-summary.json' },
+      });
+    }
+    if (has('mocha') || hasFile(root, /\.mocharc\.(c?js|json|ya?ml)$/)) {
+      out.push({
+        framework: 'mocha',
+        kind: 'unit',
+        command: scripts.test && /mocha/.test(scripts.test) ? 'npm test' : 'npx mocha',
+        coverageHint: { format: 'lcov', file: 'coverage/lcov.info' },
+      });
+    }
+    if (has('tap') || haveAny('@tapjs/test', 'tap')) {
+      out.push({
+        framework: 'tap',
+        kind: 'unit',
+        command: scripts.test && /tap/.test(scripts.test) ? 'npm test' : 'npx tap',
+        coverageHint: null,
+      });
+    }
+    if (!out.length && scripts.test) {
+      // Generic node script fallback.
+      out.push({ framework: 'node-test', kind: 'unit', command: 'npm test', coverageHint: null });
+    }
+  }
+
+  if (fs.existsSync(path.join(root, 'go.mod'))) {
+    out.push({
+      framework: 'go',
+      kind: 'unit',
+      command: 'go test ./... -v',
+      coverageHint: { format: 'go-cover-out', file: 'coverage.out' },
+    });
+  }
+
+  if (
+    fs.existsSync(path.join(root, 'pyproject.toml')) ||
+    fs.existsSync(path.join(root, 'setup.cfg')) ||
+    fs.existsSync(path.join(root, 'pytest.ini')) ||
+    glob(root, /requirements.*\.txt$/).length
+  ) {
+    if (anyFileContains(root, ['pyproject.toml', 'setup.cfg', 'pytest.ini'], 'pytest') ||
+        glob(root, /test_.*\.py$/).length || glob(root, /.*_test\.py$/).length) {
+      out.push({
+        framework: 'pytest',
+        kind: 'unit',
+        command: 'pytest -q',
+        coverageHint: { format: 'cobertura', file: 'coverage.xml' },
+      });
+    } else if (glob(root, /tests?\/.*\.py$/).length) {
+      out.push({
+        framework: 'unittest',
+        kind: 'unit',
+        command: 'python -m unittest discover -v',
+        coverageHint: null,
+      });
+    }
+  }
+
+  if (fs.existsSync(path.join(root, 'pom.xml')) || fs.existsSync(path.join(root, 'build.gradle')) ||
+      fs.existsSync(path.join(root, 'build.gradle.kts'))) {
+    out.push({
+      framework: 'junit',
+      kind: 'unit',
+      command: fs.existsSync(path.join(root, 'pom.xml')) ? 'mvn -B test' : './gradlew test',
+      coverageHint: { format: 'jacoco-xml', file: 'target/site/jacoco/jacoco.xml' },
+    });
+  }
+
+  return out;
+}
+
+function readJsonSafe(file) {
+  try { return JSON.parse(fs.readFileSync(file, 'utf8')); } catch { return null; }
+}
+
+function hasFile(dir, re) { return glob(dir, re).length > 0; }
+
+function glob(dir, re, max = 10) {
+  if (!fs.existsSync(dir)) return [];
+  let out = [];
+  try {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const e of entries) {
+      if (out.length >= max) break;
+      if (e.isFile() && re.test(e.name)) out.push(path.join(dir, e.name));
+    }
+  } catch { /* ignore */ }
+  return out;
+}
+
+function anyFileContains(root, candidates, needle) {
+  for (const c of candidates) {
+    const f = path.join(root, c);
+    if (!fs.existsSync(f)) continue;
+    try { if (fs.readFileSync(f, 'utf8').includes(needle)) return true; } catch { /* ignore */ }
+  }
+  return false;
+}
+
+module.exports = { detect };

package/src/reports/parse.js

@@ -0,0 +1,236 @@
+'use strict';
+/**
+ * Parse stdout/stderr from various test frameworks into a uniform shape:
+ *   { framework, total, passed, failed, skipped, duration_ms, failures: [{name, file?, message?}] }
+ *
+ * All parsers are best-effort and tolerant of missing fields. They look at
+ * the LAST occurrence of summary lines, since flaky retries / multiple suites
+ * can produce intermediate ones.
+ */
+
+function parse(framework, stdout) {
+  const text = stdout || '';
+  const fn = parsers[framework];
+  if (!fn) return parsers.generic(text, framework);
+  return Object.assign({ framework, total: null, passed: null, failed: null, skipped: null, duration_ms: null, failures: [] }, fn(text));
+}
+
+const parsers = {
+  // -------- jest --------
+  // sample:
+  //   Tests:       2 failed, 8 passed, 1 skipped, 11 total
+  //   Time:        1.345 s
+  jest(text) {
+    const out = {};
+    const m = matchLast(text, /^Tests:\s+(.*?)$/m);
+    if (m) {
+      const fields = m[1];
+      out.failed  = numField(fields, /(\d+)\s+failed/);
+      out.passed  = numField(fields, /(\d+)\s+passed/);
+      out.skipped = numField(fields, /(\d+)\s+(?:skipped|todo|pending)/);
+      out.total   = numField(fields, /(\d+)\s+total/);
+    }
+    const t = matchLast(text, /^Time:\s+([\d.]+)\s*s/m);
+    if (t) out.duration_ms = Math.round(parseFloat(t[1]) * 1000);
+    out.failures = collectFailures(text, /^\s*●\s+(.*)$/gm).slice(0, 50);
+    return out;
+  },
+
+  // -------- vitest --------
+  // sample:
+  //   Test Files  1 failed (1)
+  //    Tests  1 failed | 5 passed (6)
+  //    Duration  234ms
+  vitest(text) {
+    const out = {};
+    const tests = matchLast(text, /Tests\s+([^\n]+)/);
+    if (tests) {
+      const seg = tests[1];
+      out.failed  = numField(seg, /(\d+)\s+failed/);
+      out.passed  = numField(seg, /(\d+)\s+passed/);
+      out.skipped = numField(seg, /(\d+)\s+skipped/);
+      const tot = seg.match(/\((\d+)\)/);
+      if (tot) out.total = parseInt(tot[1], 10);
+      else out.total = (out.failed || 0) + (out.passed || 0) + (out.skipped || 0);
+    }
+    const d = matchLast(text, /Duration\s+([\d.]+)\s*(ms|s)/);
+    if (d) out.duration_ms = d[2] === 's' ? Math.round(parseFloat(d[1]) * 1000) : Math.round(parseFloat(d[1]));
+    out.failures = collectFailures(text, /^\s*FAIL\s+(.+)$/gm).slice(0, 50);
+    return out;
+  },
+
+  // -------- mocha (spec reporter) --------
+  //   12 passing (45ms)
+  //   1 pending
+  //   2 failing
+  mocha(text) {
+    const out = {};
+    const p = matchLast(text, /(\d+)\s+passing\s*\(([\d.]+)\s*(ms|s)\)/);
+    if (p) {
+      out.passed = parseInt(p[1], 10);
+      out.duration_ms = p[3] === 's' ? Math.round(parseFloat(p[2]) * 1000) : Math.round(parseFloat(p[2]));
+    }
+    const f = matchLast(text, /(\d+)\s+failing/);
+    if (f) out.failed = parseInt(f[1], 10);
+    const s = matchLast(text, /(\d+)\s+pending/);
+    if (s) out.skipped = parseInt(s[1], 10);
+    out.total = sumDefined(out.passed, out.failed, out.skipped);
+    out.failures = collectFailures(text, /^\s*\d+\)\s+(.+)$/gm).slice(0, 50);
+    return out;
+  },
+
+  // -------- node --test (TAP-ish) --------
+  //   # tests 10
+  //   # pass 8
+  //   # fail 2
+  //   # skip 0
+  //   # duration_ms 123.456
+  'node-test'(text) {
+    const out = {};
+    const t = matchLast(text, /#\s+tests\s+(\d+)/);
+    const p = matchLast(text, /#\s+pass\s+(\d+)/);
+    const f = matchLast(text, /#\s+fail\s+(\d+)/);
+    const s = matchLast(text, /#\s+skip\s+(\d+)/);
+    const d = matchLast(text, /#\s+duration_ms\s+([\d.]+)/);
+    if (t) out.total = parseInt(t[1], 10);
+    if (p) out.passed = parseInt(p[1], 10);
+    if (f) out.failed = parseInt(f[1], 10);
+    if (s) out.skipped = parseInt(s[1], 10);
+    if (d) out.duration_ms = Math.round(parseFloat(d[1]));
+    return out;
+  },
+
+  // -------- tap --------
+  //   1..10
+  //   ok 1 ...
+  //   not ok 2 ...
+  tap(text) {
+    const planMatch = matchLast(text, /^\s*1\.\.(\d+)/m);
+    const okLines = (text.match(/^\s*ok\s+\d+/gm) || []).length;
+    const notOk = (text.match(/^\s*not ok\s+\d+/gm) || []).length;
+    return {
+      total: planMatch ? parseInt(planMatch[1], 10) : okLines + notOk,
+      passed: okLines,
+      failed: notOk,
+      skipped: (text.match(/^\s*ok\s+\d+\s+#\s+(SKIP|TODO)/gim) || []).length,
+    };
+  },
+
+  // -------- go test --------
+  //   PASS / FAIL lines per test, then "ok package time" or "FAIL package time"
+  //   With -v, lines like "--- PASS: TestX (0.01s)" / "--- FAIL: TestY (0.00s)"
+  go(text) {
+    const passed = (text.match(/^--- PASS:/gm) || []).length;
+    const failed = (text.match(/^--- FAIL:/gm) || []).length;
+    const skipped = (text.match(/^--- SKIP:/gm) || []).length;
+    const failureNames = [];
+    let m;
+    const re = /^--- FAIL:\s+(\S+)/gm;
+    while ((m = re.exec(text)) !== null) failureNames.push(m[1]);
+    return {
+      total: passed + failed + skipped,
+      passed, failed, skipped,
+      failures: failureNames.map((n) => ({ name: n })).slice(0, 50),
+    };
+  },
+
+  // -------- pytest --------
+  //   ============== 2 failed, 8 passed, 1 skipped in 1.23s ==============
+  pytest(text) {
+    const out = {};
+    const m = matchLast(text, /=+\s*([^=]+?)\s+in\s+([\d.]+)s\s*=+/);
+    if (m) {
+      const seg = m[1];
+      out.failed  = numField(seg, /(\d+)\s+failed/);
+      out.passed  = numField(seg, /(\d+)\s+passed/);
+      out.skipped = numField(seg, /(\d+)\s+skipped/);
+      out.duration_ms = Math.round(parseFloat(m[2]) * 1000);
+      out.total = sumDefined(out.failed, out.passed, out.skipped);
+    }
+    out.failures = collectFailures(text, /^FAILED\s+(.+?)\s+-/gm).slice(0, 50);
+    return out;
+  },
+
+  // -------- python unittest --------
+  //   Ran 10 tests in 0.123s
+  //   FAILED (failures=2, errors=1, skipped=1)
+  unittest(text) {
+    const out = {};
+    const r = matchLast(text, /Ran\s+(\d+)\s+tests?\s+in\s+([\d.]+)s/);
+    if (r) {
+      out.total = parseInt(r[1], 10);
+      out.duration_ms = Math.round(parseFloat(r[2]) * 1000);
+    }
+    const fail = matchLast(text, /FAILED\s+\(([^)]+)\)/);
+    if (fail) {
+      out.failed = (numField(fail[1], /failures=(\d+)/) || 0) + (numField(fail[1], /errors=(\d+)/) || 0);
+      out.skipped = numField(fail[1], /skipped=(\d+)/) || 0;
+    } else if (/^OK\b/m.test(text)) {
+      out.failed = 0;
+    }
+    if (out.total != null) out.passed = out.total - (out.failed || 0) - (out.skipped || 0);
+    return out;
+  },
+
+  // -------- generic fallback --------
+  generic(text) {
+    // Try to extract any "X passed, Y failed" pattern.
+    const out = {};
+    out.passed = numField(text, /(\d+)\s+passed/);
+    out.failed = numField(text, /(\d+)\s+failed/);
+    out.skipped = numField(text, /(\d+)\s+skipped/);
+    out.total = sumDefined(out.passed, out.failed, out.skipped);
+    return out;
+  },
+};
+
+function matchLast(text, re) {
+  if (re.global) {
+    let last;
+    let m;
+    while ((m = re.exec(text)) !== null) { last = m; }
+    return last || null;
+  }
+  // Find all matches by repeatedly matching in remaining text.
+  const matches = [];
+  const lines = text.split('\n');
+  for (const line of lines) {
+    const m = line.match(re);
+    if (m) matches.push(m);
+  }
+  return matches[matches.length - 1] || null;
+}
+
+function numField(text, re) {
+  const m = text.match(re);
+  return m ? parseInt(m[1], 10) : 0;
+}
+
+function sumDefined(...nums) {
+  let s = 0; let any = false;
+  for (const n of nums) if (n != null) { s += n; any = true; }
+  return any ? s : null;
+}
+
+function collectFailures(text, re) {
+  const out = [];
+  let m;
+  while ((m = re.exec(text)) !== null) {
+    out.push({ name: m[1].trim() });
+  }
+  return dedupeBy(out, (x) => x.name);
+}
+
+function dedupeBy(arr, key) {
+  const seen = new Set();
+  const out = [];
+  for (const x of arr) {
+    const k = key(x);
+    if (seen.has(k)) continue;
+    seen.add(k);
+    out.push(x);
+  }
+  return out;
+}
+
+module.exports = { parse };

package/src/templates/files/ci/github.yml

@@ -0,0 +1,38 @@
+name: devflow
+
+on:
+  pull_request:
+    paths:
+      - 'devflow/**'
+  push:
+    branches: [ ${defaultBranch} ]
+    paths:
+      - 'devflow/knowledge/**'
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: '20' }
+      - run: npm i -g devflow-kit
+      - name: validate change folders
+        run: devflow doctor --scope=changes --json
+      - name: validate knowledge meta
+        run: devflow knowledge validate
+
+  knowledge-sync:
+    if: github.event_name == 'push' && github.ref == 'refs/heads/${defaultBranch}'
+    runs-on: ubuntu-latest
+    needs: validate
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: '20' }
+      - run: npm i -g devflow-kit
+      - name: incremental kb sync
+        env:
+          WEKNORA_TOKEN: ${{ secrets.WEKNORA_TOKEN }}
+          DEVFLOW_KB_DRY_RUN: ${{ vars.DEVFLOW_KB_DRY_RUN || '0' }}
+        run: devflow knowledge sync

package/src/templates/files/ci/gitlab.yml

@@ -0,0 +1,27 @@
+stages: [ validate, sync ]
+
+variables:
+  DEVFLOW_KB_DRY_RUN: "0"
+
+devflow:validate:
+  stage: validate
+  image: node:20
+  script:
+    - npm i -g devflow-kit
+    - devflow doctor --scope=changes --json
+    - devflow knowledge validate
+  rules:
+    - changes: [ "devflow/**/*" ]
+
+devflow:knowledge-sync:
+  stage: sync
+  image: node:20
+  needs: [ devflow:validate ]
+  variables:
+    WEKNORA_TOKEN: $WEKNORA_TOKEN
+  script:
+    - npm i -g devflow-kit
+    - devflow knowledge sync
+  rules:
+    - if: '$CI_COMMIT_BRANCH == "${defaultBranch}"'
+      changes: [ "devflow/knowledge/**/*" ]

package/src/templates/files/design.md

@@ -0,0 +1,63 @@
+---
+slug: ${slug}
+phase: design
+status: draft
+---
+
+# 技术方案 — ${title}
+
+## 1. 方案总览
+
+(一句话描述方案与边界)
+
+## 2. 架构变更
+
+```
+(简单 ASCII 或 mermaid)
+```
+
+## 3. 模块/类/方法清单
+
+| 模块 | 改动类型 | 说明 |
+|------|---------|------|
+| | 新建/修改/删除 | |
+
+## 4. 接口契约 {#contracts}
+
+| 接口 | 方法 | 入参 | 出参 | 说明 |
+|------|------|------|------|------|
+| /api/xxx | POST | | | |
+
+### YAPI / OpenAPI 同步
+
+- 契约文件：
+- 同步命令：`devflow sync yapi --file=<openapi.json|api.md> --dry-run`
+
+## 5. 数据库 DDL {#ddl}
+
+```sql
+-- 必须可重复执行(IF NOT EXISTS / IF EXISTS),禁止破坏性 DROP
+```
+
+## 6. 核心流程
+
+(关键路径的伪代码或时序图)
+
+### 调用链一致性验证
+
+- traceId / requestId 传递点：
+- 调用方 / 回调 / redirect / query 参数：
+- 日志检索：`devflow logs query --trace-id=<id>` 或 `--request-id=<id>`
+- 验证命令：`devflow test contract --cmd="<contract/check command>"`
+
+## 7. 错误处理与回滚
+
+## 8. 监控与告警
+
+## 9. 兼容性与灰度
+
+## 10. 备选方案与取舍
+
+## 11. spec delta(可选)
+
+> 若本方案改变了系统能力,运行 \`devflow design --with-spec\` 在 \`delta/\` 下生成对应能力的 ADDED/MODIFIED/REMOVED 文件。

package/src/templates/files/ide/devflow-workflow.md

@@ -0,0 +1,58 @@
+> 本段由 \`devflow-kit\` 维护,请勿手工编辑。运行 \`devflow update\` 升级。
+
+## devflow 工作流
+
+### 入口路由
+
+| 输入 | 命令 |
+|------|------|
+| Wiki/Confluence/Notion URL | \`devflow ingest <url>\` |
+| JIRA/Linear/GitHub Issue ID | \`devflow ingest <id>\` |
+| 故障告警 | \`devflow ingest incident:<id>\` |
+| 纯想法(无外部输入) | \`devflow new <slug>\`(触发 brainstorm) |
+
+### 阶段-命令映射
+
+| 阶段 | 命令 | 产物 |
+|------|------|------|
+| 立项 | \`devflow propose\` | proposal.md |
+| 需求澄清 | \`devflow requirement\` | requirement.md |
+| 技术设计 | \`devflow design [--with-tests] [--with-spec]\` | design.md (+ tests.md, delta/) |
+| 任务计划 | \`devflow plan\` | plan.md |
+| 编码 | \`devflow apply [--task N]\` | 代码 + commits |
+| 审查 | \`devflow review\` | review.md(3 轮迭代) |
+| 测试 | \`devflow test <unit\|integration\|e2e\|joint\|remote\|smoke\|regression\|perf>\` | reports/test-report.md#<kind> |
+| 自测报告 | \`devflow report self-test\` | reports/test-report.md#self-test |
+| 验证 | \`devflow verify [finalize]\` | verify.md |
+| 收尾 | \`devflow deliver\` | merge / PR / keep / discard |
+| 归档 | \`devflow archive\` | archive/ + spec delta 合并 |
+
+### ⛔ AI Agent 强制规则：devflow 命令必须用 Shell 工具执行
+
+**当用户给出 Wiki/Confluence/Notion/JIRA 等 URL 或 ID 时：**
+
+```
+✅ 正确：调用 Shell/Terminal 工具 → devflow ingest "<url>"
+❌ 禁止：WebFetch 工具 / curl / browser 工具 / 让用户复制粘贴内容
+```
+
+- `devflow ingest` 通过已配置的 provider + 认证 token 访问内网，AI 自身无法直接访问内网 URL
+- 即使 WebFetch 报超时/401，**正确响应是执行 Shell 命令**，不是放弃或让用户粘贴
+- 如果 `devflow ingest` 失败（exit ≠ 0），读取错误输出诊断原因，不要绕过它
+
+**所有 `devflow *` 命令的执行方式：Shell 工具 → `cd <project_dir> && devflow <subcmd>`**
+
+### 硬规则
+
+- 任何代码改动必须先 \`devflow plan\`,先写测试再写实现
+- \`devflow review\` 失败 ≥ 3 轮必须升级 \`design.md\` 重新评审
+- \`devflow verify finalize\` 校验所有启用的报告存在,无报告不得 \`devflow deliver\`
+- \`devflow archive\` 时 spec delta 自动合并到 \`devflow/specs/\`
+- 凭证不得写入任何 markdown 产物;\`devflow doctor\` 会扫描 token 嫌疑
+
+### 斜杠命令(Claude Code / Cursor)
+
+- \`/df:ingest <input>\` — 等价 \`devflow ingest\`
+- \`/df:design\` / \`/df:plan\` / \`/df:review\` / \`/df:verify\` / \`/df:archive\`
+- \`/df:status\` — 当前 change 阶段总览
+- \`/df:doctor\` — 7 维度体检

package/src/templates/files/ide/project-overview-reference.md

@@ -0,0 +1 @@
+> 项目概览维持在 [\`${overviewSource}\`](${overviewSource}),devflow 不在此重复维护。Skills 会从 \`devflow/config.json#projectOverview.referencedFile\` 读取并加载该文件作为上下文。运行 \`devflow sync project --check\` 检查漂移。

package/src/templates/files/ide/project-overview.md

@@ -0,0 +1,27 @@
+> 本段由 \`devflow-kit\` 维护,请勿手工编辑。源:${overviewSource}。运行 \`devflow sync project\` 刷新。
+
+## 项目概览
+
+### 技术栈
+
+- 语言 / 运行时:${stack}
+- 框架:${frameworks}
+- 包管理:${packageManager}
+
+### 模块结构
+
+${modules}
+
+### 常用命令
+
+\`\`\`
+${commands}
+\`\`\`
+
+### 编码规范
+
+${codingStyle}
+
+### 测试规范
+
+${testingStyle}

package/src/templates/files/knowledge-index.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://devflow.dev/schemas/knowledge-index.schema.json",
+  "version": 2,
+  "layout": "flat",
+  "categories": [
+    { "id": "concepts",     "label": "领域概念",  "examples": ["保险术语表.md", "订单状态机.md"] },
+    { "id": "rules",        "label": "业务规则",  "examples": ["合规跳转决策表.md"] },
+    { "id": "scenarios",    "label": "业务场景",  "examples": ["保险补贴申请.md"] },
+    { "id": "contracts",    "label": "接口契约",  "examples": ["订单 REST API.md", "Kafka events.md"] },
+    { "id": "decisions",    "label": "架构决策",  "examples": ["[SCRUM-001] xxx - 技术方案.md"] },
+    { "id": "services",     "label": "服务信息",  "examples": ["[order_service] 概述.md"] },
+    { "id": "environments", "label": "环境配置",  "examples": [] },
+    { "id": "incidents",    "label": "故障复盘",  "examples": [] },
+    { "id": "runbooks",     "label": "运维手册",  "examples": [] },
+    { "id": "solutions",    "label": "解决方案",  "examples": ["[slug] 经验总结.md"] }
+  ]
+}

package/src/templates/files/knowledge.md

@@ -0,0 +1,28 @@
+---
+slug: ${slug}
+phase: knowledge-query
+ts: ${date}
+---
+
+# 知识库检索结果 — ${title}
+
+## 查询
+
+- 关键词:${query}
+- 数据源:${sources}
+
+## 命中(本地)
+
+| 文件 | 摘要 | 评分 |
+|------|------|------|
+| | | |
+
+## 命中(远端)
+
+| 来源 | 标题 | 链接 | 评分 |
+|------|------|------|------|
+| | | | |
+
+## 与本次任务的关联
+
+- (人工标注哪些条目影响本次设计、应在 design.md 引用)

package/src/templates/files/meta.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://devflow.dev/schemas/meta.schema.json",
+  "category": "${category}",
+  "tag_name": "${tag_name}",
+  "tag_id": "",
+  "external": {},
+  "files": {}
+}

package/src/templates/files/plan.md

@@ -0,0 +1,38 @@
+---
+slug: ${slug}
+phase: plan
+status: draft
+---
+
+# 任务计划 — ${title}
+
+> 原则:bite-size 任务 + TDD。每条任务可在 30~60min 内交付,先写测试再写实现。
+
+## 任务清单
+
+### T-1 (任务描述)
+
+- 文件:\`path/to/file.ts\`
+- 行为:(测试可断言的具体行为)
+- 测试:
+  - [ ] unit:断言 X 在 Y 条件下返回 Z
+- 实现:
+  - [ ] 先让测试失败
+  - [ ] 实现到测试通过
+- 提交:\`feat(scope): T-1 ...\`
+
+### T-2
+
+(同上)
+
+## 顺序与依赖
+
+```
+T-1 → T-2 → T-3
+```
+
+## 检查点
+
+- [ ] 所有任务测试通过
+- [ ] \`devflow review\` 通过
+- [ ] \`devflow verify\` 通过