campfire-cli 0.1.12__tar.gz → 0.1.13__tar.gz

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/.github/workflows/ci.yml

@@ -7,11 +7,10 @@ on:
 
 jobs:
   test:
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-    runs-on: ${{ matrix.os }}
+    concurrency:
+      group: ci-${{ github.workflow }}-${{ github.ref }}
+      cancel-in-progress: true
+    runs-on: ubuntu-latest
     env:
       PYTHONUTF8: "1"
     steps:
@@ -22,7 +21,5 @@ jobs:
           cache-dependency-glob: "uv.lock"
       - name: Install dependencies
         run: uv sync --frozen
-      - name: Lint
-        run: uv run ruff check src tests
-      - name: Test
-        run: uv run pytest -q
+      - name: Quality check
+        run: uv run python scripts/quality_check.py

campfire_cli-0.1.13/.github/workflows/release.yml

@@ -0,0 +1,39 @@
+name: release
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  quality:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    env:
+      PYTHONUTF8: "1"
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v10.1.0
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+      - name: Install dependencies
+        run: uv sync --frozen
+      - name: Release quality check
+        run: uv run python scripts/quality_check.py --release
+
+  publish:
+    needs: quality
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v10.1.0
+      - name: Build
+        run: uv build
+      - name: Publish to PyPI
+        run: uv publish

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/ARCHITECTURE.md

@@ -82,6 +82,8 @@ Document App 同时拥有设备本地的文档查询投影。Indexer 从 Markdow
 
 Frontmatter 规则采用声明式 Profile：`base` 是最小公共契约，`knowledge`、`project-doc`、`task` 只允许一层继承。Profile Loader 将配置编译为完整 EffectiveProfile，Resolver 根据文档类型和领域上下文选择 Profile，Validator 与 Formatter 共同消费该结果。字段规则不使用每种文档一个 Python 子类，也不在 Skill 中复制。
 
+`template` 直接使用 base Profile，物理存放在 Domain 的 `_模板/`。模板作用域由 Domain 拓扑和路径确定；Skill 从目标 Domain 向祖先查找同名模板并使用最近的一份，系统不建立模板注册表或继承状态。
+
 ### CLI 设计理念：治理原语 + Skill SOP
 
 Campfire 不是“Markdown 版 kubectl”，而是面向人机协作场景组合成熟 CLI 经验形成的独立设计。它在资源心智模型、`apply` 语义和机器可读接口上借鉴 kubectl，在“计划—审查—执行”上借鉴 Terraform，在稳定原语与上层工作流分离上借鉴 Git/Unix；Markdown SSOT、Agent 语义判断和显式 Maintenance 则是 Campfire 自身边界。

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/COMMAND.md

@@ -51,6 +51,8 @@ Space、Domain、Project 的 `create`/`adopt`，以及文档移动、重构、
 
 `document apply` 可新建、更新、为已有正文补齐 Frontmatter，或通过显式 `--type` 原子转换文档类型。创建或唯一更新时可省略 `.md`；创建和类型转换时还可省略类型前缀。CLI 在 `normalization` 中返回每项标准化，并在 `target` 中返回最终路径；调用方不手工同步类型、前缀与 Markdown 后缀。`document move` 可在任意已声明 Domain 之间移动单篇文档并对齐可确定的 `domain`/`project`。目标 Profile 缺少语义字段时返回 `missing_fields`，调用方补齐明确业务值。只有实际写入成功的结果才可返回零或一个、且可直接执行的 scoped `maintenance sync` follow-up；Domain 内部路径会归一化为对应 Domain，预览、阻塞或无派生影响时返回空列表。具体参数以对应命令的 `-h` 为准。
 
