---
id: 01HW5T3M7Z9A2B3C4D5E6F7G8H
title: 开发知识库商品落地页
project: knowledge-shop
owner: laohuang
priority: P1
state: todo
created_at: 2026-04-26T10:00:00Z
---
 
## Goal
 
完成一个可上线的 Next.js 落地页，包含：
- 商品介绍区
- 价格展示
- 购买引导
 
## Context
 
- 项目路径：/home/projects/knowledge-shop
- 设计稿：docs/design/landing-v1.figma
- 技术栈：Next.js 15, Tailwind CSS, TypeScript

{
  "task_id": "01HW5T3M7Z9A2B3C4D5E6F7G8H",
  "locked_by": "orchestrator",
  "locked_at": "2026-04-26T13:35:00Z",
  "assigned_agent": "laohuang",
  "tmux_pane": "agent_laohuang",
  "signal_file": "signals/laohuang/current_task.json"
}

{
  "name": "laohuang",
  "role": "fullstack_engineer",
  "description": "资深全栈工程师，负责代码开发和系统架构",
  "capabilities": ["frontend", "backend", "devops"],
  "preferred_engine": "claude-code",
  "max_concurrent_tasks": 1,
  "workspace_root": "/home/laohuang/projects"
}

{
  "agent": "laohuang",
  "engine": "claude-code",
  "container": "tmux",
  "tmux_session": "hermes",
  "tmux_pane": "agent_laohuang",
  "status": "idle",
  "current_task_id": null,
  "current_task_signal": null,
  "last_heartbeat": "2026-04-26T13:30:00Z",
  "task_history": []
}

{
  "task_id": "01HW5T3M7Z9A2B3C4D5E6F7G8H",
  "task_file": "/path/to/tasks/doing/01HW5T3M7Z9A2B3C4D5E6F7G8H.md",
  "workspace_root": "/home/laohuang/projects",
  "project_path": "/home/laohuang/projects/knowledge-shop",
  "company_rules": "/path/to/company/AGENT_WORK_RULES.md",
  "memory_path": "/path/to/memory/laohuang",
  "logs_path": "/path/to/logs/laohuang",
  "outbox_path": "/path/to/outbox/laohuang/01HW5T3M7Z9A2B3C4D5E6F7G8H",
  "assigned_at": "2026-04-26T13:35:00Z"
}

{
  "agent": "laohuang",
  "task_id": "01HW5T3M7Z9A2B3C4D5E6F7G8H",
  "status": "working",
  "progress": "implementing hero section",
  "started_at": "2026-04-26T13:35:00Z",
  "updated_at": "2026-04-26T13:45:00Z"
}

def move_task(task_id: str, from_state: str, to_state: str) -> None:
    # 1. 验证当前状态
    # 2. 读取原始文件
    # 3. 更新 state 字段
    # 4. 写回目标目录
    # 5. 删除源文件
    # 6. 记录日志
    # 若任何步骤失败则 rollback

class Orchestrator:
    def run(self):
        while self.running:
            self.sync_agent_status()      # 读取所有 runtime.json
            self.process_blocked_tasks()   # 检查 blocked 任务是否可重试
            self.scan_and_assign()         # 扫描 todo，分配给 idle agent
            self.monitor_task_progress()   # 检测 DONE 信号 / 超时
            self.sleep(self.poll_interval)

def assign_task(agent: str, task_id: str) -> None:
    # 1. 写 signals/{agent}/current_task.json（包含完整上下文）
    # 2. 写 tasks/{task_id}.lock（锁定信息）
    # 3. 移动 tasks/todo/{task_id}.md → tasks/doing/{task_id}.md
    # 4. 更新 agents/{agent}/runtime.json（status=busy, current_task_id=xxx）
    # 5. 记录日志

def check_completion(agent: str, task_id: str) -> bool:
    done_file = f"outbox/{agent}/{task_id}/DONE"
    return Path(done_file).exists()

MAX_CONCURRENT_AGENTS = 3     # 最多同时分配任务给多少个 agent
MAX_TASK_RUNTIME = 1800        # 单任务超时（秒，30min）
MAX_RETRIES = 3                # blocked 后最大重试次数
POLL_INTERVAL = 10             # 扫描间隔（秒）

while true; do
  if [ -f signals/{agent}/current_task.json ]; then
    TASK=$(cat signals/{agent}/current_task.json)
    # 解析并执行任务
    claude -p runners/claude_runner.md \
      --extra-var "task_id=$(jq -r '.task_id' <<< $TASK)" \
      --extra-var "task_file=$(jq -r '.task_file' <<< $TASK)" \
      --extra-var "workspace=$(jq -r '.workspace_root' <<< $TASK)" \
      # ... 其他变量
    # 清理信号文件
    rm signals/{agent}/current_task.json
  fi
  sleep 5
done

def ensure_agent_pane(agent: str) -> None:
    pane = f"agent_{agent}"
    if not tmux.pane_exists("hermes", pane):
        tmux.new_window("hermes", pane)
        tmux.send_keys(f"cd {WORKSPACE}", pane=pane)
        tmux.send_keys(RUNNER_BOOT_SCRIPT.format(agent=agent), pane=pane)

# 任务交付总结
 
- 任务 ID：01HW5T3M7Z9A2B3C4D5E6F7G8H
- 执行 Agent：laohuang
- 开始时间：2026-04-26T13:35:00Z
- 结束时间：2026-04-26T14:20:00Z
- 结果状态：✅ 成功
 
## 产出清单
 
