chattool 7.0.0__tar.gz → 7.0.2__tar.gz

{chattool-7.0.0/src/chattool.egg-info → chattool-7.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chattool
-Version: 7.0.0
+Version: 7.0.2
 Summary: Toolkit for Chat API
 Author-email: Rex Wang <1073853456@qq.com>
 License: MIT license

{chattool-7.0.0 → chattool-7.0.2}/src/chattool/__init__.py

@@ -4,7 +4,7 @@ import importlib
 
 __author__ = """Rex Wang"""
 __email__ = "1073853456@qq.com"
-__version__ = "7.0.0"
+__version__ = "7.0.2"
 
 from dotenv import load_dotenv
 

{chattool-7.0.0 → chattool-7.0.2}/src/chattool/setup/elements.py

@@ -194,7 +194,6 @@ def workspace_setup(
     dry_run,
     with_chattool,
     chattool_source,
-    with_opencode_loop,
 ):
     setup_workspace(
         profile_name=profile,
@@ -205,7 +204,6 @@ def workspace_setup(
         dry_run=dry_run,
         with_chattool=with_chattool,
         chattool_source=chattool_source,
-        with_opencode_loop=with_opencode_loop,
     )
 
 
@@ -690,13 +688,6 @@ SETUP_COMMAND_ELEMENTS = (
                     "help": "Git URL or local ChatTool repo path used when --with-chattool is enabled.",
                 },
             ),
-            SetupOptionElement(
-                param_decls=("--with-opencode-loop/--no-opencode-loop",),
-                kwargs={
-                    "default": False,
-                    "help": "Use the OpenCode loop-aware workspace template and install the global chatloop plugin and slash commands for OpenCode.",
-                },
-            ),
         ),
     ),
 )

{chattool-7.0.0 → chattool-7.0.2}/src/chattool/setup/workspace/cli.py

@@ -4,7 +4,6 @@ from pathlib import Path
 
 import click
 
