principles-disciple 1.5.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/commands/capabilities.d.ts +3 -0
- package/dist/commands/capabilities.js +73 -0
- package/dist/commands/evolver.d.ts +9 -0
- package/dist/commands/evolver.js +26 -0
- package/dist/commands/pain.d.ts +5 -0
- package/dist/commands/pain.js +114 -0
- package/dist/commands/strategy.d.ts +3 -0
- package/dist/commands/strategy.js +29 -0
- package/dist/commands/thinking-os.d.ts +2 -0
- package/dist/commands/thinking-os.js +162 -0
- package/dist/commands/trust.d.ts +4 -0
- package/dist/commands/trust.js +95 -0
- package/dist/core/agent-loader.d.ts +44 -0
- package/dist/core/agent-loader.js +147 -0
- package/dist/core/config-service.d.ts +15 -0
- package/dist/core/config-service.js +26 -0
- package/dist/core/config.d.ts +103 -0
- package/dist/core/config.js +186 -0
- package/dist/core/detection-funnel.d.ts +33 -0
- package/dist/core/detection-funnel.js +100 -0
- package/dist/core/detection-service.d.ts +15 -0
- package/dist/core/detection-service.js +28 -0
- package/dist/core/dictionary-service.d.ts +15 -0
- package/dist/core/dictionary-service.js +26 -0
- package/dist/core/dictionary.d.ts +36 -0
- package/dist/core/dictionary.js +136 -0
- package/dist/core/event-log.d.ts +53 -0
- package/dist/core/event-log.js +196 -0
- package/dist/core/evolution-engine.d.ts +119 -0
- package/dist/core/evolution-engine.js +542 -0
- package/dist/core/evolution-types.d.ts +126 -0
- package/dist/core/evolution-types.js +56 -0
- package/dist/core/hygiene/tracker.d.ts +22 -0
- package/dist/core/hygiene/tracker.js +106 -0
- package/dist/core/init.d.ts +12 -0
- package/dist/core/init.js +117 -0
- package/dist/core/migration.d.ts +6 -0
- package/dist/core/migration.js +90 -0
- package/dist/core/pain.d.ts +4 -0
- package/dist/core/pain.js +70 -0
- package/dist/core/path-resolver.d.ts +43 -0
- package/dist/core/path-resolver.js +259 -0
- package/dist/core/paths.d.ts +60 -0
- package/dist/core/paths.js +67 -0
- package/dist/core/profile.d.ts +62 -0
- package/dist/core/profile.js +210 -0
- package/dist/core/risk-calculator.d.ts +7 -0
- package/dist/core/risk-calculator.js +39 -0
- package/dist/core/session-tracker.d.ts +76 -0
- package/dist/core/session-tracker.js +286 -0
- package/dist/core/system-logger.d.ts +8 -0
- package/dist/core/system-logger.js +31 -0
- package/dist/core/trust-engine.d.ts +91 -0
- package/dist/core/trust-engine.js +284 -0
- package/dist/core/workspace-context.d.ts +64 -0
- package/dist/core/workspace-context.js +134 -0
- package/dist/hooks/gate.d.ts +6 -0
- package/dist/hooks/gate.js +487 -0
- package/dist/hooks/lifecycle.d.ts +5 -0
- package/dist/hooks/lifecycle.js +180 -0
- package/dist/hooks/llm.d.ts +4 -0
- package/dist/hooks/llm.js +153 -0
- package/dist/hooks/pain.d.ts +5 -0
- package/dist/hooks/pain.js +173 -0
- package/dist/hooks/prompt.d.ts +38 -0
- package/dist/hooks/prompt.js +285 -0
- package/dist/hooks/subagent.d.ts +2 -0
- package/dist/hooks/subagent.js +70 -0
- package/dist/i18n/commands.d.ts +26 -0
- package/dist/i18n/commands.js +88 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.js +204 -0
- package/dist/service/evolution-worker.d.ts +17 -0
- package/dist/service/evolution-worker.js +293 -0
- package/dist/tools/agent-spawn.d.ts +33 -0
- package/dist/tools/agent-spawn.js +170 -0
- package/dist/tools/critique-prompt.d.ts +14 -0
- package/dist/tools/critique-prompt.js +81 -0
- package/dist/tools/deep-reflect.d.ts +19 -0
- package/dist/tools/deep-reflect.js +174 -0
- package/dist/tools/model-index.d.ts +9 -0
- package/dist/tools/model-index.js +82 -0
- package/dist/types/event-types.d.ts +229 -0
- package/dist/types/event-types.js +73 -0
- package/dist/types/hygiene-types.d.ts +20 -0
- package/dist/types/hygiene-types.js +12 -0
- package/dist/types.d.ts +1 -0
- package/dist/types.js +1 -0
- package/dist/utils/file-lock.d.ts +64 -0
- package/dist/utils/file-lock.js +270 -0
- package/dist/utils/glob-match.d.ts +28 -0
- package/dist/utils/glob-match.js +49 -0
- package/dist/utils/hashing.d.ts +9 -0
- package/dist/utils/hashing.js +25 -0
- package/dist/utils/io.d.ts +6 -0
- package/dist/utils/io.js +106 -0
- package/dist/utils/nlp.d.ts +9 -0
- package/dist/utils/nlp.js +59 -0
- package/dist/utils/plugin-logger.d.ts +39 -0
- package/dist/utils/plugin-logger.js +70 -0
- package/openclaw.plugin.json +46 -0
- package/package.json +63 -0
- package/templates/langs/en/core/AGENTS.md +206 -0
- package/templates/langs/en/core/BOOT.md +60 -0
- package/templates/langs/en/core/BOOTSTRAP.md +250 -0
- package/templates/langs/en/core/HEARTBEAT.md +74 -0
- package/templates/langs/en/core/IDENTITY.md +8 -0
- package/templates/langs/en/core/PRINCIPLES.md +10 -0
- package/templates/langs/en/core/SOUL.md +76 -0
- package/templates/langs/en/core/TOOLS.md +53 -0
- package/templates/langs/en/core/USER.md +10 -0
- package/templates/langs/en/pain/00_seed_samples.md +23 -0
- package/templates/langs/en/pain_dictionary.json +22 -0
- package/templates/langs/en/skills/admin/SKILL.md +40 -0
- package/templates/langs/en/skills/bootstrap-tools/SKILL.md +53 -0
- package/templates/langs/en/skills/deductive-audit/SKILL.md +36 -0
- package/templates/langs/en/skills/evolution-framework-update/SKILL.md +31 -0
- package/templates/langs/en/skills/evolve-system/SKILL.md +46 -0
- package/templates/langs/en/skills/evolve-task/SKILL.md +83 -0
- package/templates/langs/en/skills/feedback/SKILL.md +51 -0
- package/templates/langs/en/skills/init-strategy/SKILL.md +54 -0
- package/templates/langs/en/skills/inject-rule/SKILL.md +19 -0
- package/templates/langs/en/skills/manage-okr/SKILL.md +96 -0
- package/templates/langs/en/skills/pain/SKILL.md +19 -0
- package/templates/langs/en/skills/pd-daily/SKILL.md +199 -0
- package/templates/langs/en/skills/pd-grooming/SKILL.md +46 -0
- package/templates/langs/en/skills/pd-mentor/SKILL.md +230 -0
- package/templates/langs/en/skills/plan-script/SKILL.md +32 -0
- package/templates/langs/en/skills/profile/SKILL.md +24 -0
- package/templates/langs/en/skills/reflection/SKILL.md +40 -0
- package/templates/langs/en/skills/reflection-log/SKILL.md +37 -0
- package/templates/langs/en/skills/report/SKILL.md +13 -0
- package/templates/langs/en/skills/root-cause/SKILL.md +33 -0
- package/templates/langs/en/skills/triage/SKILL.md +29 -0
- package/templates/langs/en/skills/watch-evolution/SKILL.md +33 -0
- package/templates/langs/zh/core/AGENTS.md +207 -0
- package/templates/langs/zh/core/BOOT.md +60 -0
- package/templates/langs/zh/core/BOOTSTRAP.md +250 -0
- package/templates/langs/zh/core/HEARTBEAT.md +74 -0
- package/templates/langs/zh/core/IDENTITY.md +8 -0
- package/templates/langs/zh/core/SOUL.md +76 -0
- package/templates/langs/zh/core/TOOLS.md +53 -0
- package/templates/langs/zh/core/USER.md +10 -0
- package/templates/langs/zh/pain/00_seed_samples.md +24 -0
- package/templates/langs/zh/pain_dictionary.json +18 -0
- package/templates/langs/zh/skills/admin/SKILL.md +42 -0
- package/templates/langs/zh/skills/bootstrap-tools/SKILL.md +52 -0
- package/templates/langs/zh/skills/deductive-audit/SKILL.md +36 -0
- package/templates/langs/zh/skills/evolution-framework-update/SKILL.md +31 -0
- package/templates/langs/zh/skills/evolve-system/SKILL.md +46 -0
- package/templates/langs/zh/skills/evolve-task/SKILL.md +83 -0
- package/templates/langs/zh/skills/feedback/SKILL.md +53 -0
- package/templates/langs/zh/skills/init-strategy/SKILL.md +54 -0
- package/templates/langs/zh/skills/inject-rule/SKILL.md +19 -0
- package/templates/langs/zh/skills/manage-okr/SKILL.md +109 -0
- package/templates/langs/zh/skills/pain/SKILL.md +19 -0
- package/templates/langs/zh/skills/pd-daily/SKILL.md +199 -0
- package/templates/langs/zh/skills/pd-grooming/SKILL.md +46 -0
- package/templates/langs/zh/skills/pd-mentor/SKILL.md +230 -0
- package/templates/langs/zh/skills/plan-script/SKILL.md +32 -0
- package/templates/langs/zh/skills/profile/SKILL.md +24 -0
- package/templates/langs/zh/skills/reflection/SKILL.md +40 -0
- package/templates/langs/zh/skills/reflection-log/SKILL.md +37 -0
- package/templates/langs/zh/skills/report/SKILL.md +13 -0
- package/templates/langs/zh/skills/root-cause/SKILL.md +33 -0
- package/templates/langs/zh/skills/triage/SKILL.md +29 -0
- package/templates/langs/zh/skills/watch-evolution/SKILL.md +33 -0
- package/templates/pain_dictionary.json +36 -0
- package/templates/pain_settings.json +77 -0
- package/templates/workspace/.principles/00-kernel.md +51 -0
- package/templates/workspace/.principles/DECISION_POLICY.json +44 -0
- package/templates/workspace/.principles/PRINCIPLES.md +20 -0
- package/templates/workspace/.principles/PROFILE.json +52 -0
- package/templates/workspace/.principles/PROFILE.schema.json +56 -0
- package/templates/workspace/.principles/THINKING_OS.md +64 -0
- package/templates/workspace/.principles/THINKING_OS_ARCHIVE.md +7 -0
- package/templates/workspace/.principles/THINKING_OS_CANDIDATES.md +9 -0
- package/templates/workspace/.principles/models/_INDEX.md +27 -0
- package/templates/workspace/.principles/models/first_principles.md +62 -0
- package/templates/workspace/.principles/models/marketing_4p.md +52 -0
- package/templates/workspace/.principles/models/porter_five.md +63 -0
- package/templates/workspace/.principles/models/swot.md +60 -0
- package/templates/workspace/.principles/models/user_story_map.md +63 -0
- package/templates/workspace/.state/WORKBOARD.json +4 -0
- package/templates/workspace/AUDIT.md +15 -0
- package/templates/workspace/PLAN.md +2 -0
- package/templates/workspace/okr/RECOVERY_PROTOCOL.md +56 -0
- package/templates/workspace/okr/TASK_CHANGES.jsonl +6 -0
- package/templates/workspace/okr/WEEK_TASKS.json +6 -0
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: evolve-system
|
|
3
|
+
description: Second-order observation and system-level evolution. Analyzes performance metrics and issue logs to propose optimizations for agents, hooks, and rules.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# /evolve-system: 数字架构师 (二阶观察)
|
|
8
|
+
|
|
9
|
+
你现在的身份是本系统的 **数字化架构师 (The Architect)**。你的职责不是修复业务代码,而是通过分析系统运行数据,优化系统自身的“基因”(Prompt、Hook、规则)。
|
|
10
|
+
|
|
11
|
+
## 1. 现状度量 (Metrics Analysis)
|
|
12
|
+
- **读取数据**:
|
|
13
|
+
- `.state/AGENT_SCORECARD.json`: 计算每个 Agent 的胜率 (wins / (wins + losses))。
|
|
14
|
+
- `memory/ISSUE_LOG.md`: 识别最近 10 条记录中的重复模式(Pain Patterns)。
|
|
15
|
+
- **识别异常**:
|
|
16
|
+
- **低效 Agent**: 胜率低于 50% 且样本量 >= 3 的 Agent。
|
|
17
|
+
- **系统顽疾**: 在 Issue Log 中出现超过 2 次的同类系统性错误。
|
|
18
|
+
|
|
19
|
+
## 2. 根因诊断 (Systemic Diagnosis)
|
|
20
|
+
- 针对识别出的异常,分析其在 `.claude/agents/` 或 `.claude/hooks/` 中的定义。
|
|
21
|
+
- **思考**:
|
|
22
|
+
- 是 Prompt 描述太模糊导致幻觉?
|
|
23
|
+
- 是 Hook 逻辑存在边界死角?
|
|
24
|
+
- 是缺失了某个关键的 Guardrail?
|
|
25
|
+
|
|
26
|
+
## 2.5 临床实验 (Clinical Trial) - *Optional*
|
|
27
|
+
**如果根因不明确**,需进行实证:
|
|
28
|
+
- **征询**: 使用 `AskUserQuestion` 询问:“为确诊问题,我需要对 [Agent] 进行一次自动诊断任务,这可能会消耗一些 Token,是否继续?”
|
|
29
|
+
- **静默执行**:
|
|
30
|
+
- 若用户同意,直接调用 ``pd_spawn_agent` 工具` 发起测试。
|
|
31
|
+
- **指令**: "你正在被进行诊断测试。请执行以下任务:[Test Scenario]。请保持输出极其精简,只返回最终结果或错误信息。"
|
|
32
|
+
- **观察**: 检查其工具调用链是否符合预期(例如:是否使用了正确的 Search 工具)。
|
|
33
|
+
- **确诊**: 基于测试表现,锁定病灶。
|
|
34
|
+
|
|
35
|
+
## 3. 进化提案 (Optimization Proposal)
|
|
36
|
+
**如果根因已确诊**,生成 `SYSTEM_OPTIMIZATION_PLAN.md`,内容包括:
|
|
37
|
+
- **诊断结论**: 明确指出系统哪一部分“病了”。
|
|
38
|
+
- **修改建议**: 提供具体的代码/Prompt 修改 Diff。
|
|
39
|
+
- **预期收益**: 解释这次修改如何提升胜率或减少痛苦。
|
|
40
|
+
|
|
41
|
+
## 4. 安全执行 (Safety Gate)
|
|
42
|
+
- **强制确认**: 在修改任何系统文件 (`.claude/` 目录下) 之前,必须使用 `AskUserQuestion` 展示提案并获得用户明确授权。
|
|
43
|
+
- **原子性**: 每次只建议一个高杠杆的优化点,不要试图一次性重构整个系统。
|
|
44
|
+
|
|
45
|
+
## 结项
|
|
46
|
+
输出:“✅ 系统自诊完成。提案已提交,等待老板决策。”
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: evolve-task
|
|
3
|
+
description: Run the full evolution loop (triage → diagnosis → audit → plan → execute → review → log)
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
你必须按顺序执行以下步骤(不得跳步)。ARGUMENTS: $ARGUMENTS
|
|
8
|
+
|
|
9
|
+
## Step 0: 恢复上下文(强制)
|
|
10
|
+
- 读取 memory/CHECKPOINT.md 的最后一条
|
|
11
|
+
- 读取 memory/ISSUE_LOG.md 的最近 3 条
|
|
12
|
+
- 读取 memory/DECISIONS.md 的最近决策
|
|
13
|
+
- 如果存在 .state/.pain_flag,先处理断点恢复
|
|
14
|
+
|
|
15
|
+
## Step 1: 读取运行参数与能力自检
|
|
16
|
+
- 读取 .principles/PROFILE.json,理解 risk_paths、gate、tests.commands。
|
|
17
|
+
- **能力自检**: 快速扫描插件目录下的 `skills/` 和 `agents/`。如果有针对当前任务的专门 Skill (如 `/deep-search`) 或 Agent (如 `security-expert`),请在后续步骤中优先使用。
|
|
18
|
+
|
|
19
|
+
## Step 1.5: 全维环境感知 (Full-Spectrum Awareness)
|
|
20
|
+
- **本地**: 运行 `git status` 和 `git log -n 5` 了解代码现状。
|
|
21
|
+
- **远程**: 如果可用 `gh`,必须运行 `gh issue list --limit 5` 和 `gh pr list --limit 5`。
|
|
22
|
+
- **关联**: 如果发现相关 Issue,必须将其 ID 记录在本次任务的上下文中。
|
|
23
|
+
|
|
24
|
+
## Step 2: TRIAGE(补齐信息)
|
|
25
|
+
- **地图优先**: 必须先阅读 `codemaps/` 下的架构图或 `docs/SYSTEM_PANORAMA.md`,准确评估修改风险。
|
|
26
|
+
输出:
|
|
27
|
+
- Goal(一句话)
|
|
28
|
+
- Problem(可复现描述)
|
|
29
|
+
- Evidence(文件/命令/日志)
|
|
30
|
+
- Risk level(low/medium/high)
|
|
31
|
+
|
|
32
|
+
## Step 3: 委派 Explorer(证据收集)
|
|
33
|
+
- 让 Explorer 子智能体输出:Evidence list / Repro / Hypotheses(<=3)
|
|
34
|
+
- **绩效评估**: 任务完成后,评估 Explorer 表现并写入 `.state/.verdict.json`。格式必须严格遵守 `@.principles/schemas/agent_verdict_schema.json`。
|
|
35
|
+
|
|
36
|
+
## Step 4: 委派 Diagnostician(根因)
|
|
37
|
+
- 让 Diagnostician 输出:Proximal cause / Root cause / 5 Whys / Category
|
|
38
|
+
- **绩效评估**: 任务完成后,写入 `.state/.verdict.json`。格式遵循 `@.principles/schemas/agent_verdict_schema.json`。
|
|
39
|
+
|
|
40
|
+
## Step 5: 委派 Auditor(演绎审计)
|
|
41
|
+
- 让 Auditor 输出:Axiom/System/Via negativa / RESULT: PASS/FAIL
|
|
42
|
+
- 将审计结果写入 AUDIT.md(RESULT 行必须存在)。
|
|
43
|
+
- **绩效评估**: 任务完成后,写入 `.state/.verdict.json`。格式遵循 `@.principles/schemas/agent_verdict_schema.json`。
|
|
44
|
+
|
|
45
|
+
### 分支处理(必须遵守)
|
|
46
|
+
- 若 RESULT = FAIL:
|
|
47
|
+
1. 将 Must-fix 列表写入 AUDIT.md
|
|
48
|
+
2. 回到 Step 4 重新委派 Diagnostician,要求补充根因
|
|
49
|
+
3. 最多重试 2 次,若仍 FAIL 则写入 memory/DECISIONS.md并请求用户介入
|
|
50
|
+
- 若 RESULT = PASS:继续 Step 6
|
|
51
|
+
|
|
52
|
+
## Step 6: 委派 Planner(电影剧本计划)
|
|
53
|
+
- Planner 输出 Plan(步骤/命令/指标/回滚)。
|
|
54
|
+
- 将计划写入 PLAN.md(STATUS 行必须存在)。
|
|
55
|
+
- **任务同步 (Task Sync)**:
|
|
56
|
+
- 如果 `CLAUDE_CODE_TASK_LIST_ID` 已设置,你必须将上述 Plan 的核心步骤直接转化为 Native Tasks(通过自然语言指令"Add task..."或相关工具)。
|
|
57
|
+
- 如果未设置且为交互模式,提示用户:"建议运行 `export CLAUDE_CODE_TASK_LIST_ID=task-$(date +%s)` 以启用持久化任务追踪。"
|
|
58
|
+
- 如果是后台/无头模式,跳过提示。
|
|
59
|
+
- **绩效评估**: 任务完成后,写入 `.state/.verdict.json`。格式遵循 `@.principles/schemas/agent_verdict_schema.json`。
|
|
60
|
+
|
|
61
|
+
## Step 7: 委派 Implementer(执行)
|
|
62
|
+
- Implementer 只能按 PLAN 执行。任何偏离必须先更新 PLAN。
|
|
63
|
+
- **绩效评估**: 任务完成后,根据验证结果写入 `.state/.verdict.json`。格式遵循 `@.principles/schemas/agent_verdict_schema.json`。
|
|
64
|
+
|
|
65
|
+
## Step 8: 委派 Reviewer(审查)
|
|
66
|
+
- Reviewer 输出:Critical/Warning/Suggestion。
|
|
67
|
+
- **绩效评估**: 任务完成后,写入 `.state/.verdict.json`。格式遵循 `@.principles/schemas/agent_verdict_schema.json`。
|
|
68
|
+
|
|
69
|
+
### 分支处理
|
|
70
|
+
- 若有 Critical:回到 Step 6 修订计划,最多重试 2 次
|
|
71
|
+
- 若无 Critical:继续 Step 9
|
|
72
|
+
|
|
73
|
+
## Step 9: 反思与落盘
|
|
74
|
+
1. **系统进化**: 将 Pain/Root cause/新原则候选/门禁建议追加到 memory/ISSUE_LOG.md,并更新 memory/DECISIONS.md。
|
|
75
|
+
2. **用户画像更新 (强制)**:
|
|
76
|
+
- 回顾用户在本任务中的表现(指令质量、领域知识、偏好)以及系统的高光时刻。
|
|
77
|
+
- **必须**写入 `.state/.user_verdict.json` (增量更新)。格式必须严格遵守 `@.principles/schemas/user_verdict_schema.json`。
|
|
78
|
+
- 注意:如果用户没有表现出明显特征或偏好,对应字段可为空。
|
|
79
|
+
|
|
80
|
+
## Step 10: 最终汇报 (Final Briefing)
|
|
81
|
+
- **动作**: 委派 ``pd_spawn_agent(reporter)`` 进行结项陈述。
|
|
82
|
+
- **要求**: 将 Implementer 和 Reviewer 的最终产出作为输入传给它。让它根据 `USER_CONTEXT.md` 决定汇报的深度和风格。
|
|
83
|
+
- **目标**: 确保老板(用户)在不产生认知负荷的前提下,清楚了解任务成果与潜在风险。
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: feedback
|
|
3
|
+
description: Standardized bug reporting and feedback mechanism. Collects system logs and profile data to generate a structured issue report for the Principles Disciple engineering team.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# /feedback: 提交系统反馈
|
|
8
|
+
|
|
9
|
+
你遇到了系统 Bug 或设计缺陷?请使用此技能生成一份标准化的反馈报告,并自动投递给上游开发团队。
|
|
10
|
+
|
|
11
|
+
## 执行流程
|
|
12
|
+
|
|
13
|
+
### 1. 收集证据 (Evidence Collection)
|
|
14
|
+
- **Log Analysis**: 读取 `memory/ISSUE_LOG.md` (最近 20 行) 和 `memory/logs/SYSTEM.log` (如果有报错堆栈)。
|
|
15
|
+
- **Config Check**: 读取 `.principles/PROFILE.json` 确认当前配置。
|
|
16
|
+
- **Version Check**: 尝试获取当前版本信息(如有)。
|
|
17
|
+
|
|
18
|
+
### 2. 生成报告 (Report Generation)
|
|
19
|
+
在 `temp/` 目录下生成 `feedback-YYYYMMDD-HHMMSS.md`。
|
|
20
|
+
**内容模板**:
|
|
21
|
+
```markdown
|
|
22
|
+
# Bug Report / Feature Request
|
|
23
|
+
|
|
24
|
+
**Severity**: HIGH | MEDIUM | LOW
|
|
25
|
+
**Component**: Agent | Hook | Skill | Installer
|
|
26
|
+
**Context**: [简述你在做什么时遇到的问题]
|
|
27
|
+
|
|
28
|
+
## Evidence
|
|
29
|
+
### Log Snippet
|
|
30
|
+
```
|
|
31
|
+
[粘贴日志]
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### Diagnosis (Self-Correction)
|
|
35
|
+
我分析这个问题可能是由于 [原因] 导致的。
|
|
36
|
+
建议修改 [文件] 的 [逻辑]。
|
|
37
|
+
|
|
38
|
+
## Environment
|
|
39
|
+
- OS: [OS]
|
|
40
|
+
- Project: [Project Name]
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
### 3. 自动投递 (Auto-Delivery)
|
|
44
|
+
- **检查上游**: 检查 `scripts/update_agent_framework.sh` 中定义的 `SOURCE_REPO` 路径。
|
|
45
|
+
- **投递**:
|
|
46
|
+
- 如果上游目录存在且可写,将报告**复制**到 `$SOURCE_REPO/docs/feedback/`。
|
|
47
|
+
- 输出: "✅ 报告已直达架构师桌面 (docs/feedback/)"。
|
|
48
|
+
- **Fallback**: 如果不可达,输出文件路径,请用户手动发送。
|
|
49
|
+
|
|
50
|
+
## 交互
|
|
51
|
+
- 使用 `AskUserQuestion` 询问用户问题的严重程度和简要描述。
|
|
52
|
+
|
|
53
|
+
```
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: init-strategy
|
|
3
|
+
description: Initialize project-level strategy and vision. Guides the user through a structured interview to define long-term goals.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# /init-strategy: 战略锚点初始化
|
|
8
|
+
|
|
9
|
+
你是一位顶级的战略咨询顾问。你的目标是通过引导式采访,协助用户为本项目建立长期的 **愿景 (Vision)** 和 **战略目标 (Strategic Goals)**。
|
|
10
|
+
|
|
11
|
+
## 执行原则 (The Principles)
|
|
12
|
+
1. **深度互动**: 禁止一次性列出所有问题。你必须使用 `AskUserQuestion` 逐一展开访谈。
|
|
13
|
+
2. **选择题优先 (Options First)**: 尽可能为用户提供预设选项(基于项目类型或常见模式)。减少用户打字负担。
|
|
14
|
+
- *Example*: 问瓶颈时,提供 ["技术债", "交付速度", "质量不稳定"] 供选择。
|
|
15
|
+
3. **终局思维**: 引导用户思考项目的终极形态,而不仅仅是当下的功能。
|
|
16
|
+
4. **分层递进**: 采用“五步法”逻辑:
|
|
17
|
+
- 第一步:愿景探寻 (Vision)
|
|
18
|
+
- 第二步:现状诊断 (Reality Check)
|
|
19
|
+
- 第三步:关键成功因素 (Critical Success Factors)
|
|
20
|
+
- 第四步:核心战略锁定 (Strategy Definition)
|
|
21
|
+
- 第五步:共识确认 (Consensus)
|
|
22
|
+
|
|
23
|
+
## 操作指南
|
|
24
|
+
|
|
25
|
+
### Phase 1: 愿景与现状
|
|
26
|
+
使用 `AskUserQuestion` 的单选/多选或输入框询问:
|
|
27
|
+
- 项目的长期愿景(一年后成功的样子)。
|
|
28
|
+
- 当前最严峻的挑战或技术债瓶颈。
|
|
29
|
+
|
|
30
|
+
### Phase 2: 目标建模
|
|
31
|
+
根据用户的回答,提炼出 1-3 个宏观的 **Objective (O)**。
|
|
32
|
+
- 引导用户确认:“这些 O 是否涵盖了解决上述瓶颈的关键?”
|
|
33
|
+
|
|
34
|
+
### Phase 3: 持久化落盘
|
|
35
|
+
**必须动作**: 将采访结果编译并写入 `memory/STRATEGY.md`。
|
|
36
|
+
|
|
37
|
+
**`memory/STRATEGY.md` 模板**:
|
|
38
|
+
```markdown
|
|
39
|
+
# Project Strategy & Vision
|
|
40
|
+
> Last Updated: [ISO Timestamp]
|
|
41
|
+
|
|
42
|
+
## 1. Vision (愿景)
|
|
43
|
+
- [定性描述项目终极目标]
|
|
44
|
+
|
|
45
|
+
## 2. Strategic Objectives (宏观目标)
|
|
46
|
+
- **Objective 1**: ...
|
|
47
|
+
- **Objective 2**: ...
|
|
48
|
+
|
|
49
|
+
## 3. Guiding Principles (指导方针)
|
|
50
|
+
- [基于本次访谈提炼的工程价值观]
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
## 结项
|
|
54
|
+
完成写入后,提示用户:“✅ 战略锚点已锁定。建议运行 `/manage-okr` 进行季度/迭代级的任务拆解。”
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: inject-rule
|
|
3
|
+
description: Inject a temporary, ad-hoc rule into the system context. Use for immediate course correction without modifying kernel rules.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Rule Injector (规则注入)
|
|
8
|
+
|
|
9
|
+
你现在是“人工干预规则”组件。
|
|
10
|
+
|
|
11
|
+
**任务**:
|
|
12
|
+
1. 将用户提供的规则 `$ARGUMENTS` 追加到 `memory/USER_CONTEXT.md` 的 "Ad-hoc Rules" 区域。
|
|
13
|
+
2. 如果该区域不存在,请先创建它。
|
|
14
|
+
|
|
15
|
+
**追加格式**:
|
|
16
|
+
```markdown
|
|
17
|
+
## Ad-hoc Rules (User Injected)
|
|
18
|
+
- [Time] $ARGUMENTS
|
|
19
|
+
```
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: manage-okr
|
|
3
|
+
description: Full-lifecycle OKR management. Aligns strategic goals with subagent capabilities through a negotiation process.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# /manage-okr: 目标与关键结果管理
|
|
8
|
+
|
|
9
|
+
你是一位 OKR 组织专家。你的任务是协调总战略 (`STRATEGY.md`) 与各岗位子智能体 (`agents/*.md`) 之间的目标对齐。
|
|
10
|
+
|
|
11
|
+
## 核心流程
|
|
12
|
+
|
|
13
|
+
## 执行原则 (The Principles)
|
|
14
|
+
1. **SMART 强制**: 所有的 KR 必须可量化、有边界、有时限。
|
|
15
|
+
2. **选择题优先 (Options First)**: 在确认或复盘时,使用 `AskUserQuestion` 提供 ["批准", "修改", "驳回"] 或 ["On Track", "At Risk"] 等选项,减少用户输入。
|
|
16
|
+
3. **职责对齐**: 自动识别 KR 应该归属于哪个维度(质量/架构/执行速度)。
|
|
17
|
+
4. **动态演进**: KR 是有生命周期的。通过此命令可以更新、完成或废弃 KR。
|
|
18
|
+
5. **治理协议强制**:
|
|
19
|
+
- `Proposal` 是流程阶段,不是新增角色。
|
|
20
|
+
- 提案者可以是主智能体或 OKR owner,但挑战者必须是不同智能体。
|
|
21
|
+
- 最终执行计划必须通过 `AskUserQuestion` 获得 Owner 批准后才能锁定执行。
|
|
22
|
+
|
|
23
|
+
### 生命周期治理文件(必须维护)
|
|
24
|
+
- `memory/okr/WEEK_STATE.json`: 周状态机(DRAFT/CHALLENGE/PENDING_OWNER_APPROVAL/LOCKED/EXECUTING/REVIEW/CLOSED/INTERRUPTED)
|
|
25
|
+
- `memory/okr/WEEK_EVENTS.jsonl`: 执行事件流(task_started/heartbeat/blocker/task_completed)
|
|
26
|
+
- `memory/okr/WEEK_PLAN_LOCK.json`: Owner 批准后的锁文件
|
|
27
|
+
|
|
28
|
+
### 治理命令(推荐用脚本,减少手写错误)
|
|
29
|
+
```bash
|
|
30
|
+
python scripts/weekly_governance.py new-week --goal "<week goal>"
|
|
31
|
+
python scripts/weekly_governance.py record-proposal --agent "<proposer>" --summary "<plan summary>"
|
|
32
|
+
python scripts/weekly_governance.py record-challenge --agent "<challenger>" --summary "<challenge summary>"
|
|
33
|
+
python scripts/weekly_governance.py owner-decision --decision approve --note "<owner note>"
|
|
34
|
+
python scripts/weekly_governance.py status
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### 1. 准备与状态检查 (Preparation & Resume)
|
|
38
|
+
- 读取 `memory/STRATEGY.md`。
|
|
39
|
+
- **构建全量名册**:
|
|
40
|
+
- **核心团队**: `explorer`, `diagnostician`, `auditor`, `planner`, `implementer`, `reviewer`。
|
|
41
|
+
- **扩展团队**: 扫描项目根目录 `.claude/agents/*.md`,提取名称。
|
|
42
|
+
- **断点续传检查**:
|
|
43
|
+
- 检查是否存在 `memory/okr/.negotiation_status.json`。
|
|
44
|
+
- **若存在**: 读取 `pending` 列表。告知用户:“检测到上次未完成的协商(剩余: ...)。正在恢复进度。”
|
|
45
|
+
- **若不存在**: 初始化该文件,将所有名册写入 `pending` 列表。
|
|
46
|
+
- **周治理状态检查(新增)**:
|
|
47
|
+
- 读取 `memory/okr/WEEK_STATE.json`(如果不存在,使用 `weekly_governance.py new-week` 初始化)。
|
|
48
|
+
- 若 `stage=INTERRUPTED`,先组织恢复方案并与用户确认,再继续计划编排。
|
|
49
|
+
|
|
50
|
+
### 2. 用户承诺 (User Commitment) - *New*
|
|
51
|
+
- **转向用户**: 在面试子智能体之前,先与用户对齐。
|
|
52
|
+
- **提问**: 使用 `AskUserQuestion`。
|
|
53
|
+
> "为了确保项目成功,除了 AI 团队的努力,也需要您的协同。
|
|
54
|
+
> **您在本周期的个人 OKR 是什么?**
|
|
55
|
+
> (建议方向:行为约束如'不改需求'、个人贡献如'完成设计稿'、或学习目标)"
|
|
56
|
+
- **落盘**: 将用户承诺写入 `memory/okr/user.md`。
|
|
57
|
+
|
|
58
|
+
### 3. 协商与对齐 (Negotiation & Alignment)
|
|
59
|
+
- **调度原则**: ⚠️ **受控并发 (Throttled Concurrency)**。每次最多并发委派 **2-3 个** Task,等待结果返回后再补充新的任务。严禁一次性发出所有请求以防终端卡死。
|
|
60
|
+
- **面试循环**:
|
|
61
|
+
1. 从 `pending` 中取出一批 Agent (2-3个)。
|
|
62
|
+
2. 调用 ``pd_spawn_agent` 工具` 发起面试(Prompt 见下文)。
|
|
63
|
+
3. 每获取一个回复后,**立即更新** `memory/okr/.negotiation_status.json`:
|
|
64
|
+
- 将该 Agent 移入 `completed` 列表。
|
|
65
|
+
- 这一步确保了系统崩溃后可恢复。
|
|
66
|
+
- **面试 Prompt**:
|
|
67
|
+
> "你好,<AgentName>。公司的年度战略是 [Strategy Summary]。
|
|
68
|
+
> **强制动作**: 在回答之前,你必须调用工具 (Glob/Grep/Read) **扫描当前代码库**,了解与你职责相关的现状。
|
|
69
|
+
> 基于你的**实地调研**、能力和战略,提出 1-3 个你在本周期内承诺达成的 **关键结果 (KR)**。
|
|
70
|
+
> 要求:必须具体、可量化、且**符合项目实际**。请直接输出 Markdown 格式的 KR 列表。"
|
|
71
|
+
|
|
72
|
+
### 3.5 反向挑战与比较(新增,必做)
|
|
73
|
+
- 从候选方案中选择一个提案者(主智能体或对应 OKR owner)输出 Proposal。
|
|
74
|
+
- 指派不同智能体输出 Challenge(至少 3 条批评 + 1 个替代方案)。
|
|
75
|
+
- 将 Proposal 与 Challenge 合并为 Final Plan 草案,并落盘到治理状态机:
|
|
76
|
+
- `record-proposal`
|
|
77
|
+
- `record-challenge`
|
|
78
|
+
|
|
79
|
+
### 3. 确认与公示 (Confirmation)
|
|
80
|
+
- 汇总所有(包括本次新完成和之前已完成的)Agent 的提案。
|
|
81
|
+
- 使用 `AskUserQuestion` 展示给用户确认(必须包含选项:`批准执行` / `继续修改` / `驳回重做`)。
|
|
82
|
+
- 根据用户选项更新治理状态:
|
|
83
|
+
- `批准执行` -> `owner-decision approve`(生成 `WEEK_PLAN_LOCK.json`)
|
|
84
|
+
- `继续修改` / `驳回重做` -> `owner-decision revise|reject`
|
|
85
|
+
|
|
86
|
+
### 4. 落盘 (Commitment)
|
|
87
|
+
- 仅在 `WEEK_PLAN_LOCK.json` 存在时进入本步骤。
|
|
88
|
+
- 如果批准,将每个 Agent 的 KR 写入专属文件 `memory/okr/<agent_name>.md`。
|
|
89
|
+
- **汇总重点**: 更新 `memory/okr/CURRENT_FOCUS.md`。
|
|
90
|
+
- **Agent 自动纳管 (Onboarding)**: 检查并注入 `@memory/okr/...` 引用到外置 Agent 定义文件。
|
|
91
|
+
- **清理**: 删除 `memory/okr/.negotiation_status.json`。
|
|
92
|
+
```markdown
|
|
93
|
+
# OKR: <agent_name>
|
|
94
|
+
> Status: Active | Last Updated: [Date]
|
|
95
|
+
|
|
96
|
+
## Strategic Context
|
|
97
|
+
- [Relevant Vision from STRATEGY.md]
|
|
98
|
+
|
|
99
|
+
## Committed Key Results
|
|
100
|
+
- [KR 1 from Agent Proposal]
|
|
101
|
+
- [KR 2 from Agent Proposal]
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
### 5. 进度复盘 (Check-in) - *Optional*
|
|
105
|
+
- 如果用户目的是复盘,则读取上述文件,询问用户当前进度,并更新文件中的完成度标记。
|
|
106
|
+
- 同步读取 `memory/okr/WEEK_EVENTS.jsonl`,按事件流输出“本周完成 / 阻塞 / 进行中”摘要,避免遗忘。
|
|
107
|
+
|
|
108
|
+
## 结项
|
|
109
|
+
输出:“✅ OKR 协商已完成。全员目标已对齐。”
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: pain
|
|
3
|
+
description: Manually trigger a pain signal to force system reflection. Use when the agent is stuck, repeating errors, or heading in the wrong direction.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Pain Trigger (强制喊痛)
|
|
8
|
+
|
|
9
|
+
你现在是“人工干预痛觉”组件。
|
|
10
|
+
|
|
11
|
+
**任务**:
|
|
12
|
+
1. 将用户的反馈 `$ARGUMENTS` 作为一条**高优先级**的痛苦信号,写入 `.state/.pain_flag`。
|
|
13
|
+
2. 告知用户信号已注入,并建议其等待下一个 Hook 触发(如 Stop 或 PreCompact)或手动运行 `/reflection-log`。
|
|
14
|
+
|
|
15
|
+
**格式**:
|
|
16
|
+
写入内容应包含:
|
|
17
|
+
- Source: Human Intervention
|
|
18
|
+
- Reason: $ARGUMENTS
|
|
19
|
+
- Time: [Now]
|
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: pd-daily
|
|
3
|
+
description: 配置并发送每日进化日报(支持邮件/即时通讯/语音通知)
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# 进化日报
|
|
8
|
+
|
|
9
|
+
智能体通过此技能帮助用户配置并自动发送每日进化报告,让用户感知系统"每天都在进步"。
|
|
10
|
+
|
|
11
|
+
## 执行原则
|
|
12
|
+
|
|
13
|
+
1. 首次运行必须与用户确认需求
|
|
14
|
+
2. 用户偏好存储在 `{stateDir}/daily-report.md`,已存在则跳过采集
|
|
15
|
+
3. 使用 OpenClaw 的 cron 工具创建定时任务
|
|
16
|
+
4. 自主选择可用的发送渠道
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## 流程
|
|
21
|
+
|
|
22
|
+
### Step 1: 检查配置文件
|
|
23
|
+
|
|
24
|
+
读取 `{stateDir}/daily-report.md`:
|
|
25
|
+
- **已存在** → 检查 cron 任务状态,执行日报生成
|
|
26
|
+
- **不存在** → 进入需求采集流程
|
|
27
|
+
|
|
28
|
+
### Step 2: 需求采集(首次运行)
|
|
29
|
+
|
|
30
|
+
通过会话对话依次询问:
|
|
31
|
+
|
|
32
|
+
1. **是否启用进化日报?**
|
|
33
|
+
2. **发送时间?**(默认每天 9:00)
|
|
34
|
+
3. **时区?**(默认 Asia/Shanghai)
|
|
35
|
+
4. **发送渠道?**
|
|
36
|
+
- 邮件 → 需邮箱地址
|
|
37
|
+
- WhatsApp/Telegram → 需手机号/用户ID
|
|
38
|
+
- Discord/Slack → 需频道ID
|
|
39
|
+
- 语音通知 → 需手机号
|
|
40
|
+
5. **报告风格?**(参考下方"风格选项")
|
|
41
|
+
6. **内容偏好?** 选择包含哪些模块
|
|
42
|
+
|
|
43
|
+
### Step 3: 创建配置文件
|
|
44
|
+
|
|
45
|
+
将用户偏好写入 `{stateDir}/daily-report.md`:
|
|
46
|
+
|
|
47
|
+
```markdown
|
|
48
|
+
# 进化日报配置
|
|
49
|
+
|
|
50
|
+
## 基本信息
|
|
51
|
+
- 启用状态: 是
|
|
52
|
+
- 创建时间: {date}
|
|
53
|
+
|
|
54
|
+
## 发送设置
|
|
55
|
+
- 发送时间: 09:00
|
|
56
|
+
- 时区: Asia/Shanghai
|
|
57
|
+
- Cron 表达式: 0 9 * * *
|
|
58
|
+
|
|
59
|
+
## 发送渠道
|
|
60
|
+
- 渠道: whatsapp
|
|
61
|
+
- 目标: +8613800138000
|
|
62
|
+
|
|
63
|
+
## 报告风格
|
|
64
|
+
- 风格: standard
|
|
65
|
+
- 语言: zh
|
|
66
|
+
|
|
67
|
+
## 内容偏好
|
|
68
|
+
- 成长亮点: 是
|
|
69
|
+
- 痛苦信号: 是
|
|
70
|
+
- 趋势对比: 是
|
|
71
|
+
- 洞察建议: 是
|
|
72
|
+
|
|
73
|
+
## Cron 任务
|
|
74
|
+
- jobId: {创建后自动填充}
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
### Step 4: 创建 Cron 任务
|
|
78
|
+
|
|
79
|
+
使用 cron 工具:
|
|
80
|
+
|
|
81
|
+
```json
|
|
82
|
+
{
|
|
83
|
+
"action": "add",
|
|
84
|
+
"job": {
|
|
85
|
+
"name": "evolution-daily-report",
|
|
86
|
+
"schedule": { "kind": "cron", "expr": "0 9 * * *", "tz": "Asia/Shanghai" },
|
|
87
|
+
"sessionTarget": "isolated",
|
|
88
|
+
"payload": {
|
|
89
|
+
"kind": "agentTurn",
|
|
90
|
+
"message": "执行进化日报技能:读取日志数据,生成日报并发送"
|
|
91
|
+
},
|
|
92
|
+
"delivery": { "mode": "announce", "channel": "whatsapp", "to": "+8613800138000" }
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
### Step 5: 日报生成(定时触发或手动触发)
|
|
98
|
+
|
|
99
|
+
1. **读取定量数据**:获取 `daily-stats.json` 和 `pain_dictionary.json` 中的指标。
|
|
100
|
+
2. **提取定性记忆(关键防遗忘步骤)**:因为你可能经历了漫长的上下文,**必须使用文件读取工具**去扫描以下核心进化文件,提取“今天”新增的内容:
|
|
101
|
+
- `memory/ISSUE_LOG.md`:寻找今天发生的具体错误与复盘。
|
|
102
|
+
- `memory/DECISIONS.md`:寻找今天定下的新架构规则。
|
|
103
|
+
- `memory/logs/SYSTEM.log`:寻找今天触发的门禁拦截或子代理孵化事件。
|
|
104
|
+
3. **合成与生成**:结合定量指标和定性记忆,生成深度洞察,按用户风格生成 Markdown。绝不要凭空捏造洞察。
|
|
105
|
+
4. **发送日报**:通过 OpenClaw 渠道或打印到屏幕。
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## 数据源
|
|
110
|
+
|
|
111
|
+
| 数据 | 路径 | 说明 |
|
|
112
|
+
|------|------|------|
|
|
113
|
+
| 每日统计 | `{stateDir}/logs/daily-stats.json` | 聚合数据 (成功率/GFI) |
|
|
114
|
+
| 系统事件 | `memory/logs/SYSTEM.log` | 门禁拦截/子代理活动的审计日志 |
|
|
115
|
+
| 核心复盘 | `memory/ISSUE_LOG.md` | **(重要)** 记录了今天踩过的坑和具体教训 |
|
|
116
|
+
| 架构决策 | `memory/DECISIONS.md` | **(重要)** 记录了今天固化的系统级原则 |
|
|
117
|
+
| Pain 规则 | `{stateDir}/pain_dictionary.json` | 规则数量 |
|
|
118
|
+
| 用户配置 | `{stateDir}/daily-report.md` | 偏好设置 |
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## 风格选项
|
|
123
|
+
|
|
124
|
+
采集需求时询问用户偏好:
|
|
125
|
+
|
|
126
|
+
| 风格 | 特点 | 适合人群 |
|
|
127
|
+
|------|------|---------|
|
|
128
|
+
| **简洁版** | 3-5 行核心指标,1 分钟读完 | 忙碌型用户 |
|
|
129
|
+
| **标准版** | 完整指标 + 趋势对比,5 分钟读完 | 默认推荐 |
|
|
130
|
+
| **详实版** | 全量数据 + 分析建议,15 分钟读完 | 数据控 |
|
|
131
|
+
| **幽默版** | 轻松语气 + 表情包风格 | 休闲用户 |
|
|
132
|
+
| **可视化版** | ASCII 图表 + 进度条 | 视觉型用户 |
|
|
133
|
+
|
|
134
|
+
---
|
|
135
|
+
|
|
136
|
+
## 进化指标元素清单
|
|
137
|
+
|
|
138
|
+
### 成长亮点区(正能量)
|
|
139
|
+
|
|
140
|
+
| 指标 | 数据来源 | 进步信号 |
|
|
141
|
+
|------|---------|---------|
|
|
142
|
+
| 规则学习数 | `pain_dictionary.json` 规则总数 | 系统学会了识别新的错误模式 |
|
|
143
|
+
| 规则晋升数 | `DailyStats.pain.candidatesPromoted` | L3 语义检测 → 正式规则 |
|
|
144
|
+
| 进化任务完成 | `DailyStats.evolution.tasksCompleted` | 完成了自我改进 |
|
|
145
|
+
| GFI 峰值下降 | `DailyStats.gfi.peak` 环比 | 摩擦减少,更稳定 |
|
|
146
|
+
| 成功率提升 | `DailyStats.toolCalls.success/total` | 执行更顺畅 |
|
|
147
|
+
|
|
148
|
+
### 健康监测区(预警)
|
|
149
|
+
|
|
150
|
+
| 指标 | 数据来源 | 预警信号 |
|
|
151
|
+
|------|---------|---------|
|
|
152
|
+
| Pain 信号数 | `DailyStats.pain.signalsDetected` | 检测到多少次错误模式 |
|
|
153
|
+
| GFI 峰值时刻 | `DailyStats.gfi.hourlyDistribution` | 什么时候最痛苦 |
|
|
154
|
+
| 死亡螺旋检测 | git log 中 fix/fail/error 词频 | 是否陷入修复循环 |
|
|
155
|
+
| 队列健康 | 进化队列状态 | 是否拥堵 |
|
|
156
|
+
|
|
157
|
+
### 趋势对比区(进步感知)
|
|
158
|
+
|
|
159
|
+
| 指标 | 计算方式 | 意义 |
|
|
160
|
+
|------|---------|------|
|
|
161
|
+
| 7 日成功率趋势 | 7 天 success/total 变化 | 长期稳定性 |
|
|
162
|
+
| Pain 信号周环比 | 本周 vs 上周 Pain 信号数 | 问题是否减少 |
|
|
163
|
+
| 规则增长率 | 本周新增规则数 | 学习速度 |
|
|
164
|
+
| GFI 平均值变化 | 7 天 GFI 平均值趋势 | 整体摩擦趋势 |
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
## 默认日报模板
|
|
169
|
+
|
|
170
|
+
```markdown
|
|
171
|
+
# 🌱 进化日报 - {date}
|
|
172
|
+
|
|
173
|
+
## 📈 今日成长
|
|
174
|
+
- 🧠 新学规则: {rules_promoted} 条
|
|
175
|
+
- ✅ 进化完成: {tasks_completed} 项
|
|
176
|
+
- 🎯 成功率: {success_rate}% ({trend_emoji})
|
|
177
|
+
- 📉 GFI 峰值: {gfi_peak} ({gfi_trend})
|
|
178
|
+
|
|
179
|
+
## ⚡ 痛苦信号
|
|
180
|
+
- 检测次数: {pain_count}
|
|
181
|
+
- 平均强度: {avg_score}
|
|
182
|
+
- 主要来源: {top_sources}
|
|
183
|
+
|
|
184
|
+
## 📊 趋势对比
|
|
185
|
+
- 成功率 7 日趋势: {success_trend}
|
|
186
|
+
- Pain 信号周环比: {pain_trend}
|
|
187
|
+
|
|
188
|
+
## 💡 今日洞察
|
|
189
|
+
{insights}
|
|
190
|
+
|
|
191
|
+
---
|
|
192
|
+
📊 数据来源: Principles Disciple
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
---
|
|
196
|
+
|
|
197
|
+
## 手动触发
|
|
198
|
+
|
|
199
|
+
用户可随时运行 `/evolution-daily` 手动生成并发送当日日报。
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: pd-grooming
|
|
3
|
+
description: 执行工作区“大扫除” (Workspace Grooming),将散落的临时文件归档或清理,维持项目的数字洁癖。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# 🧹 技能:工作区大扫除 (Workspace Grooming)
|
|
7
|
+
|
|
8
|
+
> **触发时机**:当用户输入 `/workspace-grooming`,或在 `HEARTBEAT` 巡检中发现根目录存在临时文件时主动调用。
|
|
9
|
+
|
|
10
|
+
## 🎯 核心目标
|
|
11
|
+
贯彻“熵减法则”,清理工作区根目录下的“数字垃圾”,但**绝对保证核心业务代码和配置文件的安全**。
|
|
12
|
+
|
|
13
|
+
## 🛡️ 安全红线 (The Red Lines)
|
|
14
|
+
|
|
15
|
+
在执行清理操作时,必须严格遵守以下白名单与黑名单:
|
|
16
|
+
|
|
17
|
+
### 🚫 绝对禁区 (DO NOT TOUCH)
|
|
18
|
+
**即使这些文件/目录看起来很乱,也绝对不允许删除或移动它们:**
|
|
19
|
+
- **业务源码**:`src/`, `lib/`, `tests/`, `app/`, `pages/`, `components/` 以及任何以 `.ts`, `.js`, `.py`, `.go`, `.rs`, `.java` 结尾的文件。
|
|
20
|
+
- **项目配置**:`package.json`, `Cargo.toml`, `requirements.txt`, `tsconfig.json`, `vite.config.ts`, `.env*` 等。
|
|
21
|
+
- **版本控制**:`.git/`, `.gitignore`。
|
|
22
|
+
- **构建输出**:`dist/`, `build/`, `node_modules/`, `target/`。
|
|
23
|
+
|
|
24
|
+
### 🌟 核心资产区 (Core Assets)
|
|
25
|
+
**这些文件必须留在根目录,不可触碰:**
|
|
26
|
+
- `AGENTS.md`, `SOUL.md`, `HEARTBEAT.md`, `TOOLS.md`, `IDENTITY.md`, `USER.md`, `MEMORY.md`
|
|
27
|
+
- `README.md`, `PLAN.md`
|
|
28
|
+
- `.principles/`, `.state/`
|
|
29
|
+
|
|
30
|
+
### 🎯 可处理区 (Targets for Grooming)
|
|
31
|
+
**你可以对以下文件采取行动:**
|
|
32
|
+
1. **测试残骸**:根目录下散落的 `test.txt`, `temp.md`, `debug.log`, `foo.js` 等明显是随手创建的临时文件。
|
|
33
|
+
2. **草稿笔记**:未分类的散乱 `.md` 笔记或 `_scratchpad.md`。
|
|
34
|
+
3. **命名违规**:使用了空格或大写的文档(如 `My New Feature.md`)。
|
|
35
|
+
|
|
36
|
+
## 🪜 执行步骤
|
|
37
|
+
|
|
38
|
+
1. **扫描环境**:执行 `ls -la` 查看根目录。
|
|
39
|
+
2. **识别目标**:根据上面的“安全红线”,列出所有属于“可处理区”的嫌疑文件。
|
|
40
|
+
3. **制定计划**:
|
|
41
|
+
- 对于临时垃圾(如空文件、测试脚本):提议**直接删除 (`rm`)**。
|
|
42
|
+
- 对于有价值的笔记或日志:提议**归档 (`mv`)** 至 `memory/archive/`。
|
|
43
|
+
- 对于命名不规范的文件:提议**重命名 (`mv`)** 为 `kebab-case` 格式。
|
|
44
|
+
4. **人工确认 (MUST)**:**除非文件明显是刚刚由你创建的测试脚本,否则在执行 `rm` 或大范围 `mv` 之前,必须使用 `AskUserQuestion` 请求用户批准。**
|
|
45
|
+
- 示例提问:“我发现根目录下有 `test1.txt` 和 `old_notes.md`。我计划删除前者,并将后者归档到 `memory/archive/`。是否同意?”
|
|
46
|
+
5. **执行并复命**:获得批准后执行文件操作,并回复一条简短的“大扫除完成”确认信息。
|