+`template` 使用 base Profile，必须位于 Domain 的 `_模板/`。模板查找与应用由 Skill 按最近 Domain 规则完成，不新增模板专用命令。
+
 `--set` 的值类型由有效 Profile 决定，不使用 YAML 隐式类型推断。enum、string 和 date 保留原始字符串，boolean 只接受 `true` 或 `false`，list 只接受严格 JSON 数组。标量可写为 `--set lifecycle=completed`，列表在 Shell 中使用单引号保护，例如 `--set 'tags=["tag1","tag2"]'`。CLI 不把 `tag1,tag2` 猜成列表；格式错误时通过稳定错误码、期望类型和参数示例说明修复方式。字段与枚举不在本命令清单重复登记。
 
 `document list` 是 SQLite 查询投影上的精确集合枚举，多个筛选条件使用 AND 语义，`--type task` 不隐式排除任何 lifecycle。`document inspect` 在原有 Profile 和问题上下文之外返回 declared、outgoing、incoming 与 unresolved 确定关系。两条读取命令查询前自动 reconcile；Agent 取得路径后用文件工具读取正文，不需要先跑 Maintenance。未来正文关键词、模糊匹配和相关性排序使用独立 `document search`，不改变 list/inspect 的确定语义。

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: campfire-cli
-Version: 0.1.12
+Version: 0.1.13
 Summary: Local-first shared context and governance CLI for humans and agents
 License-Expression: MIT
 License-File: LICENSE
@@ -102,6 +102,8 @@ campfire document type list                      # 文档类型与前缀
 campfire decision create / list / answer / close # 持久决策通道
 ```
 
+Domain 可在 `_模板/` 中维护基础属性的 `template` 文档。Agent 创建结构化文档时按当前 Domain 到祖先 Domain 的顺序使用最近同名模板；模板只提供正文骨架，不替代目标文档 Profile。
+
 结构治理命令默认只输出计划，追加 `--confirm` 才执行：
 
 ```bash

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/README.md

@@ -86,6 +86,8 @@ campfire document type list                      # 文档类型与前缀
 campfire decision create / list / answer / close # 持久决策通道
 ```
 
+Domain 可在 `_模板/` 中维护基础属性的 `template` 文档。Agent 创建结构化文档时按当前 Domain 到祖先 Domain 的顺序使用最近同名模板；模板只提供正文骨架，不替代目标文档 Profile。
+
 结构治理命令默认只输出计划，追加 `--confirm` 才执行：
 
 ```bash

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/SPEC.md

@@ -34,6 +34,7 @@ SQLite / Filesystem Implementation
 - 命令不得读取“最近一次操作”等隐式 Session 状态推导对象或作用域；跨命令后续动作只使用当前结果显式返回的结构化 `follow_up`。
 - 所有写入默认预检，语义计划默认未审批。
 - 写入用例必须在治理锁内复核生成计划时的内容哈希，发现外部变化时拒绝覆盖。
+- Domain 在 `_模板/` 中持有基础 Profile 的 `template` 文档；同名模板仅按目标 Domain 到祖先 Domain 的最近路径选择，不保存继承状态或合并模板。
 
 代码风格参考 `templates/fastapi-template`，但不引入 HTTP、WebSocket、认证和异步数据库等无关能力。
 
@@ -84,6 +85,7 @@ Campfire 使用语义化版本：
 - 删除或重命名公共命令、改变不可兼容的数据格式时增加主版本；`0.x` 阶段仍应显式记录破坏性变化。
 - 配置文件的 `version` 独立于 Python 包版本；只有配置结构或解释语义变化时递增。
 - PyPI、源码标签、构建产物和 CLI 报告的版本必须一致。
+- 发布标签必须先通过三平台测试、构建与 wheel 隔离安装；Release workflow 不得在质量门禁失败时发布。
 
 ## 设备边界
 

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "campfire-cli"
-version = "0.1.12"
+version = "0.1.13"
 description = "Local-first shared context and governance CLI for humans and agents"
 readme = "README.md"
 license = "MIT"

campfire_cli-0.1.13/scripts/quality_check.py