-from chattool.setup.opencode import setup_opencode
 from chattool.interaction import (
     BACK_VALUE,
     abort_if_force_without_tty,
@@ -54,8 +53,6 @@ def _plan_workspace(
     language: str,
     enabled_options: list[str],
     profile,
-    *,
-    template_variant: str = "default",
 ) -> tuple[list[Path], dict[Path, str]]:
     dir_paths = [workspace_dir / rel for rel in BASE_DIRS]
     dir_paths.extend(workspace_dir / rel for rel in profile.extra_dirs())
@@ -65,7 +62,6 @@ def _plan_workspace(
         profile,
         language,
         enabled_options,
-        template_variant=template_variant,
         existing_workspace=existing_workspace,
     )
     planned_files = {workspace_dir / rel: content for rel, content in file_map.items()}
@@ -106,7 +102,6 @@ def setup_workspace(
     dry_run=False,
     with_chattool=False,
     chattool_source=None,
-    with_opencode_loop=False,
 ):
     profile_name, workspace_dir = coerce_profile_and_workspace(
         profile_name, workspace_dir
@@ -117,7 +112,6 @@ def setup_workspace(
     usage = (
         "Usage: chattool setup workspace [PROFILE] [WORKSPACE_DIR] "
         "[--language zh|en] [--with-chattool] [--chattool-source <path-or-url>] "
-        "[--with-opencode-loop] "
         "[--force] [--dry-run] [-i|-I]"
     )
     interactive, can_prompt, force_interactive, _, need_prompt = (
@@ -135,7 +129,6 @@ def setup_workspace(
             "source": chattool_source or workspace_options.CHATTOOL_REPO_URL,
         },
         "rexblog": {"enabled": False, "source": workspace_options.REXBLOG_REPO_URL},
-        "opencode_loop": {"enabled": bool(with_opencode_loop)},
     }
 
     if need_prompt:
@@ -158,9 +151,8 @@ def setup_workspace(
     enabled_options = [
         name for name, item in option_settings.items() if item["enabled"]
     ]
-    template_variant = "opencode-loop" if option_settings["opencode_loop"]["enabled"] else "default"
     dir_paths, file_map = _plan_workspace(
-        workspace_path, language, enabled_options, profile, template_variant=template_variant
+        workspace_path, language, enabled_options, profile
     )
 
     if dry_run:
@@ -177,9 +169,6 @@ def setup_workspace(
         write_text_file(path, content, force=force)
 
     applied = []
-    if option_settings["opencode_loop"]["enabled"]:
-        setup_opencode(interactive=False, install_only=True, plugin="chatloop")
-        applied.append(workspace_options.apply_opencode_loop_option(workspace_path))
     if option_settings["chattool"]["enabled"]:
         applied.append(
             workspace_options.apply_chattool_option(
@@ -220,8 +209,3 @@ def setup_workspace(
             click.echo(f"RexBlog repo: {item['repo_dir']}")
             click.echo(f"Repo action: {item['repo_action']}")
             click.echo(f"Public link: {item['public_link']}")
-        if item["name"] == "opencode_loop":
-            click.echo(f"OpenCode home: {item['opencode_home']}")
-            click.echo(f"ChatLoop plugin: {item['plugin_dir']}")
-            click.echo(f"ChatLoop commands: {item['commands_dir']}")
-            click.echo("ChatLoop state and event records are written under each project's .opencode/ directory when /chatloop runs.")

{chattool-7.0.0 → chattool-7.0.2}/src/chattool/setup/workspace/core.py

@@ -36,14 +36,11 @@ PROFILES: dict[str, WorkspaceProfile] = {
 
 
 BASE_DIRS = [
+    ".trash",
     "projects",
-    "reference",
-    "docs",
-    "docs/memory",
-    "docs/skills",
-    "docs/themes",
-    "docs/tools",
+    "archive",
     "core",
+    "scripts",
     "skills",
     "public",
 ]

{chattool-7.0.0 → chattool-7.0.2}/src/chattool/setup/workspace/options.py

@@ -13,10 +13,6 @@ from chattool.interaction import (
     ask_text,
     create_choice,
 )
-from chattool.setup.opencode_chatloop import (
-    build_chatloop_plugin_entry,
-    resolve_opencode_home,
-)
 from chattool.utils import mask_secret
 
 
@@ -86,18 +82,6 @@ def _copy_skill_tree(src: Path, dst: Path) -> list[str]:
         shutil.copytree(skill_dir, target_dir)
         copied.append(skill_dir.name)
     return copied
-def apply_opencode_loop_option(workspace_dir: Path) -> dict:
-    opencode_home = resolve_opencode_home()
-    plugin_dir = opencode_home / "plugins" / "chatloop"
-    commands_dir = opencode_home / "command"
-    return {
-        "name": "opencode_loop",
-        "workspace_dir": workspace_dir,
-        "opencode_home": opencode_home,
-        "plugin_dir": plugin_dir,
-        "commands_dir": commands_dir,
-        "plugin_entry": build_chatloop_plugin_entry(opencode_home),
-    }
 
 
 def _credential_path_from_source(repo_source: str) -> str | None:
@@ -246,7 +230,6 @@ def prompt_optional_modules(language: str) -> dict[str, dict]:
             "source": REXBLOG_REPO_URL,
             "github_token": None,
         },
-        "opencode_loop": {"enabled": False},
     }
 
     enable_extras = ask_confirm(
@@ -267,10 +250,6 @@ def prompt_optional_modules(language: str) -> dict[str, dict]:
         choices=[
             create_choice("ChatTool -> core/ChatTool + ./skills", "chattool"),
             create_choice("RexBlog -> core/RexBlog + public/hexo_blog", "rexblog"),
-            create_choice(
-                "OpenCode loop support -> .opencode chatloop plugin + commands",
-                "opencode_loop",
-            ),
         ],
         default_values=[],
         instruction="",

chattool-7.0.2/src/chattool/setup/workspace/render.py

@@ -0,0 +1,155 @@
+from __future__ import annotations
+
+from importlib import resources
+from pathlib import Path
+
+from .core import WorkspaceProfile
+
+
+def _read_template(language: str, relative_path: str) -> str:
+    return (
+        resources.files("chattool.setup.workspace")
+        .joinpath("templates")
+        .joinpath("default")
+        .joinpath(language)
+        .joinpath(relative_path)
+        .read_text(encoding="utf-8")
+    )
+
+
+def _render_text_template(language: str, relative_path: str, **variables: str) -> str:
+    content = _read_template(language, relative_path)
+    for key, value in variables.items():
+        content = content.replace(f"{{{{{key}}}}}", value)
+    return content
+
+
+def render_projects_readme(language: str) -> str:
+    return _read_template(language, "projects/README.md")
+
+
+def render_archive_readme(language: str) -> str:
+    if language == "en":
+        return (
+            "# Archive README\n\n"
+            "`archive/` stores inactive projects by archive date.\n\n"
+            "## Structure\n\n"
+            "```text\narchive/\n  README.md\n  YYYY-MM-DD/\n    <project-name>/\n```\n\n"
+            "Move inactive projects into `archive/YYYY-MM-DD/` and summarize them in the workspace root `ARCHIVE.md`.\n"
+        )
+    return (
+        "# Archive README\n\n"
+        "`archive/` 是 Playground 的历史日志区，按归档日期保存已不活跃的 project。\n\n"
+        "## 目录结构\n\n"
+        "```text\narchive/\n  README.md\n  YYYY-MM-DD/\n    <project-name>/\n```\n\n"
+        "每次归档时，把 project 移到 `archive/YYYY-MM-DD/`，并在 workspace 根目录 `ARCHIVE.md` 中补归档摘要。\n"
+    )
+
+
+def render_archive_md(language: str) -> str:
+    if language == "en":
+        return "# Archive\n\nRecord archived project summaries in reverse chronological order.\n"
+    return (
+        "# Archive\n\n"
+        "按日期倒序记录归档项目摘要。每个项目都说明“这是做什么的”和“本轮做了什么”。更具体的维护规则见 `archive/README.md`。\n"
+    )
+
+
+def render_todo_md(language: str) -> str:
+    if language == "en":
+        return "# TODO\n\nNear-term plans for this workspace.\n"
+    return "# TODO\n\n这里记录这个 workspace 近期打算做的事。\n"
+
+
+def render_scripts_readme(language: str) -> str:
+    if language == "en":
+        return (
+            "# Scripts\n\n"
+            "Workspace-level maintenance scripts live here. Keep task-specific scripts inside the relevant project.\n"
+        )
+    return (
+        "# Scripts\n\n"
+        "这里放 workspace 级维护脚本。\n\n"
+        "约定：\n"
+        "- 只放跨 project 复用的维护脚本\n"
+        "- 不要在 workspace 顶层散放脚本或临时文件\n"
+        "- 业务任务相关脚本，优先放在对应 project 内部\n"
+    )
+
+
+def render_workspace_maintenance_skill() -> tuple[str, str]:
+    skill_md = (
+        "---\n"
+        "name: workspace-maintenance\n"
+        "description: Maintain the outer workspace structure. Use for project cleanup, archive review, root protocol alignment, and moving files into the proper workspace-level locations.\n"
+        "version: 0.2.2\n"
+        "---\n\n"
+        "# Workspace Maintenance\n\n"
+        "Use this skill when maintaining the outer workspace rather than editing a source repository.\n\n"
+        "- keep active work under `projects/` and archive inactive work into `archive/YYYY-MM-DD/`\n"
+        "- update `ARCHIVE.md` when projects are archived or restored\n"
+        "- keep workspace-level scripts under `scripts/`\n"
+        "- prefer moving files into the nearest `.trash/` instead of deleting them directly\n"
+        "- keep root protocol files (`AGENTS.md`, `ARCHIVE.md`, `TODO.md`) aligned with the real workspace structure\n"
+    )
+    skill_zh = (
+        "---\n"
+        "name: workspace-maintenance\n"
+        "description: 维护 workspace 外层协作结构。适用于整理活跃项目、归档旧项目、对齐根协议文件，以及把文件移动到正确的 workspace 级目录。\n"
+        "version: 0.2.2\n"
+        "---\n\n"
+        "# Workspace Maintenance（中文）\n\n"
+        "用于维护 workspace 外层结构，而不是直接修改源码仓库。\n\n"
+        "- 活跃工作保留在 `projects/`，不活跃项目归档到 `archive/YYYY-MM-DD/`\n"
+        "- 发生归档或恢复时同步更新 `ARCHIVE.md`\n"
+        "- workspace 级维护脚本统一放到 `scripts/`\n"
+        "- 删除前优先移动到就近的 `.trash/`，不要直接删除\n"
+        "- 保持根协议文件（`AGENTS.md`、`ARCHIVE.md`、`TODO.md`）与真实结构一致\n"
+    )
+    return skill_md, skill_zh
+
+
+def render_public_readme(language: str) -> str:
+    if language == "en":
+        return "# Public\n\nThis directory is used for deploying public-facing websites and related publish artifacts.\n"
+    return "# Public\n\n这个目录用于部署公开网站及相关发布产物。\n"
+
+
+def render_agents_md(
+    workspace_dir: Path,
+    profile: WorkspaceProfile,
+    language: str,
+    enabled_options: list[str],
+) -> str:
+    options_text = ", ".join(enabled_options) if enabled_options else "none"
+    return _render_text_template(language, "AGENTS.md", ENABLED_OPTIONS=options_text)
+
+
+def base_file_map(
+    workspace_dir: Path,
+    profile: WorkspaceProfile,
+    language: str,
+    enabled_options: list[str],
+    *,
+    existing_workspace: bool,
+    helper_agents_path: str | None = None,
+    helper_identity_path: str | None = None,
+) -> dict[str, str]:
+    file_map = {
+        "TODO.md": render_todo_md(language),
+        "ARCHIVE.md": render_archive_md(language),
+        "projects/README.md": render_projects_readme(language),
+        "archive/README.md": render_archive_readme(language),
+        "scripts/README.md": render_scripts_readme(language),
+        "public/README.md": render_public_readme(language),
+    }
+    skill_md, skill_zh = render_workspace_maintenance_skill()
+    file_map["skills/workspace-maintenance/SKILL.md"] = skill_md
+    file_map["skills/workspace-maintenance/SKILL.zh.md"] = skill_zh
+    agents_content = render_agents_md(workspace_dir, profile, language, enabled_options)
+    if helper_agents_path:
+        file_map[helper_agents_path] = agents_content
+    else:
+        file_map["AGENTS.md"] = agents_content
+    file_map.update(profile.extra_files(workspace_dir))
+    return file_map

chattool-7.0.2/src/chattool/setup/workspace/templates/default/en/AGENTS.md

@@ -0,0 +1,78 @@
+# Workspace Agents
+
+`AGENTS.md` is the entry guide when a model enters this workspace.
+
+## Core Principles
+
+- Keep only a small set of control files at workspace root; actual execution should happen inside the target project directory.
+- Keep all active work under `projects/`; archive inactive projects into `archive/YYYY-MM-DD/`.
+- Project structure should stay minimal by default, while naming still allows more flexible grouping.
+- `PRD.md` records stable requirements, scope, constraints, and completion criteria; progress details belong in `progress.md`.
+- `progress.md` is the continuity log for each task. Update it after each substantive action.
+- Archiving should not be decided by scripts alone. Scripts can collect candidates and validate rules, but the final archive summary should be reviewed and written into `ARCHIVE.md` by the model.
+- If requirements are unclear, ask follow-up questions before execution.
+
+See `projects/README.md` for concrete project structures and naming rules.
+
+## Architecture
+
+```text
+Workspace/
+  AGENTS.md
+  TODO.md
+  ARCHIVE.md
+  .trash/
+  projects/
+  archive/
+    YYYY-MM-DD/
+  core/
+  scripts/
+  skills/
+  public/
+```
+
+This workspace is an outer collaboration scaffold around source repositories.
+
+## Current Options
+
+- Enabled options: `archive/`, `ARCHIVE.md`
+- Source repositories go under `core/`
+- Workspace maintenance scripts go under `scripts/`
+- The workspace root keeps a `.trash/` directory; prefer moving files there before deleting them directly
+- Imported shared skills go under `skills/`
+- Public publish output goes under `public/`
+- Archived projects go under `archive/YYYY-MM-DD/`
+
+## Workflow
+
+1. Read root `AGENTS.md`, then enter the target project.
+2. Identify the repo to change under `core/` and the target project under `projects/`.
+3. Create or refine `PRD.md` before execution.
+4. Update the current project's `progress.md` after each substantive action.
+5. Keep drafts, experiments, and local references inside the current project and place them into the matching subdirectories.
+6. Do not write debug temp files into `/tmp`; use the current project's `playground/`.
+7. Keep the project root minimal: control files at the root, reports under `reports/`, scripts under `scripts/`.
+8. If you use `projects/<topic>/<name>/`, keep `projects/<topic>/` as an index layer with only `README.md`, `.trash/`, and child project directories.
+9. Use `MM-DD-...` for new execution tasks by default; only clearly long-lived stable subprojects should omit the date prefix.
+10. Prefer `.trash/` at both workspace and project level; move files there before irreversible deletion.
+11. If a project needs a shorter repo path, create an on-demand symlink to `core/<repo-name>` instead of copying the repository.
+12. Finish with a report; if archiving happens, update `ARCHIVE.md`.
+13. Follow an archive flow of “script candidate collection + model review + `ARCHIVE.md` update”.
+
+## Write Rules
+
+| Situation | Write To |
+|-----------|----------|
+| Any active work unit | `projects/<name>/` or `projects/<topic>/<name>/` |
+| Short-term project | Prefer `MM-DD-<project-name>` |
+| Long-lived project | Use a stable name without a date prefix |
+| Inactive old project | `archive/YYYY-MM-DD/<project-name>/` |
+| Archive summary | `ARCHIVE.md` |
+| Repositories to change | `core/<repo-name>/` |
+| Workspace maintenance scripts | `scripts/<name>.py` |
+
+## Conventions
+
+- Stay within the current task boundary unless the task is explicitly expanded.
+- State uncertainty explicitly instead of silently assuming.
+- Do not scatter standalone scripts or temp files at the workspace root; place durable scripts under `scripts/`.

chattool-7.0.2/src/chattool/setup/workspace/templates/default/en/projects/README.md

@@ -0,0 +1,113 @@
+# Projects
+
+This directory contains all active work. Each project should be self-contained enough that execution can happen mostly inside that project directory.
+
+## When to create a new project
+
+Create a new project when the work has its own goal, context, and deliverables. Examples:
+
+- a research task
+- a one-off implementation
+- a bugfix stream
+- a larger initiative that may later split into multiple tasks
+
+## Naming and Grouping
+
+Use a date prefix for short-term projects by default:
+
+```text
+MM-DD-<project-name>
+```
+
+The structure may also group work by topic:
+
+```text
+projects/<topic>/<name>/
+```
+
+Examples:
+
+```text
+projects/agent-collab/05-25-feishu-links/
+projects/chatrss/05-25-auth-debug/
+```
+
+Recommended rules:
+- short-term one-off work: prefer `MM-DD-<project-name>`
+- recurring work in one theme: group under `projects/<topic>/<name>/`
+- long-lived projects: use a stable name without a date prefix
+
+## Topic Directory Rules
+
+When multiple tasks live under the same theme, prefer:
+
+```text
+projects/<topic>/<name>/
+```
+
+Guidelines:
+- `topic/` is an index layer for an ongoing theme or domain, such as `agent-collab/`, `chatrss/`, or `feishu/`
+- keep `topic/` minimal; usually only `README.md`, `.trash/`, and child project directories belong there
+- `<name>/` is the actual execution unit
+- new tasks under a topic should still use a date prefix by default
+- only clearly long-lived subprojects should use a stable name
+
+Avoid:
+- grouping when a single flat `projects/MM-DD-<project-name>/` directory is enough
+- deep topic nesting; usually `projects/<topic>/<name>/` is enough
+- using the topic directory itself as an execution unit
+- placing `reports/`, `playground/`, `reference/`, or task directories without a date prefix directly under `projects/<topic>/`
+
+## Default Project Shape
+
+Start minimal and grow only when the task needs it:
+
+```text
+<project-root>/
+  PRD.md
+  progress.md
+  memory.md
+  .trash/
+  reports/
+  scripts/
+  playground/
+  reference/
+```
+
+Notes:
+- `PRD.md`, `progress.md`, and `memory.md` are the control files kept at project root
+- `.trash/` is the project-local soft-delete buffer; prefer moving files there before deleting them
+- other artifacts should go into the matching subdirectories instead of cluttering project root
+- `reports/`, `scripts/`, and similar directories are created on demand
+
+## File Roles
+
+- `PRD.md`: requirements, scope, constraints, expected deliverables, completion criteria
+- `progress.md`: current status, key decisions, next steps; update it after each substantive action
+- `memory.md`: local context, important files, working notes
+- `reports/`: reports, summaries, staged outputs; use task-specific filenames instead of a generic `report.md`
+- `scripts/`: project-local scripts; use purpose-driven names instead of `temp.py` or `run.sh`
+- `playground/`: drafts, experiments, intermediate outputs, and debug temp files; do not write these into `/tmp`
+- `reference/`: project-local references and examples
+- `.trash/`: project-local soft-delete buffer; move files here before permanent deletion
+
+Notes:
+- `PRD.md` is the primary entry file
+- `progress.md` is the continuity log for the task and should stay current
+- `memory.md` adds local supporting context
+- keep project root minimal instead of scattering reports, scripts, temp output, and miscellaneous files there
+- prefer moving files into workspace or project `.trash/` instead of deleting them directly
+
+## Archiving
+
+- `projects/` keeps active or recently active work
+- move clearly inactive projects into `../archive/YYYY-MM-DD/`
+- write archive summaries into workspace root `../ARCHIVE.md`
+- archive by moving directories, not by deleting content
+- use “script candidate collection + model review” instead of blind script-only archiving
+
+## Repository Access
+
+- real source repositories stay under `core/`
+- if a project needs a shorter path, create an on-demand symlink inside the project, for example `ln -s /path/to/ChatTool ./ChatTool`
+- this symlink is optional and should not be generated by default

chattool-7.0.2/src/chattool/setup/workspace/templates/default/zh/AGENTS.md

@@ -0,0 +1,78 @@
+# Workspace Agents
+
+`AGENTS.md` 是模型进入这个 workspace 后的入口说明。
+
+## 核心原则
+
+- 外层根目录只保留少量总控文件；真正执行任务时，应进入对应 project 目录埋头推进。
+- 所有实际工作统一放到 `projects/` 下；过时项目归档到 `archive/YYYY-MM-DD/`。
+- project 目录结构默认保持最小化，但命名规则允许更灵活的分组方式。
+- `PRD.md` 只记录稳定需求、范围、约束和完成标准；进展细节写入 `progress.md`。
+- `progress.md` 是任务连续性的主日志。每次完成实质动作后，都应及时更新。
+- 归档不应仅靠纯脚本决定。脚本适合做候选收集和规则检查，最终归档摘要应由模型审查候选内容后写入 `ARCHIVE.md`。
+- 需求不清晰时，先补问题，再执行。
+
+具体的 project 目录结构与命名规则，统一看 `projects/README.md`。
+
+## 架构
+
+```text
+Workspace/
+  AGENTS.md
+  TODO.md
+  ARCHIVE.md
+  .trash/
+  projects/
+  archive/
+    YYYY-MM-DD/
+  core/
+  scripts/
+  skills/
+  public/
+```
+
+这个 workspace 是包裹源码仓库的一层协作脚手架，协作痕迹尽量留在外层。
+
+## 当前配置项
+
+- 已启用项：`archive/`、`ARCHIVE.md`
+- 需要修改的源码仓库放到 `core/`
+- 维护脚本统一放到 `scripts/`
+- workspace 根目录维护一个 `.trash/`，需要删除或清理文件时，默认优先移动到 `.trash/`
+- 导入的共享 skills 放到 `skills/`
+- 对外发布产物放到 `public/`
+- 归档项目放到 `archive/YYYY-MM-DD/`
+
+## 工作流
+
+1. 先读当前根目录 `AGENTS.md`，再进入目标 project。
+2. 识别当前要改的仓库到 `core/`，并进入目标 project。
+3. 先补齐 `PRD.md`，再开始执行。
+4. 每次完成实质动作后，及时更新当前 project 的 `progress.md`。
+5. 草稿、实验和局部参考都放在当前 project 内部，并优先进入匹配职责的子目录。
+6. 项目调试临时文件不要写到 `/tmp`；默认写到当前 project 的 `playground/`。
+7. project 根目录默认只保留 `PRD.md`、`progress.md`、`memory.md` 等控制文件；报告放 `reports/`，脚本放 `scripts/`。
+8. 若使用 `projects/<topic>/<name>/` 主题分组结构，则 `projects/<topic>/` 根目录只作为索引层，默认只保留 `README.md`、`.trash/` 与子项目目录。
+9. 新建执行任务默认使用 `MM-DD-...` 日期前缀；只有明确的长期稳定子项目才可不带日期前缀。
+10. workspace 和 project 级别都应优先准备 `.trash/`；需要删除文件时，默认先移动到就近的 `.trash/`，而不是直接 `rm`。
+11. 如需从 project 根目录直接访问源码仓库，可按需手动创建到 `core/<repo-name>` 的符号链接，但不要复制仓库。
+12. 收尾时完成汇报；如有归档动作，同步更新 `ARCHIVE.md`。
+13. 归档流程采用“脚本收集候选 + 模型审查 + 更新 `ARCHIVE.md`”的方式。
+
+## 写入规则
+
+| 情况 | 写入位置 |
+|-----------|----------|
+| 任意实际工作单元 | `projects/<name>/` 或 `projects/<topic>/<name>/` |
+| 短期 project | 推荐 `MM-DD-<project-name>` |
+| 长期 project | 可直接使用稳定名称，不加日期前缀 |
+| 已不活跃的旧 project | `archive/YYYY-MM-DD/<project-name>/` |
+| 归档摘要 | `ARCHIVE.md` |
+| 需要修改的源码仓库 | `core/<repo-name>/` |
+| workspace 维护脚本 | `scripts/<name>.py` |
+
+## 约定
+
+- 不要超出当前任务边界；如需扩展，先说明或单独开任务。
+- 不确定时要显式说明，不要默默假设。
+- 避免在 workspace 顶层新增零散脚本或临时文件；需要保留的脚本统一放入 `scripts/`。