| 文件 | 说明 |
|------|------|
| pages/landing.tsx | 落地页主组件 |
| styles/landing.css | 样式文件 |
| package.json | 依赖更新 |
 
## 执行摘要
 
1. 阅读了项目文档和设计稿
2. 使用 Next.js App Router 创建落地页
3. 实现了响应式 Hero 区域
4. 集成了价格展示组件
 
## 遇到的问题（如有）
 
无

# Agent 工作规范
 
## 绝对禁止
 
1. 删除系统目录：/, /boot, /usr, /etc, /var, /home
2. 执行递归删除：rm -rf /
3. 修改系统配置：/etc/hosts, /etc/passwd, /etc/sudoers
4. 使用未授权的 sudo 命令
5. 修改 Hermes 核心文件：hermes.py, orchestrator.py, lib/
6. 修改其他 Agent 的 profile.json / runtime.json
7. 向未授权的网络地址发送数据
 
## 允许的操作
 
- 读写项目文件（workspace_root 内的项目目录）
- 执行 npm/bun/pip 等包管理命令
- 执行 git 命令（commit/push/pull，不强制）
- 创建和删除项目内文件
 
## 交付要求
 
- 每任务必须生成 summary.md
- 每任务必须创建 DONE 文件
- 必须记录执行日志

# 查看所有 pane 活动
tmux attach -t hermes
 
# 监控任务目录变化
watch -n 3 'tree tasks/ outbox/ signals/ -L 2'

hermes agent status laohuang
# → current_task: TASK-xxx, status: working, since: 13:35

# 工作日志 — laohuang — 2026-04-26
 
## 任务：01HW5T3M7Z — 开发知识库商品落地页
开始：13:35 | 结束：14:20 | 状态：✅
 
### 执行记录
 
| 时间 | 动作 | 详情 |
|------|------|------|
| 13:35 | 读取任务 | 分析 goal 和 context |
| 13:42 | 阅读代码 | 发现需要 Next.js 15 |
| 13:55 | 创建组件 | pages/landing.tsx |
| 14:10 | 测试验证 | npm run build 通过 |
| 14:18 | 写 summary | outbox/laohuang/01HW5T3M7Z/summary.md |
| 14:20 | 完成 | DONE 信号已写 |

# 初始化
hermes init                          # 创建目录结构 + 配置文件
hermes doctor                         # 检查依赖（tmux、claude CLI）
 
# 任务管理
hermes task create --title "..." --owner laohuang --project x --priority P1 --goal "..."
hermes task list [--state todo|doing|review|done]
hermes task show <task_id>
hermes task move <task_id> <target_state> [--reason "..."]
hermes task delete <task_id>
 
# Agent 管理
hermes agent register --name laohuang --role fullstack --engine claude-code
hermes agent list
hermes agent status <name>

agents:
  - name: laohuang
    role: fullstack_engineer
    engine: claude-code
    capabilities:
      - frontend
      - backend
      - devops
    workspace_root: /home/laohuang/projects
  - name: market01
    role: marketing_writer
    engine: claude-code
    capabilities:
      - copywriting
      - seo
      - social_media
    workspace_root: /home/laohuang/projects
  - name: content01
    role: content_creator
    engine: claude-code
    capabilities:
      - article
      - video_script
      - documentation
    workspace_root: /home/laohuang/projects

company:
  name: Hermes AI Company
  workspace_root: /home/laohuang/projects
  max_concurrent_agents: 3
  task_timeout_seconds: 1800
  poll_interval_seconds: 10
  max_retries: 3
 
paths:
  tasks: tasks
  agents: agents
  logs: logs
  outbox: outbox
  memory: memory
  signals: signals
  runners: runners
  company_rules: company/AGENT_WORK_RULES.md

import asyncio
from lib.task import TaskManager
from lib.agent import AgentManager
from lib.signals import SignalManager
from lib.tmux_ctrl import TmuxController
 
class Orchestrator:
    def __init__(self, config):
        self.tasks = TaskManager()
        self.agents = AgentManager()
        self.signals = SignalManager()
        self.tmux = TmuxController()
        self.poll_interval = config.poll_interval
        self.running = True
 
    async def run(self):
        # 确保所有 agent pane 存在
        for agent in self.agents.list():
            self.tmux.ensure_pane(agent)
 
        while self.running:
            await self.step()
            await asyncio.sleep(self.poll_interval)
 
    async def step(self):
        self.sync_agent_status()
        self.process_blocked()
        await self.scan_and_assign()
        self.detect_completions()
 
    async def scan_and_assign(self):
        idle_agents = [a for a in self.agents.list() if a.is_idle()]
        for agent in idle_agents:
            if self.agents.active_count() >= MAX_CONCURRENT:
                break
            task = self.tasks.pick_best_todo()
            if not task:
                break
            self.assign_task(agent, task)
 
    def assign_task(self, agent, task):
        # 原子操作：
        # 1. 写信号文件
        self.signals.write_task_signal(agent, task)
        # 2. 创建锁文件
        self.tasks.lock(task.id, agent)
        # 3. 移动任务文件
        self.tasks.move(task.id, "todo", "doing")
        # 4. 更新 agent 状态
        self.agents.assign(agent, task.id)
        log(f"Assigned {task.id} to {agent}")
 
    def detect_completions(self):
        for agent in self.agents.list_busy():
            task_id = agent.current_task_id
            if self.signals.check_done(agent, task_id):
                self.tasks.move(task_id, "doing", "review")
                self.agents.free(agent)
                log(f"Task {task_id} completed, moved to review")