@@ -0,0 +1,108 @@
+"""
+SPEC:
+  name: quality_check
+  purpose: 运行本地与 CI 共用的快速或发布质量门禁
+  idempotent: true
+  side_effects:
+    - 发布门禁在临时目录构建并安装包
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import subprocess
+import tempfile
+import tomllib
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def run(*command: str) -> None:
+    subprocess.run(command, cwd=ROOT, check=True)
+
+
+def project_version() -> str:
+    with (ROOT / "pyproject.toml").open("rb") as handle:
+        return str(tomllib.load(handle)["project"]["version"])
+
+
+def check_tag(version: str) -> None:
+    tag = os.environ.get("GITHUB_REF_NAME")
+    if tag and tag.startswith("v") and tag != f"v{version}":
+        raise SystemExit(f"tag {tag} does not match project version {version}")
+
+
+def smoke_test_wheel(version: str) -> None:
+    with tempfile.TemporaryDirectory(prefix="campfire-quality-") as raw_directory:
+        directory = Path(raw_directory)
+        dist = directory / "dist"
+        environment = directory / "venv"
+        workspace = directory / "workspace"
+        run("uv", "build", "--out-dir", str(dist))
+        wheels = list(dist.glob("*.whl"))
+        source_distributions = list(dist.glob("*.tar.gz"))
+        if len(wheels) != 1 or len(source_distributions) != 1:
+            raise SystemExit("build must produce exactly one wheel and one source distribution")
+        wheel = wheels[0]
+        run("uv", "venv", str(environment))
+        executable_dir = "Scripts" if os.name == "nt" else "bin"
+        python = environment / executable_dir / ("python.exe" if os.name == "nt" else "python")
+        campfire = environment / executable_dir / (
+            "campfire.exe" if os.name == "nt" else "campfire"
+        )
+        run("uv", "pip", "install", "--python", str(python), str(wheel))
+        smoke_environment = os.environ.copy()
+        smoke_environment.update(
+            {
+                "CAMPFIRE_HOME": str(directory / "campfire-home"),
+                "CAMPFIRE_AGENT_HINT_PATH": str(directory / "agent-hints"),
+                "CAMPFIRE_SKILL_TARGETS": str(directory / "agent-skills"),
+            }
+        )
+        installed = subprocess.run(
+            [str(campfire), "version"],
+            cwd=ROOT,
+            check=True,
+            capture_output=True,
+            text=True,
+            env=smoke_environment,
+        ).stdout.strip()
+        if installed != version:
+            raise SystemExit(f"installed version {installed} does not match {version}")
+        workspace.mkdir()
+        subprocess.run(
+            [str(campfire), "setup", "--path", str(workspace), "--id", "smoke"],
+            cwd=ROOT,
+            check=True,
+            capture_output=True,
+            text=True,
+            env=smoke_environment,
+        )
+        output = subprocess.run(
+            [str(campfire), "--workspace", "smoke", "document", "type", "list"],
+            cwd=ROOT,
+            check=True,
+            capture_output=True,
+            text=True,
+            env=smoke_environment,
+        ).stdout
+        json.loads(output)
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--release", action="store_true")
+    arguments = parser.parse_args()
+    run("uv", "run", "ruff", "check", "src", "tests", "scripts")
+    run("uv", "run", "pytest", "-q")
+    if arguments.release:
+        version = project_version()
+        check_tag(version)
+        smoke_test_wheel(version)
+
+
+if __name__ == "__main__":
+    main()

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/src/campfire_cli/__init__.py

@@ -1,3 +1,3 @@
 """Campfire CLI package."""
 
-__version__ = "0.1.12"
+__version__ = "0.1.13"

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/src/campfire_cli/app/document/SPEC.md

@@ -45,6 +45,7 @@ document/
 - `list`：按 Project、Domain、类型和生命周期对索引做精确 AND 筛选；返回全部生命周期，不读取或复制正文。
 - `inspect`：向 Agent 返回单篇文档的 Domain、类型、有效 Profile、具体问题，以及 declared、outgoing、incoming、unresolved 四类确定关系。
 - `apply`：根据目标路径和类型解析 Profile，不存在时生成文档，已有 Frontmatter 时只应用显式补丁，无 Frontmatter 时保留正文并补齐完整契约；先完整渲染并校验，追加 `--confirm` 后原子写入。
+- `template`：只继承 base Profile，必须位于所属 Domain 的 `_模板/`；Domain 归属由物理路径解析，不在 Frontmatter 复制模板作用域或继承关系。
 - `move`：在任意已声明 Domain 之间移动或改名一篇文档，按目标 Profile 对齐可确定的 `domain`/`project` 归属，并更新可确定解析的 Wiki、Markdown 和路径引用。目标 Profile 缺少业务字段时返回 `needs-input`，不猜测。
 - `scanner`：统一解释受管根、忽略目录和豁免文件；Document 与 Maintenance 共用。
 

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/src/campfire_cli/app/document/service/document_apply_service.py

@@ -99,9 +99,16 @@ class DocumentApplyService:
 
         today = date.today().isoformat()
         frontmatter = dict(parsed.frontmatter)
+        profile = None
         if not exists or not parsed.has_frontmatter:
-            frontmatter.update(self._creation_defaults(target, context, document_type, today))
-        profile = self._profiles.resolve(document_type, frontmatter, target)
+            defaults = self._creation_defaults(target, document_type, today)
+            profile = self._profiles.resolve(document_type, defaults, target)
+            if "domain" in profile.allowed:
+                defaults["domain"] = context.domain_id
+            if context.project_id and "project" in profile.allowed:
+                defaults["project"] = context.project_id
+            frontmatter.update(defaults)
+        profile = profile or self._profiles.resolve(document_type, frontmatter, target)
         actual_hash = file_sha256(source) if exists else "missing"
         unknown = sorted(set(request.values) - set(profile.allowed))
         if unknown:
@@ -226,7 +233,6 @@ class DocumentApplyService:
     def _creation_defaults(
         self,
         path: Path,
-        context: DomainContext,
         document_type: str,
         today: str,
     ) -> dict[str, Any]:
@@ -239,9 +245,6 @@ class DocumentApplyService:
             "updated": today,
             "tags": [],
         }
-        values["domain"] = context.domain_id
-        if context.project_id:
-            values["project"] = context.project_id
         return values
 
     @staticmethod

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/src/campfire_cli/app/document/service/document_rule_service.py

@@ -349,6 +349,11 @@ class DocumentRuleService:
         issues: list[dict[str, Any]] = []
         status = frontmatter.get("status")
         lifecycle = frontmatter.get("lifecycle")
+        in_template_directory = "_模板" in path.parts
+        if document_type == "template" and path.parent.name != "_模板":
+            issues.append({"code": "template-directory-required", "path": relative})
+        elif in_template_directory and document_type != "template":
+            issues.append({"code": "template-directory-type-mismatch", "path": relative})
         in_archive = "archive" in path.parts
         if in_archive != (status == "archived" and lifecycle == "archived") and (
             in_archive or status == "archived" or lifecycle == "archived"

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/src/campfire_cli/app/maintenance/SPEC.md

@@ -4,6 +4,8 @@
 
 文档扫描、类型、Profile、任务状态、模板枚举、Frontmatter 顺序、跨字段不变量与确定关系索引均委托 Document App；本模块只负责检查编排、过滤、可见派生内容和报告。全量 check 或 scoped sync 通过消费方维护端口触发 Document Index 校正，不依赖具体 Document Service，也不得实现第二套索引规则。写入通过共享 ChangeSet Executor 复核内容哈希并原子提交。
 
+Domain MOC 只列出该 Domain `_模板/` 中实际存在的模板；Maintenance 不计算或持久化模板继承结果，Agent 按 Domain 祖先路径就近选择。
+
 受管范围由当前 Workspace 中实际存在的 `_空间.md` 动态发现，不使用固定 Space 白名单；`scope_roots` 只补充收件箱等非 Space 系统范围。声明文件由 Workspace App 校验，不计入普通文档问题。
 
 `check --scope` 的 status 表示当前筛选结果，`workspace_status` 表示全 Workspace 状态。`sync --scope` 只发现并扫描 scope 内的 Domain 和文档，一次刷新 MOC、关系页并触发文档索引 reconcile；只受当前范围的结构问题阻塞。`document list/inspect` 不以 Maintenance 为前置步骤。单篇内容创建、补全和修改属于 Document App，批量迁移属于 Workspace Restructure。

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/src/campfire_cli/app/maintenance/service/maintenance_service.py

@@ -212,6 +212,9 @@ class MaintenanceService:
         notes_by_domain = {
             domain.id: governance_sync.direct_notes(domain, marker_name) for domain in domains
         }
+        templates_by_domain = {
+            domain.id: governance_sync.direct_templates(domain) for domain in domains
+        }
         project_domain_ids = {
             domain.id for domain in domains if domain.governance == "project-docs"
         }
@@ -239,7 +242,12 @@ class MaintenanceService:
             note_count += len(notes)
             if domain.governance == "project-docs":
                 generated = governance_sync.generate_project_domain_content(
-                    domain, domains, notes, marker_name, type_mapping
+                    domain,
+                    domains,
+                    notes,
+                    templates_by_domain[domain.id],
+                    marker_name,
+                    type_mapping,
                 )
             else:
                 relation_page = None
@@ -256,7 +264,7 @@ class MaintenanceService:
                     if existing != relation_content:
                         changes.append((relation_page, relation_content))
                 generated = governance_sync.generate_domain_content(
-                    domain, domains, notes, relation_page
+                    domain, domains, notes, templates_by_domain[domain.id], relation_page
                 )
             moc = domain.path / f"{domain.moc}.md"
             if not moc.is_file():

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/src/campfire_cli/app/maintenance/service/moc_service.py

@@ -18,6 +18,7 @@ SPEC:
 
 from __future__ import annotations
 
+import os
 import re
 from collections import Counter
 from pathlib import Path
@@ -126,6 +127,26 @@ def direct_notes(domain: Domain, marker_name: str) -> list[Path]:
     )
 
 
+def direct_templates(domain: Domain) -> list[Path]:
+    """Return templates physically owned by this Domain."""
+    directory = domain.path / "_模板"
+    if not directory.is_dir():
+        return []
+    return sorted(directory.glob("模板-*.md"), key=lambda path: path.name.casefold())
+
+
+def template_link(domain: Domain, template: Path) -> str:
+    moc_directory = (domain.path / f"{domain.moc}.md").parent
+    return Path(os.path.relpath(template.with_suffix(""), moc_directory)).as_posix()
+
+
+def append_template_section(lines: list[str], domain: Domain, templates: list[Path]) -> None:
+    if not templates:
+        return
+    lines.extend(["", "## 文档模板", ""])
+    lines.extend(f"- [[{template_link(domain, item)}|{item.stem}]]" for item in templates)
+
+
 def generate_relations(
     notes: list[Path],
     domain_by_note: dict[Path, str],
@@ -232,7 +253,11 @@ def write_if_changed(
 
 
 def generate_domain_content(
-    domain: Domain, domains: list[Domain], notes: list[Path], relation_page: Path | None
+    domain: Domain,
+    domains: list[Domain],
+    notes: list[Path],
+    templates: list[Path],
+    relation_page: Path | None,
 ) -> str:
     children = sorted(
         [item for item in domains if item.parent_domain == domain.id],
@@ -245,6 +270,7 @@ def generate_domain_content(
     lines.extend([f"- [[{child.moc}|{child.name}]]" for child in children] or ["- 暂无"])
     lines.extend(["", "## 本领域文档", ""])
     lines.extend([f"- [[{note.stem}]]" for note in notes] or ["- 暂无"])
+    append_template_section(lines, domain, templates)
     lines.extend(["", "## 自动关系", ""])
     lines.append(f"- [[{relation_page.stem}|相关文档计算结果]]" if relation_page else "- 暂无")
     return "\n".join(lines)
@@ -254,6 +280,7 @@ def generate_project_domain_content(
     domain: Domain,
     domains: list[Domain],
     notes: list[Path],
+    templates: list[Path],
     marker_name: str,
     project_doc_types: dict[str, dict[str, str]] | None = None,
 ) -> str:
@@ -316,6 +343,8 @@ def generate_project_domain_content(
                 rel = archived_note.relative_to(domain.path).with_suffix("")
                 lines.append(f"- [[{rel}|{archived_note.stem}]]：`{reason}`{suffix}")
             lines.append("")
+    append_template_section(lines, domain, templates)
+    lines.append("")
     return "\n".join(lines).rstrip()
 
 

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/src/campfire_cli/common/agent_hints.py

@@ -14,7 +14,8 @@ HINT_BODY = """## Campfire 文档治理
 当用户要求"沉淀/记录/写文档/归档/跟踪问题"到知识库或项目文档时：
 
 1. 用户已给出唯一存在路径，且只读取或小范围修改人工正文时，
-   直接使用文件工具；不加载 bootstrap，不调用 Campfire CLI。
+   先读取文档开头和最近 `_领域.md` 的人工规则，再直接使用文件工具；
+   不加载 bootstrap，不调用 Campfire CLI。
 2. 新建、Frontmatter、文件名、归属、移动、归档、派生维护或结构治理
    需要 Workspace、Project、Domain 或 Profile 上下文；当前 Session
    首次进入这类治理流程时加载 `campfire-context-bootstrap`。
@@ -33,10 +34,15 @@ HINT_BODY = """## Campfire 文档治理
 7. `--set` 的值类型由有效 Profile 决定；列表使用严格 JSON 数组。
    CLI 返回 `needs-input` 或输入错误时按结构化允许值和参数示例重试，
    不为通过检查而猜测。
+8. 创建结构化文档时，从目标 Domain 开始向父 Domain 查找
+   `_模板/模板-<用途>.md`，使用找到的第一份；不合并模板，不修改模板源文档。
+   模板不存在时使用对应 Skill 的最小结构，不自行发明复杂格式。
 
 `.campfire.yaml`、声明 Frontmatter、自动生成区域、Base、关系页和 SQLite
 是 CLI 管理资源。Agent 可以读取，但只能通过 Campfire 语义命令写入；缺少
 对应命令时停止并报告能力缺口，不直接编辑。声明文件标记外正文不受此限制。
+`_空间.md` 与 `_领域.md` 的人工正文维护局部业务规则；通用结构事实和索引
+由 CLI 生成，不手工重复维护。
 
 不要直接在代码仓库里创建笔记文件。Agent Hint 只规定入口纪律；
 字段、枚举和顺序以 Campfire Profile 为唯一事实来源。

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/src/campfire_cli/resources/defaults/config.yml

@@ -26,6 +26,7 @@ workspace:
   - archive
   - generated
   - _总览
+  - _模板
   - 记录
   - 任务
   - a_skill
@@ -48,6 +49,7 @@ governance:
   - 记录
   - archive
   - _总览
+  - _模板
   - a_skill
 document_types:
   version: 2
@@ -105,6 +107,9 @@ document_types:
     board:
       prefix: 看板-
       label: 看板
+    template:
+      prefix: 模板-
+      label: 模板
     requirement-doc:
       prefix: 需求-
       label: 需求
@@ -133,6 +138,7 @@ frontmatter_schema:
     profile_by_type:
       knowledge: knowledge
       task: task
+      template: base
     profile_by_governance:
       project-docs: project-doc
   profiles:

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/src/campfire_cli/resources/skills/campfire-document-capture/SKILL.md

@@ -107,6 +107,8 @@ campfire --workspace personal maintenance sync --scope "mywork/【某项目】
 
 预检通过后，知识、项目事实、方案、决策、问题、记录和任务统一交给 `campfire-workspace-maintenance` 选择 Space、Domain 与文档类型。创建文档、补齐无 Frontmatter 的既有正文、修改 Frontmatter 或显式变更类型，统一调用一次 `campfire document apply`；它会解析目标 Domain、继承 Project、从 type 推导文件名，并在完整 Profile 校验通过后原子写入。Frontmatter 契约已知时直接 apply；现有文档的字段类型或合法值未知时只执行一次 `document inspect` 后 apply，不从 `tree` 开始逐层探索。Agent 不手工同步 type 与文件名前缀。
 
+创建结构化文档时，根据用户意图确定简短模板名，从目标 Domain 开始沿父 Domain 查找 `_模板/模板-<名称>.md`，使用第一份匹配模板。模板只提供正文骨架：目标 Frontmatter 仍由实际文档类型的 Profile 生成；删除不适用章节，不虚构内容，不修改模板源文件。同级存在歧义时询问用户，找不到时使用当前垂直 Skill 的最小结构。模板只能在用户明确要求或确认后创建、修改、移动或删除。
+
 单篇文档在已声明 Domain 之间改名或移动使用一次 `document move`；Domain 合并或逻辑空删除加载 `campfire-workspace-restructure` 并使用 `domain merge/delete`，批量文档迁移或领域拆分才使用持久 restructure 批次。CLI 写入完成后只执行结果中实际返回的 `follow_up`，当前只可能是一个最小 scope 的 `maintenance sync`；没有 follow-up 就结束，不自行追加 dry-run、check 或全 Workspace 扫描。本 Skill 不复制文档 Profile、生命周期、字段枚举或结构重构步骤。
 
 ## Pending Decision

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/src/campfire_cli/resources/skills/campfire-document-capture/references//345/267/262/346/234/211/346/226/207/346/241/243/346/233/264/346/226/260.md

@@ -2,6 +2,6 @@
 
 1. 确认候选文档是当前主题的权威对象；需要关系上下文时运行 `document inspect --path <path>`。
 2. 保持原 Project 和 Domain，除非用户明确要求重新归属。
-3. 只改人工正文时直接做最小 Edit，并读取修改区域验证。
+3. 只改人工正文时先读取文档开头和最近 `_领域.md` 的人工维护规则，再做最小 Edit 并读取修改区域验证。
 4. 修改 Frontmatter、类型或文件名时使用 `document apply`；移动时使用 `document move`。
 5. 不修改 `AUTO-GENERATED` 标记内内容，只执行写命令实际返回的 follow-up。

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/src/campfire_cli/resources/skills/campfire-workspace-maintenance/SKILL.md

@@ -34,6 +34,8 @@ campfire workspace rebuild --confirm
 6. `maintenance sync --scope <path>` 只扫描 scope 内的 Domain 和文档，一次刷新 MOC、关系页并校正本机索引；不要随后无条件重复 sync 或扩大到整个 Workspace。
 7. 报告原始笔记变化、自动生成物和仍需用户确认的事项。无法从正文、领域上下文或项目事实唯一决定时，调用 `campfire decision create`；获得回答后调用 `decision answer`，答案被原任务消费后调用 `decision close`。
 
+Domain 可在 `_模板/` 中持有 `template` 类型文档。创建结构化文档时从目标 Domain 向父 Domain 查找同名模板并使用最近的一份；不合并模板，也不持久化继承结果。模板只使用 base Profile，创建和 Frontmatter 更新仍走 `document apply`。Maintenance 只在 Domain MOC 中列出当前 Domain 实际持有的模板。
+
 ## 路由
 
 ```text
@@ -76,6 +78,7 @@ Agent 负责理解正文、项目事实和业务语义；CLI 负责 Profile 校
 - 整个 Workspace 只有一个根 `_收件箱/`；语义无法唯一判断时进入待用户确认，不为追求检查通过而猜测。
 - `_空间.md` 声明 Space，`_领域.md` 声明可多级嵌套的 Domain；保留目录不是 Space 或 Domain。
 - `.campfire.yaml`、声明 Frontmatter、`AUTO-GENERATED` 标记区域、Base、关系页和 SQLite 可读但不可由 Agent 直接写入；必须使用对应 Campfire 语义命令。`_空间.md` 和 `_领域.md` 标记外的 Markdown 正文可由人或 Agent 自由编辑。
+- `_空间.md` 与 `_领域.md` 标记外正文维护当前作用域的特殊规则；可从结构和索引确定的通用事实由 CLI 生成，不在正文重复维护。
 - 自动生成内容必须位于成对、唯一且闭合的 `AUTO-GENERATED` 标记内；CLI 只替换标记内部，标记异常时停止，不猜测边界。
 - Project 单向绑定稳定根 Domain id；Domain 移动不改变绑定，子 Domain 通过祖先拓扑继承 Project。
 - 一篇文档只有一个主物理 Domain，可以出现在多个自动索引中。

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/tests/SPEC.md

@@ -3,4 +3,6 @@
 - Service 单元测试使用内存 Fake Protocol，不访问真实 Vault。
 - Repository 与 CLI 集成测试使用临时 Vault 和临时 SQLite。
 - 性能回归测试放 `tests/perf`，标记 `@pytest.mark.perf`；只断言确定性计数，如文件读取次数、子进程派生次数、`sys.modules` 成员，不断言墙钟时间。
+- 所有测试默认隔离 Campfire 用户状态，不读取真实 `~/.campfire`、Workspace 注册、Skill 或 Agent Hint。
+- CLI 测试验证参数和结构化契约；不把 ANSI、Rich 边框、终端换行或完整中文句子当作稳定 API。
 - 所有写入路径必须覆盖预检失败、幂等、哈希变化和中途异常场景。

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/tests/conftest.py

@@ -10,7 +10,8 @@ from campfire_cli.app.workspace.schema.workspace_schema import WorkspaceEntry, W
 
 @pytest.fixture(autouse=True)
 def _isolate_agent_hints(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
-    """所有测试的全局资源写入一律落在临时目录。"""
+    """Keep every user-scoped Campfire resource inside the test directory."""
+    monkeypatch.setenv("CAMPFIRE_HOME", str(tmp_path / "campfire-home"))
     monkeypatch.setenv("CAMPFIRE_AGENT_HINT_PATH", str(tmp_path / "agent-hints"))
     monkeypatch.setenv("CAMPFIRE_SKILL_TARGETS", str(tmp_path / "agent-skills"))
 

{campfire_cli-0.1.12 → campfire_cli-0.1.13}/tests/unit/test_document_apply.py

@@ -87,6 +87,52 @@ def test_apply_derives_create_filename_from_type(workspace: Path) -> None:
     assert [item.scope for item in result.follow_up] == ["mywork/【Example】文档中心"]
 
 
+def test_apply_creates_base_profile_template_in_domain_template_directory(
+    workspace: Path,
+) -> None:
+    domain = project_domain(workspace)
+    relative = "mywork/【Example】文档中心/_模板/版本发布清单.md"
+
+    result = service(workspace).apply(
+        DocumentApplyRequest(
+            path=relative,
+            document_type="template",
+            values={"description": "版本发布清单模板"},
+            body="# 版本发布清单\n",
+            confirm=True,
+        )
+    )
+
+    target = domain / "_模板" / "模板-版本发布清单.md"
+    parsed = parse_document(target.read_text(encoding="utf-8"))
+    assert result.status == "applied"
+    assert result.profile == "base"
+    assert set(parsed.frontmatter) == {
+        "name",
+        "description",
+        "type",
+        "status",
+        "created",
+        "updated",
+        "tags",
+    }
+
+
+def test_apply_rejects_template_outside_domain_template_directory(workspace: Path) -> None:
+    project_domain(workspace)
+
+    result = service(workspace).apply(
+        DocumentApplyRequest(
+            path="mywork/【Example】文档中心/发布清单.md",
+            document_type="template",
+            values={"description": "版本发布清单模板"},
+        )
+    )
+
+    assert result.status == "blocked"
+    assert {issue["code"] for issue in result.issues} == {"template-directory-required"}
+
+
 def test_apply_normalizes_missing_markdown_extension_and_type_prefix(
     workspace: Path,
 ) -> None: